adr-review

# ADR Review Multi-agent debate pattern for rigorous ADR validation. Orchestrates 6 specialized agents through structured review rounds until consensus or 10 rounds maximum. ## Triggers | Trigger Phrase | Operation | |----------------|-----------| | `review this ADR` | Full 6-agent debate on specified ADR | | `validate ADR-005` | Targeted review of specific ADR by number | | `check architecture decision` | ADR review with debate protocol | | `ADR file created or modified` | Auto-triggered via detect_adr_changes.py | | `delete ADR-NNN` | Deletion workflow (D1-D4) | --- ## Quick Start ```text # Manual triggers: /adr-review .agents/architecture/ADR-005-api-versioning.md "review this ADR" "validate ADR-005" ``` **Automatic Detection**: A Claude Code hook runs at session start and detects ADR changes, prompting you to invoke this skill. The pre-commit hook also detects staged ADR files and displays a reminder. | Input | Output | Consensus Required | |-------|--------|-------------------| | ADR file path | Debate log + Updated ADR | 6/6 Accept or D&C | ## File Triggers | Pattern | Location | Events | |---------|----------|--------| | `ADR-*.md` | `.agents/architecture/` | create, update, delete | | `ADR-*.md` | `docs/architecture/` | create, update, delete | | `SESSION-PROTOCOL.md` | `.agents/` | create, update, delete | **Detection**: `.claude/skills/adr-review/scripts/detect_adr_changes.py` ## When to Use **MANDATORY Triggers** (automatic): - Architect creates or up...