What problem does it solve? Software projects accumulate stale, duplicated, or missing documentation that drifts out of sync with the code. This Skill scaffolds new documentation trees, normalizes existing ones, and keeps docs accurate after material changes, using evidence from the repository rather than guesswork. ## Core Features & Use Cases - Documentation scaffolding: Create a right-sized docs structure (compact, standard, or operational profile) with README entry points, architecture overviews, ADRs, design docs, and runbooks. - Existing-tree normalization: Inventory and classify current documents by role, state, and authority, then execute a source-to-destination migration map that preserves links and history. - Lifecycle-aware authoring: Use adaptable templates for architecture overviews, design documents, ADRs, and runbooks with explicit status tracking (current, proposed, superseded, historical). - Use Case: After a major refactor changes your service's interfaces and deployment model, use this Skill to update the living architecture docs, record the consequential decisions as ADRs, and verify every link and command still matches the repository. ## Quick Start Use the document-software skill to audit this repository's documentation and scaffold the smallest structure that fits its maturity.
