unified-docs

What problem does it solve?

Project documentation often becomes outdated, inconsistent, or non-compliant with team standards, leading to broken references, unclear current truth, and wasted time during audits or onboarding. This Skill eliminates those issues by enforcing strict metadata schemas, lifecycle rules, and dependency tracking for all common project doc types.

Core Features & Use Cases

• 3-Layer Mode Routing: Efficiently loads only the rules needed for the current task, with modes for Read (check doc status), Create (build new compliant docs), Maintain (update existing docs and fix metadata), and Audit (run full health checks of the doc corpus).
• Arg-Triggered Workflows: Skip mode selection with quick shortcuts like --audit-codebase for a full corpus audit or --create-plan to generate a structured implementation plan with gate conditions for a new feature.
• Enforced Doc Type Rules: Built-in contracts for plans, specs, ADRs, how-to guides, explanations, and TIL notes ensure every doc follows the correct lifecycle, frontmatter schema, and cascade dependency rules.
• Cascade Dependency Management: Automatically tracks depends-on and updates relationships between docs, flags broken links to archived or superseded content, and provides repair guidance to keep the doc graph accurate.

Quick Start

Use the unified-docs skill with the --audit-codebase argument to run a full health check of your project's documentation, or use --create-plan to generate a structured implementation plan for a new feature.