Skip to content

Quick Reference

Stop Conditions

Know when to move on. Each phase has a convergence signal.

Phase Move on when...
Phase 0 All prerequisites are in place
Phase 1 You have a comprehensive first draft
Phase 2 Only minor wording tweaks remain; no architectural/test/ops improvements
Phase 3 All plan sections are represented as beads with dependencies
Phase 4 Beads changes are mostly reordering/renaming, not missing work
Phase 5 All beads are implemented and marked complete
Phase 6 Review passes produce no substantive diffs

Plan QA Checklist

Run this as a self-audit at the end of Phase 2, before converting to beads.

  • Goals: measurable, user-facing outcomes exist
  • Non-goals: explicit, to prevent scope creep
  • Threat model: realistic attacker model + mitigations
  • Secrets: where they live, how they're injected, what never enters logs
  • Failure modes: retries/timeouts/backoff; idempotency rules
  • Performance: explicit SLOs; measurement plan
  • Observability: structured logs, metrics, traces; alert thresholds
  • Testing: unit + integration + e2e; fixtures/logging; "how we debug failures"
  • Rollout: feature flags, migrations, rollback steps

Workflow Diagram

graph TD
    P0["Phase 0<br/>Prerequisites"] --> P1["Phase 1<br/>Draft Plan"]
    P1 --> P2["Phase 2<br/>Refine Plan"]
    P2 -->|"4-5 rounds"| P2
    P2 --> P3["Phase 3<br/>Plan → Beads"]
    P3 --> P4["Phase 4<br/>QA Beads"]
    P4 -->|"until stable"| P4
    P4 --> P5["Phase 5<br/>Agent Swarm"]
    P5 --> P6["Phase 6<br/>Fresh-Eyes Review"]
    P6 -->|"until clean"| P6

    style P0 fill:#1a1a2e,stroke:#16213e,color:#e5e5e5
    style P1 fill:#16213e,stroke:#0f3460,color:#e5e5e5
    style P2 fill:#0f3460,stroke:#533483,color:#e5e5e5
    style P3 fill:#533483,stroke:#e94560,color:#e5e5e5
    style P4 fill:#e94560,stroke:#533483,color:#e5e5e5
    style P5 fill:#0f3460,stroke:#16213e,color:#e5e5e5
    style P6 fill:#16213e,stroke:#1a1a2e,color:#e5e5e5

Key Tools in the Flywheel

Tool Purpose
Beads (bd/br) Task management with dependency tracking
Beads Viewer (bv) Task prioritization and triage (--robot-next, --robot-triage)
Agent Mail Inter-agent messaging and coordination
NTM Named Tmux Manager for multi-agent orchestration
CASS Coding Agent Session Search across 11+ agent formats
UBS Error detection beyond standard linting

Sources