docs

# Documentation Author, audit, and maintain project documentation across every surface that matters: the **agent hot path** (`CLAUDE.md`, `AGENTS.md`, `.claude/rules/`), the **human entry point** (`README.md`), and the **narrative tier** (`docs/`). This is the single home for "make our docs good" work — bootstrapping a new project, refreshing docs after a sprint, writing a README that converts readers into users, or auditing the whole estate for drift. > **This `SKILL.md` is a thin index.** Detailed authoring rules live in > `rules/*.md` and load on demand. Worked examples are in > `references/*.md`. Literal scaffolding skeletons are in `templates/*.md`. > Do not preload everything — load only what the current phase asks for. --- ## Mode Detection Parse `$ARGUMENTS` (first token) and route to one of four modes. A second token of `--auto` is a cross-cutting modifier (see below). | Mode | Default | Trigger | | --------- | ------- | -------------------------------------------------------------------------------------- | | `init` | | "init", "bootstrap", "scaffold", or `$ARGUMENTS == "init"` (no existing CLAUDE.md). | | `update` | **yes** | Default when a `CLAUDE.md` already exists. "update", "sync", "refresh", "drift". | | `readme` | | "readme", "write a README", "audit the README", or `$ARGUMENTS == "readme"`. | | `audit` | | "audit", "revie...