ai-ad-doc-fixer

Audit ASDD documentation files for accuracy and propose P0/P1/P2 fixes.

Updated Nov 8, 2025
One-click install
npx skills add https://github.com/wade56754/AI_ad_spend02 --skill ai-ad-doc-fixer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-ad-doc-fixer
Source: https://github.com/wade56754/AI_ad_spend02/tree/main/.claude/skills/ai-ad-doc-fixer
Command: npx skills add https://github.com/wade56754/AI_ad_spend02 --skill ai-ad-doc-fixer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solves?

Documentation often contains inconsistencies, structural flaws, or even violations of core architectural principles, requiring careful review and revision. This Skill acts as a Documentation Reviewer & Fixer, identifying P0/P1/P2 issues and proposing revisions within strict boundaries to ensure compliance without inventing new business logic.

Core Features & Use Cases

  • Multi-Level Issue Detection: Scans documents for P0 (blocking), P1 (structural), and P2 (expressive) issues, including constitutional violations and SoT conflicts.
  • Boundary-Aware Revision: Proposes document revisions (e.g., restructuring, clarifying language, correcting references) only within allowed scope, strictly avoiding business logic changes.
  • Halt & Conflict Mechanisms: Automatically stops and reports when information is missing or conflicts with core documents, preventing speculative fixes.
  • Use Case: You have a PROJECT.md document with unclear sections and potential conflicts with MASTER.md. Use this Skill to get a detailed audit report and a proposed revision that clarifies the structure and resolves inconsistencies without altering core business definitions, saving you from manual, error-prone revisions.

Quick Start

Use ai-ad-doc-fixer to analyze and propose fixes for 'docs/1.overview/PROJECT.md', ensuring compliance with 'MASTER.md'.

Frequently Asked Questions about ai-ad-doc-fixer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit documentation for compliance and architectural violations?

Documentation audits scan for P0 (blocking), P1 (structural), and P2 (expressive) issues, including constitutional violations and source-of-truth conflicts. This Skill classifies issues by severity, assesses risk, and proposes fixes within defined boundaries to ensure your docs align with core architecture without introducing business logic changes.

Can I use a documentation fixer to detect conflicts between PROJECT.md and MASTER.md?

Yes. The Skill identifies and reports inconsistencies between project documentation and master documents, then halts when conflicts prevent safe resolution. It outputs a detailed audit trail showing which issues were detected and which require manual intervention.

What types of documentation can this Skill review and fix?

The Skill handles PROJECT.md, ARCHITECTURE.md, PATTERNS.md, TESTING.md, DEPLOYMENT.md, and other development guides. It performs navigation-only review on DOMAIN.md and applies consistent issue detection and patch proposals across all supported formats.

How do I ensure documentation fixes stay within safe boundaries?

The Skill enforces boundary-aware revision by proposing restructuring, language clarification, and reference corrections only—never inventing new business logic. It includes Guardian, Reviewer, and Fixer role checks to halt or flag conflicts when information is missing or contradicts core documents.

What's the difference between P0, P1, and P2 documentation issues?

P0 issues are blocking (halt processing); P1 issues are structural flaws affecting clarity; P2 issues are expressive improvements. The Skill classifies each issue by severity and risk, then proposes targeted fixes proportional to impact.

Can I get a recommended document version after the audit completes?

Yes. The Skill outputs patch content, a final recommended document version, and a complete audit trail documenting all detected issues, classifications, and proposed revisions for your review and approval.