Develop a feature: branch, agents and instructions
Push code to a branch named with the card key, give tasks to a coding agent, and leave notes for whoever builds.
In short
In Develop, code goes to a branch named with the card key. {{brand}} reads the branch, links it to the card and compares it with the design. A task is built by an AI agent or by a person in their own editor. Notes on the Instructions tab reach the agent with its work.
Before you start
- Connect the board to your repository so branches and pull requests reach the card. See /help/boards/board-webhooks-and-repositories.
- To give a task to a coding agent, read /help/boards/coding-agent-on-a-card.
Use the right branch
- Open the Feature card and its "Code & checks" tab.
- Copy the "Start the branch" command. It looks like git checkout -b feature/KEY-12-pay-by-card.
- Run it in your repository, write the code and push the branch. Then look at the "Code & checks" tab again.
Result: "Synced: the code was read and compared with the design" appears. "Compared with the design" lists what "Matches", what is "Missing" and what is "Different".
Give a task to the AI agent
- Open the task card the plan made. The plan on "Design & plan" links to each one.
- Open the … menu in its header and choose "Give to a coding agent".
- Type "Your password" and press "Give to agent". The coding agent guide has the rest.
Result: the agent gets the task, the design and your notes through a credential for that card only. A person still merges.
Leave instructions
- Press "More" on the card's tabs and choose "Instructions".
- Under "For the stage", choose Design, Plan, Develop or Test.
- Write one instruction in "Note" and press "Add the note".
Result: the agent reads the note on its next read. The design change brief carries it too.
Good to know
- When a pull request is open with the code, {{brand}} moves the card to Test by itself if "Branch synced, to Test" is Automatic. With Ask me, {{brand}} asks first.
- Add notes any time. A note is one instruction in plain words.
- An AI agent may report the tokens it spent. They are recorded as reported by the agent and never charged.
- What happens next: open a pull request. See /help/boards/test-and-ready.
If something goes wrong
- "No code yet." - the branch is not pushed, or its name does not hold the card key.
- "Not synced yet: {{brand}} reads the branch when it is pushed" - push the branch, then wait a moment.
- "Open a pull request" - the code is on the branch but no pull request exists yet.
Related
- /help/boards/test-and-ready
- /help/boards/coding-agent-on-a-card
- /help/boards/board-webhooks-and-repositories
- /help/designer/build-a-feature-with-coding-agents