adr-critique
adr-critique systematically reviews existing or inherited ADRs to identify violations of shared rules, gaps in business-to-architecture reasoning, and conflicts with neighboring decisions or LikeC4 models. Each issue surfaces as a single flag requiring architect sign-off before moving to the next, ensuring quality without bulk rewrites.
adr-critique audits existing ADRs line-by-line to surface rule violations, missing reasoning, and inconsistencies requiring architect approval.
AI-generated summary based on this skill's SKILL.md
Install
JosiahSiegel/claude-plugin-marketplace/adr-critique · repository language: Shell
git clone https://github.com/JosiahSiegel/claude-plugin-marketplace
cp -r claude-plugin-marketplace/plugins/doc-master/skills/adr-critique ~/.claude/skills/adr-critiquenpx skillfed install JosiahSiegel/claude-plugin-marketplace/adr-critiqueFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
What does adr-critique do?
adr-critique systematically reviews existing or inherited ADRs to identify violations of shared rules, gaps in business-to-architecture reasoning, and conflicts with neighboring decisions or LikeC4 models. Each issue surfaces as a single flag requiring architect sign-off before moving to the next, ensuring quality without bulk rewrites.
How do I audit our architecture decision records?
adr-critique audits your ADR corpus by scanning each record against rule violations, missing business-to-architecture reasoning, and consistency gaps. It flags issues one at a time so your team can review and sign off on each before proceeding, making cleanup deliberate and traceable rather than automated.
Can adr-critique detect filler in architecture decisions?
Yes. adr-critique identifies filler, hedging language, and drift in architecture decision documents. It surfaces vague or non-committal phrasing that weakens decision clarity, helping you tighten reasoning and remove unnecessary padding from your ADR corpus.
Does adr-critique validate ADR graph relationships?
adr-critique can validate ADR graph relationships and check alignment with LikeC4 models. This helps you spot conflicts between neighboring decisions and ensure your architecture documentation stays consistent with your system model.
What license does adr-critique use?
adr-critique is released under the MIT license, allowing free use, modification, and distribution in both open-source and commercial projects.
Can adr-critique review legacy or imported ADRs?
adr-critique is designed to critique legacy and inherited ADRs, including those imported from other sources or generated by LLMs. It performs line-by-line review to catch quality issues, missing reasoning, and violations before you adopt them into your decision log.
SKILL.md
rendered from the published skill — quoted content, verbatim
adr-critique
Line-by-line auditor for legacy / external / pre-existing ADRs. Surfaces violations of the shared "ADR is not" rules, missing-why reasoning, inconsistency with neighbors, and drift against LikeC4 models. Touches only architect-approved lines.
When to use this skill
- ADRs that predate
adr-drafting(legacy corpus) - ADRs imported from other teams
- ADRs generated by generic LLM tooling without push-back
- Periodic corpus-wide quality sweeps
When NOT to use this skill
- ADRs already self-critiqued by
adr-drafting(Phase 6) — they've been through the filter. - ADRs you want to rewrite from scratch — use
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 2 files
plugins/doc-master/skills/adr-critique/SKILL.md
plugins/doc-master/skills/adr-critique/references/audit-checklist.md