adr-review

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

Ir para a instalação

Repositório: rjmurillo/ai-agents
Última atividade na origem: 2 de agosto de 2026 às 21:46
Idioma detectado do SKILL.md: inglês
Estrelas: 41
Forks: 13

Opções de instalação

Por padrão, está selecionado o prompt que primeiro revisa a origem. Você pode mudar para um comando direto ou baixar uma cópia local.

Instalar com Codex ou Claude Copie este prompt, cole no Codex, Claude ou outro assistente e deixe que ele revise a página da skill e instale para você.

Um comando direto ignora o prompt de revisão. Verifique a origem antes de executá-lo.

npx skills add https://github.com/rjmurillo/ai-agents --skill adr-review

O comando permanece em uma só linha. Role horizontalmente para revisá-lo antes de copiar.

Prefere uma cópia local? Baixe os arquivos disponíveis atualmente no SkillsMP.

Revise os arquivos de origem

Leia o SKILL.md e os arquivos complementares exibidos pelo SkillsMP antes de decidir se vai instalar.

Explorador de arquivos

11 arquivos

SKILL.md

Instruções da origem · Visualização somente leitura

Voltar à pesquisa Voltar à instalação

spec

Define what to build. Transform a problem into testable requirements with acceptance criteria.

2026-08-09

session-end

Validate and complete session logs before commit. Auto-populates session end evidence (commit SHA, lint results, memory updates) and runs validation. Use when finishing a session, before committing, or when session validation fails. Do NOT use to create a new session log (use session-init) or to repair a session protocol failure reported by CI (use session-log-fixer).

2026-08-09

session-init

Create protocol-compliant JSON session logs with verification-based enforcement. Autonomous operation with auto-incremented session numbers and objective derivation from git state. Use when starting any new session. Use when you say "start a session", "create the session log". Do NOT use for mid-session protocol checks (use session), or to complete and validate a log at the end of a session (use session-end).

2026-08-09

Ver todas deste repositório

name	adr-review
version	1.1.0
description	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).
license	MIT
metadata	{"subagent_model":"claude-opus-4-6","domains":["architecture","governance","multi-agent","consensus"],"type":"orchestrator","inputs":["adr-file-path","change-type"],"outputs":["debate-log","updated-adr","recommendations"],"file_triggers":{"patterns":[".agents/architecture/ADR-.md","docs/adr/ADR-.md","docs/architecture/ADR-.md","docs/decisions/ADR-.md","architecture/decisions/ADR-*.md",".agents/SESSION-PROTOCOL.md"],"events":["create","update","delete"],"auto_invoke":true}}

ADR Review

Multi-agent debate pattern for rigorous ADR validation. Orchestrates 6 specialized agents through structured review rounds until consensus or 10 rounds maximum.

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

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, update, delete
`ADR-*.md`	`architecture/decisions/`	create, update, delete
`SESSION-PROTOCOL.md`	`.agents/`	create, update, delete

Agent	Focus	Tie-Breaker Role
architect	Structure, governance, coherence, ADR compliance	Structural questions
critic	Gaps, risks, alignment, completeness	None
independent-thinker	Challenge assumptions, surface contrarian views	None
security	Threat models, security trade-offs	None
analyst	Root cause, evidence, feasibility	None
high-level-advisor	Priority, resolve conflicts, break ties	Decision paralysis

Phase	Purpose	Details
Phase 0	Related work research	Search issues/PRs for context
Phase 1	Independent review	Each agent reviews ADR using Zimmermann 7-question checklist
Phase 2	Consolidation	Identify consensus and conflicts; flag review anti-patterns
Phase 3	Resolution	Propose updates for P0/P1 issues
Phase 4	Convergence check	Agents vote: Accept/D&C/Block

Phase	Purpose
D1	Detection - identify deleted ADR
D2	Impact assessment - find dependencies
D3	Archival decision - archive accepted ADRs
D4	Cleanup - update references

adr-review

Opções de instalação

Revise os arquivos de origem

ADR Review

Triggers

ADR Review

Triggers

Quick Start

File Triggers

When to Use

Agent Roles

Process

Deletion Workflow

Issue Resolution

Phase 4: Strategic Review (Principal-Level Validation)

Strategic Validation Checklist

Chesterton's Fence (Change Justification)

Path Dependence (Irreversibility Recognition)

Core vs Context (Investment Prioritization)

Second-System Effect (Over-Engineering Detection)

Strategic Review Verdict

Scripts

Verification Checklist

Anti-Patterns

Process Anti-Patterns

Review Anti-Patterns (Zimmermann)

References

Priority	Requirement	Gate
P0	Must resolve	BLOCKING
P1	Resolve OR defer with issue	BLOCKING
P2	Document	Non-blocking

Script	Purpose
`.claude/skills/adr-review/scripts/detect_adr_changes.py`	Detect ADR file changes for the Claude skill tree
`src/copilot-cli/skills/adr-review/scripts/detect_adr_changes.py`	Detect ADR file changes for the Copilot CLI mirror

Avoid	Why	Instead
Single-agent ADR review	Misses domain expertise	Use full 6-agent debate
Skipping Phase 0	Duplicates existing work	Always research first
Ignoring D&C dissent	Loses important context	Document all reservations
Manual ADR monitoring	Error-prone	Use detect_adr_changes.py
Deleting accepted ADRs without archive	Loses knowledge	Always archive accepted ADRs

Anti-Pattern	Problem	Detection
Pass Through	Few/no comments, document barely read	Agent produces no substantive findings
Copy Edit	Focuses on wording, ignores content	All findings editorial, none architectural
Siding/Dead End	Comments switch topic, deviate from ADR	Agent drifts from decision at hand
Self Promotion	Recommends reviewer's preferred solution	Agent pushes technology without objective rationale
Power Game	Authority claims instead of technical arguments	Agent uses position over evidence
Offended Reaction	Defends criticized position subjectively	Agent reacts emotionally to rationale
Groundhog Day	Same message repeated across rounds	Agent re-raises resolved issues

Document	Content
debate-protocol.md	Full Phases 0-4 workflow
deletion-workflow.md	Phases D1-D4 workflow
issue-resolution.md	P0/P1/P2 handling and deferral
artifacts.md	Output formats and templates
agent-prompts.md	Detailed agent prompt templates
zimmermann-review-guidance.md	Review practices, 7 anti-patterns, checklist, reviewer pledge (Zimmermann 2023)

adr-review

Informações da origem

Opções de instalação

Revise os arquivos de origem

Mais deste repositório

Mais deste repositório

ADR Review

Triggers

ADR Review

Triggers

Quick Start

File Triggers

When to Use

Agent Roles

Process

Deletion Workflow

Issue Resolution

Phase 4: Strategic Review (Principal-Level Validation)

Strategic Validation Checklist

Chesterton's Fence (Change Justification)

Path Dependence (Irreversibility Recognition)

Core vs Context (Investment Prioritization)

Second-System Effect (Over-Engineering Detection)

Strategic Review Verdict

Scripts

Verification Checklist

Anti-Patterns

Process Anti-Patterns

Review Anti-Patterns (Zimmermann)

References