writing-docslisted

# Writing Docs cc-port documentation has a single shared invariant: **no sentence appears on more than one surface**. The authored surfaces split by audience: - **Human-targeted prose** — root `README.md`, module `README.md`, `docs/architecture.md`. Audience is an experienced Go developer reading for task-fit. - **LLM-targeted pointer maps** — module `AGENTS.md`. Audience is the agent navigating the module before edits. Out of scope here: code comments (`writing-go-code` skill — point-of-use *why* lives in code, classified per-comment during code work) and procedural artifacts under `docs/superpowers/`. ## Workflow ```dot digraph docs_workflow { entry [shape=doublecircle, label="About to write\nor edit a doc"]; surface [shape=box, label="Confirm\nthe surface"]; branch [shape=diamond, label="Surface type?"]; out_of_scope [shape=octagon, style=filled, fillcolor=red, label="STOP — code comment\nor superpowers plan;\nuse the right skill"]; prose_shape [shape=box, label="Apply prose\nsurface shape"]; prose_write [shape=box, label="Write the prose"]; slop [shape=box, label="Anti-slop pass"]; slop_clean [shape=diamond, label="Pass clean?"]; agents_existence [shape=diamond, label="Module owns a hard\ncross-cutting constraint?"]; no_agents [shape=octagon, style=filled, fillcolor=red, label="STOP — module\ngets no AGENTS.md"]; agents_shape [shape=box, label="Apply AGENTS.md\npointer skeleton"]; agents_write [shape=box, label="Write