Audit ADRs for filler, hedging, and drift with line-level rewrite proposals.
npx skills add https://github.com/janmohammadi/deep-adr --skill adr-critique
Please help me install this Agent Skill. Skill: adr-critique Source: https://github.com/janmohammadi/deep-adr/tree/main/skills/adr-critique Command: npx skills add https://github.com/janmohammadi/deep-adr --skill adr-critique
Audit existing or legacy ADRs that weren't written through /draft-adr — flag filler, hedging, implementation detail, missing why, weak Architecture Contracts, inconsistency with other ADRs, and LikeC4 drift. Produces line-level rewrite suggestions for human review.
Run the adr-critique skill on an existing ADR to generate line-by-line rewrite suggestions for human review.
High-intent search queries and answers about installing and using this skill.
Auditing existing architecture decision records (ADRs) for filler and missing context involves analyzing legacy documents to surface hedging, implementation details, and missing rationale, then generating line-level rewrite proposals for human review and approval.
ADR drift occurs when documented architecture decisions become inconsistent with actual system models or other ADRs. You can detect this drift by auditing ADRs against LikeC4 models to ensure consistency, traceability, and alignment with current architecture contracts.
Rewriting legacy ADRs to improve precision requires isolating surface issues like weak architecture contracts from substantive decision content, then applying line-by-line rewrite suggestions that tighten language and restore missing rationale for human approval.
Yes, you can check imported ADRs for weak architecture contracts and missing rationale by running an audit that adheres to ADR-IS-NOT rules, quoting exact original lines that violate these rules, and flagging where explicit reasoning is lacking for human review.
Automated ADR critique is limited to surfacing surface-level quality issues like filler and drift; it requires manual human review to approve per-line rewrite suggestions, ensuring substantive decision content remains intact and accurate to the actual architecture.
rvdbreemenMonitor adr-kit Architecture Decision Records with drift checks, stale detection, and linting.
BedaBeda-GrowthAutomate baseline verification and drift review with approval signatures.
juliuslAuthor, review, and manage Architectural Decision Records with templates and governance policies.
StudentCristianEvaluate solution architecture documents using structured critique dimensions for quality issues.
