documentation

# Documentation Write docs that developers actually read. Based on Stripe API docs, Standard Readme, Keep a Changelog, and OpenAPI. ## Sub-Commands | Command | Description | |---------|-------------| | `readme` | Generate a README from project files | | `api` | Generate API docs from OpenAPI spec or route handlers | | `changelog` | Generate changelog from conventional commits | | `kb` | Write a knowledge base article | ## README Structure ``` # Project Name [Badges] > One-line description ## Features (3-6 quantified benefits) ## Quick Start — copy-paste runnable (no placeholders, no omitted imports) ## API Reference — every export in table format ## Examples — 2-3 real-world scenarios ## Configuration — env vars, config file, CLI flags ## Contributing — dev setup commands ## License — SPDX identifier ``` ### The Hook (first paragraph) Answers: what (5 words), who, why. Bad: "A React component library for building modern user interfaces." Good: "Buttons, modals, forms, done right. No design debt. Zero dependencies." ### Quick Start Rules Copy-paste runnable. No omitted imports. No placeholders. No "coming soon". Include expected output. ### Badge Requirements | Badge | Required? | |-------|-----------| | CI (build status) | Yes | | Package version | Yes | | License | Yes | | Coverage | Recommended | ## API Documentation ### Structure per Endpoint ``` ### [METHOD] [Path] **Description**: one sentence **Auth required**: Yes/No [type] **Request**: Headers, Paramet...