AdrMcp

Use when the user wants to write, draft, or create an Architectural Decision Record (ADR) — capturing an architecture or technical decision, recording why a choice was made, or documenting a decision for the team. Guides framing a sharp Context/Decision/Consequences and drives the AdrMcp MCP tools (create_adr, validate_adr) to produce a well-formed MADR record. Triggers on "write an ADR", "record this decision", "create a decision record", "document this architecture choice", "we decided to…".

Use when the user wants to review, critique, or sanity-check an Architectural Decision Record (ADR) — an existing record or a draft. Evaluates whether the decision is sound, falsifiable, honestly scoped, and well-linked, using the AdrMcp MCP tools (get_adr, validate_adr, detect_conflicts, find_related_adrs). Triggers on "review this ADR", "critique my decision record", "is this ADR any good", "check ADR-000X", "does this decision hold up".

Use when an existing architectural decision is being changed, replaced, retired, reversed, or deprecated — the team changed its mind and a prior ADR no longer reflects reality. Drives the correct lifecycle transition and bidirectional linking via the AdrMcp MCP tools (supersede_adr, set_status, link_adrs, find_related_adrs). Triggers on "supersede ADR-000X", "we changed our mind about", "replace/retire this decision", "this ADR is out of date", "mark as deprecated/superseded", "reverse decision".