bead-review

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.