Docs & Repo
Keep README, setup/runbooks, and ADRs current when behavior or architecture changes.
Standard (required)
Documentation belongs to the project, not the chat or the author. Follow rule docs-professional-standard:
- Professional, inheritable voice (system behavior, not “today I…”)
- No transient references: people, unrelated projects, session drama, client-specific workspace IDs
- Timeless where possible; verify against code
- Docs/HANDOFF/inventories are indicative; delivery truth comes from code, APIs, infra, SHAs, and published artifacts (never docs alone)
- Inheritance test: a new maintainer can use it in 12 months without the chat
Also follow agent-output-hygiene (no agent metalinguage in artifacts).
1---2name: docs-repo3description: Docs & Repo skill.4---56# Docs & Repo78Keep README, setup/runbooks, and ADRs current when behavior or architecture changes.910## Standard (required)1112Documentation belongs to the **project**, not the chat or the author. Follow rule `docs-professional-standard`:1314- Professional, inheritable voice (system behavior, not “today I…”)15- No transient references: people, unrelated projects, session drama, client-specific workspace IDs16- Timeless where possible; verify against code17- Docs/HANDOFF/inventories are **indicative**; delivery truth comes from code, APIs, infra, SHAs, and published artifacts (never docs alone)18- Inheritance test: a new maintainer can use it in 12 months without the chat1920Also follow `agent-output-hygiene` (no agent metalinguage in artifacts).