← Back to Devchain

teams-dev Template

Multi-Agent Workflow for teams-dev

🚀
Quick Start Guide
1
Discuss & Create Master Plan
User Brainstormer

Start a conversation with the Brainstormer agent. Describe your requirements, features, or changes. The Brainstormer creates a Master Plan with phases, epics, and sub-epics.
2
Technical Validation
Brainstormer Architect

The Brainstormer sends the draft plan to the Architect for technical validation against the codebase. This loop continues (up to 10 rounds) until the plan is solid. Add more Architects to the Planning team and they research several angles in parallel.
3
Review & Approve Master Plan
User

Review the final Master Plan. Check phases, epics, acceptance criteria, and scope. Approve to proceed or request changes.
4
Epic Decomposition
Brainstormer

After approval, the Brainstormer creates the epic hierarchy:
  • Phase Epics (Draft) — high-level deliverables
  • Sub-Epics (New) — individual tasks with acceptance criteria
  • Backlog Epic (Backlog) — out-of-scope items
5
Prepare Epics for Execution
User

On the Board, move all Phase Epics you want to complete together to "New" status. Leave epics in "Draft" for future sprints.
6
Trigger Execution
User Epic Manager

Assign the first Phase Epic to the Epic Manager. This triggers the automated execution loop.
7
Automated Execution Loop
System Epic Manager Coder

The system runs autonomously:
  • The Builders team auto-scales Coders; each picks tasks, implements, tests, and submits for review
  • Epic Manager reviews → Approve (Done) / Revise (back to Coder)
  • Repeat until all sub-epics in the Phase are Done
8
Code Review
Epic Manager Code Reviewer

When all epics complete, the Code Reviewer analyzes git diffs, checks architectural standards, and generates findings.
9
Remediation & Iteration
Code Reviewer Brainstormer

The Code Reviewer sends findings to Brainstormer, who creates remediation epics. The cycle repeats as needed.
1
Planning
USER
Requirements Provider
↓
requirements
Brainstormer
Planning Team Lead
draft plan
→
Architect
Technical Validator
←
technical feedback
↻ Technical Validation Loop (up to 10 rounds)
↓
final plan
USER
Approve / Reject
↓
approved

Created Epic Hierarchy

Phase Epic Draft
Sub-Epic 1 (Task:1) New
Sub-Epic 2 (Task:2) New
Sub-Epic 3 (Task:3) New
BACKLOG Epic Backlog
2
Execution Loop

⚡ User Trigger (Manual Step)

  1. Move all epics to be completed together → "New" status
  2. Assign the first Phase Epic → Epic Manager
↓
triggers automation
Epic Manager
Builders Lead / Reviewer
assigns task
→
Coder
Task Executor (Builders team)
Coder Actions:
  1. Pick task (lowest # tag)
  2. Set "In Progress"
  3. Read requirements
  4. Implement & test
  5. Document work
  6. Set "Review"
↓
submits for review
Review Decision
APPROVE
→ Done
→ Assign next task
REVISE
→ Back to Coder
with feedback
BLOCKED
→ Blocked status
BACKLOG
New items
discovered
↻ Repeat until all sub-epics in phase are Done
↓
Phase Complete
Phase Epic → "Review" · Pick next Phase from "New" pool
3
Code Review (After All "New" Epics Complete)
Epic Manager
Requests review
all phases done
→
Code Reviewer
Autonomous Reviewer
Code Reviewer Actions:
  1. Find all epics in "Review"
  2. Analyze git diffs
  3. Check architectural standards
  4. Generate findings report
↓
sends findings
Brainstormer
Creates remediation epics
ℹ
Agent Summary
Agent Role Inputs Outputs
Brainstormer Planning Team Lead User requirements, Review findings Phase Epics, Sub-Epics, Backlog
Architect Technical Validator Draft plans Technical validation feedback
Epic Manager Builders Lead / Reviewer Sub-epics in Review Approve/Revise decisions, Assignments
Coder Task Executor (Builders team) Assigned sub-epics Implemented code + documentation
Code Reviewer Autonomous Reviewer Completed phases Architectural findings → new epics
User
Brainstormer
Architect
Epic Manager
Coder
Code Reviewer