ai-ad-doc-fixer

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'.