What problem does it solve? Repositories often lack a consistent documentation structure, or have Markdown files scattered across random locations. This Skill sets up a standard docs layout (ADRs, specs, guides, references) and can generate content from git history or migrate existing docs into place. ## Core Features & Use Cases - Template scaffolding: Creates the standard docs directory tree, mkdocs.yml, PR template, CODEOWNERS, and doc-staleness config, all idempotently. - Backfill from history: Generates ADRs for major technology choices, stub specs from merged PRs, and setup/development/deployment guides by analyzing git log, GitHub PRs, and codebase config files. - Upgrade and clean modes: Migrates scattered Markdown files into the standard layout with link rewriting, or removes scaffold files while preserving user-generated content. - Use Case: After adopting a docs convention, run the upgrade and backfill modes together to migrate existing Markdown docs into docs/ and auto-generate ADRs and guides from repository history. ## Quick Start Ask the assistant to run stark-init-docs with the backfill mode to scaffold the docs structure and generate documentation from this repository's git history.
