What problem does it solve?
Bead decomposition is error-prone and hard to validate. This workflow orchestrates a formal QA audit that uses multiple sub-agents to verify coverage, atomicity, dependencies, context, and metadata of bead definitions against a Technical Design Document (TDD).
Core Features & Use Cases
- Parallel sub-agents (Coverage Checker, Atomicity Checker, Dependency Validator, Context Auditor, Metadata Checker) validate mappings, sizing, graph integrity, contracts, and testability.
- Central synthesizer aggregates findings into a coherent verdict and maintains a ledger for traceability.
- Iteration guardrails ensure stability before approval and guide remediation when issues are found.
- Use Case: before implementing bead-based workflows, run bead-review to confirm all TDD requirements are covered by beads and that each bead has a single responsibility and clear dependencies.
Quick Start
Run bead-review to validate bead decompositions against the TDD and generate a consolidated verdict.