adr-reviewlisted

Multi-agent debate orchestration for Architecture Decision Records. Automatically triggers on ADR create/edit/delete. Coordinates architect, critic, independent-thinker, security, analyst, and high-level-advisor agents in structured debate rounds until consensus. Use when you say "review this ADR", when an ADR is created/edited/deleted, or when reviewing, accepting, or updating a decision file under .agents/architecture/, docs/architecture/, docs/decisions/, docs/adr/, or architecture/decisions/, including intent like "review this decision record" or "check this rationale for future maintainers". Do NOT use to author a new ADR (use adr-generator).
rjmurillo/ai-agents · ★ 45 · AI & Automation · score 80

Install: claude install-skill rjmurillo/ai-agents

# 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 | | `review this decision record` | ADR review for durable architecture/design decision records | | `delete ADR-NNN` | Deletion review with dependency and supersession checks | | `ADR file created, modified, or deleted` | Auto-triggered via detect_adr_changes.py | --- ## Quick Start ```text # Manual triggers: /adr-review .agents/architecture/ADR-005-api-versioning.md "review this ADR" "validate ADR-005" "review this decision record under docs/decisions" ``` **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/adr/` | create, update, delete | | `ADR-*.md` | `docs/architecture/` | create, update, delete | | `ADR-*.md` | `docs/decisions/` | create, u