doc-adr-fixer
doc-adr-fixer consumes audit reports and patches ADRs to resolve structural, referential, and content issues identified during quality review. It supports both team-mode validation (with multi-lens dispatch) and single-pass remediation, backing up originals and reverting regressions to prevent silent failures.
doc-adr-fixer applies audit-identified fixes to Architecture Decision Records, resolving structure, links, and content issues.
AI-generated summary based on this skill's SKILL.md
Decision gist · record as of 2026-07-27
doc-adr-fixer applies audit-identified fixes to Architecture Decision Records, resolving structure, links, and content issues. doc-adr-fixer consumes audit reports and patches ADRs to resolve structural, referential, and content issues identified during quality review. It supports both team-mode validation (with multi-lens dispatch) and single-pass remediation, backing up originals and reverting regressions to prevent silent failures.
Use it when
- Yes.
- doc-adr-fixer supports team-mode validation with multi-lens dispatch, allowing fixes to be validated across multiple reviewer perspectives.
Verify before relying
Read SKILL.md below before installing (1 file). Open directory: indexed for reading, not audited.
Similar skills
Install
vladm3105/aidoc-flow-framework/doc-adr-fixer · repository language: Python
Open directory. Skills are indexed for reading, not audited. Review a skill's body before installing it.
Frequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I fix an ADR from an audit report?
doc-adr-fixer consumes audit reports and automatically patches ADRs to resolve structural, referential, and content issues identified during quality review. Feed it your audit findings and the tool applies targeted fixes to restore compliance, then backs up originals so you can revert if needed.
Can doc-adr-fixer fix broken ADR links and IDs?
Yes. doc-adr-fixer resolves ADR structure, links, and element ID issues as a core function. It corrects broken references, repairs section structure, and fixes element ID mismatches that audits flag, ensuring traceability and cross-references work correctly.
Does doc-adr-fixer support multi-reviewer validation?
doc-adr-fixer supports team-mode validation with multi-lens dispatch, allowing fixes to be validated across multiple reviewer perspectives. This closes the audit-fix-audit loop and prevents regressions by catching issues before they propagate.
What happens to my original ADR when doc-adr-fixer applies fixes?
doc-adr-fixer backs up your original ADR before applying any patches. If fixes introduce regressions or you want to revert, you can restore from backup. This safety mechanism prevents silent failures and lets you audit the changes.
Can doc-adr-fixer remediate upstream drift in ADRs?
Yes. doc-adr-fixer remediates upstream drift and traceability issues in ADRs, ensuring architecture decisions stay synchronized with audit findings and maintain proper referential integrity across your decision record collection.
Is doc-adr-fixer open source?
doc-adr-fixer is released under the MIT license, making it free to use, modify, and distribute for both commercial and personal projects.
SKILL.md
Rendered from the published skill. Quoted content, verbatim.
doc-adr-fixer
Purpose
Read the latest audit report and apply fixes to an ADR, bridging
../doc-adr-audit/SKILL.md and a passing ADR so the audit↔fix cycle can
converge.
Layer: 5 (ADR quality improvement).
Upstream: the ADR document + .aidoc/audit/05_ADR-audit.md.
Downstream: the fixed ADR + ADR-NN.F_fix_report_vNNN.md.
When to Use
After doc-adr-audit returns FAIL, as part of an Audit → Fix → Audit loop.
Do not use without an audit report (run the audit first) or to create a new
ADR (use ../doc-adr/SKILL.md /
(truncated - see the full file via the links below)
File tree — 1 file
platforms/claude-code-plugin/skills/doc-adr-fixer/SKILL.md
Let your AI agent find skills like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 56,283 agent skills by what they can do, searchable in plain language.
wish › “Apply fixes to an ADR based on audit report findings”
Give your agent the search over MCP, or paste the wish link into any chat. No install? Search from any chat →
Related skills
Automates the full ADR lifecycle from source documents (BRD, PRD, EARS, BDD) or free-text prompts through generation, validation, and iterative refinement. Detects whether an ADR exists, routes to generation or review-and-fix accordingly, and maintains the ADR index with passing scores. Supports single or batch processing with configurable quality thresholds and fix iteration limits.
Quality-advisor gives live feedback while you create or review SDD documents, catching completion gaps, documentation anti-patterns, tag compliance, and naming issues before submission. It scores sections, detects common problems like missing traceability or broken links, validates cumulative tagging across layers, and returns actionable recommendations to fix issues.
gate-check automates the verification step in the change governance process by selecting the correct approval gate based on affected layers, running its entry criteria and error checks, and populating the approval form for human sign-off. It verifies but never approves—all signature and decision fields remain blank for the designated approvers.
doc-adr captures a single architectural decision using the Context-Decision-Consequences pattern, positioned as Layer 5 in the specification-driven development flow. It records the rationale, chosen approach, evaluated alternatives, and accepted trade-offs for decisions that bridge container and component design.
doc-validator enforces consistency rules across your entire SDD documentation corpus—catching broken links, orphaned artifacts, cumulative-tag gaps, duplicate IDs, and traceability gaps across all 8 layers. It runs declarative checks against your corpus structure and can optionally repair safely-fixable issues like missing reciprocal links or stale metadata. Use it before releases or after batch generation to ensure your documentation chain stays machine-verifiable and traceable.
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.
More skills architecture-decision-records (MIT) · adr-drafting (MIT)