adr-manager

name

adr-manager

description

Unified ADR workflow for any repository. Use when Codex needs to determine whether a change needs an Architecture Decision Record, draft a new ADR or propose an update, lint or review an ADR draft, audit ADRs against docs/specs/tests/src for drift, or refresh ADR index artifacts in repositories that already define ADR indexing conventions. Trigger on requests about ADRs, architecture decisions, design rationale, issue/PR/diff policy changes, ADR review, ADR audits, or ADR index maintenance.

ADR Manager

Overview

Handle the full ADR lifecycle through one entry point. Detect repository-specific ADR conventions first, then route to the right mode and fall back to bundled defaults only when the repository does not define its own template or workflow.

Mode Routing

Choose one mode before producing output:

• decide
  • Use for issue, PR, diff, review-thread, or design-change triage.
  • Return whether an ADR is required, recommended, or not-needed.
• draft
  • Use for creating a new ADR draft or proposing an update to an existing ADR.
  • If the change is not ADR-worthy, return ADR not needed instead of forcing a draft.
• lint
  • Use for structural validation of an ADR draft.
  • Focus on status, required sections, evidence quality, and supersede linkage.
• review
  • Use for design review after lint has no unresolved high or medium findings.
  • Focus on decision quality, conflicts, rollout risk, and human-owned decisions.
• audit