Simple task workflow
This workflow follows the current human-in-the-loop path from idea to merged PR.
1. Capture the idea
Create a card in Analyst with a strong description: problem, users, constraints, and links.
2. Analyst -> requirements
Wait for the PRD or answer the form if the agent asks for clarification. When the card reaches wait_for_review, check that the brief is correct.
3. Send to Architect
Use Send to Architect from the Analyst card when you want the product to create the next handoff automatically.
4. Architect -> design and breakdown
Review the ADR, stack, and suggested tasks. In the current product, suggested tasks are not individually approved into a generic backlog flow. Instead, you review them, dismiss anything out of scope, and then start implementation from the Architect result.
5. Start implementation
Use Implement all. For a small feature, this often creates a single child coder task; for a larger feature, it creates a small ordered set of child tasks.
6. Coder -> implementation and PR
Coder runs in the project sandbox, pushes commits, and writes a PR artifact to the card. Review the detail panel for progress and open the PR in GitHub when it is ready.
7. Human review and merge
Humans review the PR in GitHub, request changes if needed, then merge. The backend poller updates the card automatically when the PR is merged or closed.
Checklist
- GitHub integration configured
- AI mode configured for the project
- Analyst and Architect outputs reviewed before starting the next stage
- PR reviewed and merged in GitHub