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
Install
vladm3105/aidoc-flow-framework/doc-adr-fixer · repository language: Python
git clone https://github.com/vladm3105/aidoc-flow-framework
cp -r aidoc-flow-framework/platforms/claude-code-plugin/skills/doc-adr-fixer ~/.claude/skills/doc-adr-fixernpx skillfed install vladm3105/aidoc-flow-framework/doc-adr-fixerFrequently 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)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
platforms/claude-code-plugin/skills/doc-adr-fixer/SKILL.md