Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 13 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -132,11 +132,12 @@ During the **implement** phase, work is divided across these specialized agents:
Reviewers run as part of multi-agent wave execution in refine, plan, and implement phases:

**Refine Phase:**
- **Unified Reviewer**: Analysis quality and completeness
- **Refine Reviewer**: Analysis quality and completeness
- **Agent Design Reviewer**: Agent-mode alignment and anti-patterns

**Plan Phase:**
- **Unified Reviewer**: Plan quality, task structure, acceptance criteria
- **Plan Reviewer**: Plan-specific quality (task breakdown, dependencies, test strategy)
- **Agent Design Reviewer**: Agent-mode alignment and anti-patterns

**Implement Phase:**
Expand All @@ -145,7 +146,17 @@ Reviewers run as part of multi-agent wave execution in refine, plan, and impleme
- **Contract Reviewer**: Verify acceptance criteria met, task completion status
- **Agent Design Reviewer**: Check for agent-mode anti-patterns, autonomous operation capability

**Execution model**: Reviewers run in parallel as the final wave of each phase's dependency graph. In implement phase, reviewers depend on the integrator. In plan phase, reviewers depend on the task planner and risk analyst. In refine phase (single-worker), reviewers run after the coder completes.
**Execution model**: Reviewers run in parallel as the final wave of each phase's dependency graph. In implement phase, reviewers depend on the integrator. In plan phase, reviewers depend on the task planner and risk analyst. In refine phase, reviewers run after the refiner completes.

### Refine Phase Roles

During the **refine** phase, a specialized agent produces the analysis:

| Role | Responsibility |
|------|----------------|
| **Refiner** | Analyze task, research codebase, evaluate options, recommend approach |

**Execution model**: Refiner runs first, then reviewers validate the analysis before human approval.

### Plan Phase Roles

Expand Down
2 changes: 1 addition & 1 deletion docs/development/STRUCTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -159,7 +159,7 @@ shared/
│ ├── models.py # Pydantic models including CheckDefinition, CheckResult, PhaseConfig, AgentExecutionModel
│ ├── phase_defaults.py # Default check configurations per SDLC phase
│ ├── deployment.py # Deployment validation configuration models (.egg/deployment.yml)
│ ├── agent_roles.py # Multi-agent role definitions (Coder, Tester, Documenter, Integrator)
│ ├── agent_roles.py # Multi-agent role definitions (all agent and reviewer roles)
│ ├── orchestrator.py # Multi-agent orchestration dispatch logic
│ ├── orchestration.py # Agent execution state management
│ ├── dependency_graph.py # Agent dependency resolution for parallel execution
Expand Down
8 changes: 5 additions & 3 deletions docs/guides/sdlc-pipeline.md
Original file line number Diff line number Diff line change
Expand Up @@ -225,15 +225,17 @@ The orchestrator runs multiple specialized reviewers in parallel, with phase-spe

| Phase | Reviewers | Focus |
|-------|-----------|-------|
| **Refine** | Unified, Agent-Design | Analysis quality, agent-mode alignment |
| **Plan** | Unified, Agent-Design | Plan quality, agent-mode alignment |
| **Refine** | Refine, Agent-Design | Analysis quality, agent-mode alignment |
| **Plan** | Unified, Plan, Agent-Design | Plan quality, plan-specific criteria, agent-mode alignment |
| **Implement** | Unified, Agent-Design, Contract, Code | Full coverage: quality, design, contract, security |

**Specialized Reviewers:**

| Reviewer | Focus |
|----------|-------|
| **Unified** | Phase-specific quality criteria |
| **Unified** | Phase-specific quality criteria (general) |
| **Refine** | Analysis quality, research depth, options evaluation |
| **Plan** | Task breakdown, dependencies, test strategy |
| **Agent-Design** | Agent-mode design alignment (anti-patterns) |
| **Contract** | Task completion, acceptance criteria |
| **Code** | Security, correctness, robustness |
Expand Down