What problem does it solve? Project documentation is often scattered, inconsistent, or missing entirely, making it hard for developers, users, and AI agents to find reliable information. This Skill establishes a complete documentation system from scratch or migrates existing docs into a single standard: one entry-point map, a purpose-based directory taxonomy, frontmatter conventions, and user guides compiled into PDF. ## Core Features & Use Cases - Bootstrap or migrate docs: The init mode scaffolds a skeleton (map, taxonomy directories, glossary, diagrams) while migrate inventories existing files, plans git-history-preserving moves, and fills gaps. - Session-persistent progress tracking: A versioned manifest (docs/.docs-system/progress.md) plus per-document status frontmatter lets work resume across sessions without replanning. - Golden-data quality gates: Articles get code-grounded citations (file:line), a machine-readable docs-index.json, and automated checks for broken citations, metadata uniformity, and doc/code drift. - Orchestration of specialized skills: Delegates data-model docs to db-docs, diagrams to diagram, PDF compilation to pdf, and C4 architecture to c4-architecture. - Use Case: Ask it to "bring order to docs" in a legacy repository; it inventories all Markdown files, proposes a migration plan for approval, moves files with git mv, adds frontmatter and indexes, and produces a user-guide PDF. ## Quick Start Ask the agent to run docs-system in init mode to scaffold a documentation skeleton for this project, or in migrate mode to reorganize the existing docs folder.
