adr-review

Solid

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).

AI & Automation 38 stars 13 forks Updated today MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%

Recency 20%

100

Frontmatter 20%

Documentation 15%

100

Issue Health 10%

License 10%

100

Description 5%

100

Skill Content

# 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...

Details

Author: rjmurillo
Repository: rjmurillo/ai-agents
Created: 7 months ago
Last Updated: today
Language: Markdown
License: MIT

Integrates with

Anthropic · AI

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

adr-generator

Create comprehensive Architectural Decision Records (ADRs). Researches the destination directory to detect existing template conventions, gathers context, determines next ADR number, generates the ADR, validates completeness, and saves. Supports multiple ADR formats (MADR, Nygard, Alexandrian, project canonical). Use when documenting technical decisions, creating new ADR files, or capturing rationale so future readers can revisit a choice. Use when you say "write an ADR", "document this decision", "document these design choices", "record why we chose this", "capture the rationale", or "for future maintainers", or when creating an ADR-like markdown file under docs/decisions/, docs/adr/, docs/architecture/, architecture/decisions/, or .agents/architecture/. Do NOT use to debate or review an existing ADR (use adr-review).

38 Updated today

rjmurillo

AI & Automation Listed

adr-enforcer

Ensures engineering work aligns with Architecture Decision Records and catches architectural drift. Use when planning, implementing, reviewing, or when no ADRs exist and bootstrap is needed. Emits ADR_COMPLIANCE. Never silently invents architecture or auto-modifies ADRs.

0 Updated 1 weeks ago

willianbs

AI & Automation Solid

adr-author

Authors Architecture Decision Records (ADRs) that capture context, considered options with trade-offs, the chosen decision, and its consequences. Use this skill when the user wants to write, draft, document, or revise an architecture decision, an ADR, a design decision record, a technical decision log, or asks "why did we choose X" / "we need to record this decision" / "document this trade-off" for things like database choice, framework selection, API style, build vs. buy, or deprecating a component.

3 Updated today

JayRHa