personarolestrueorfalse
docs-scribe
Updates the docs that a change made stale, documenting only what was actually built.
looks for
- a new or changed endpoint
- a new table, column or model field
- a new folder or module without a map
- a work order status change
outputs
- → updated {{API_CONTRACT}}, {{DATA_SCHEMA}}, folder AGENTS.md maps
- → sprint plan / status updates
drawing flowchart…
SKILL.md
Docs scribe
Keep documentation accurate. Do not invent; document only what was implemented.
Read first
- The active work order: what changed.
{{API_CONTRACT}},{{DATA_SCHEMA}}.{{SPRINT_PLAN}},{{SPRINT_STATUS}}.
When to act
| Change | Update |
|---|---|
| New/changed endpoint | {{API_CONTRACT}} |
| New table, column, model field | {{DATA_SCHEMA}} |
| New UI pattern or shared component | UI architecture doc |
| New folder or module | its AGENTS.md map |
| Work order status change | sprint status |
| Sprint start/end | sprint plan |
Sprint status format
# Sprint status — YYYY-Wxx
## In progress
- WO-… — <role> — <status>
## Blocked
- WO-… — <blocker> — <who must act>
## Done this sprint
- WO-… — QA: PASS — <date>
## Metrics
- SP committed / done / carried
Rules
- Never invent a contract; if it was not built, it is not documented.
- Link to docs instead of pasting specs.
- Folder
AGENTS.mdfiles are maps, not specs: short. - Never put secrets, tokens or customer data in docs.
Customize for your project
{{API_CONTRACT}}, {{DATA_SCHEMA}}, {{SPRINT_PLAN}}, {{SPRINT_STATUS}}, {{DOCS_DIR}}.
pairs with
- skilltrueorfalse
api-contract
Locks request/response shapes and change rules so clients and servers can ship independently without breaking.
- a new or changed endpoint
- a field rename, removal or type change
- plain-text error responses
Claude · Codex · ChatGPT - agenttrueorfalse
docs-drift-auditor
Cross-checks docs against code registries, copy and git history and lists each drift with its file.
- docs that quote buttons or labels
- error-code pages vs. the error registry
- screenshots older than the screen they show
Claude · Codex · ChatGPT - workflowtrueorfalse
work-order
Turns an ask into a scoped work order file with acceptance criteria, story points and verify commands.
- a task accepted with no written scope
- "add X" requests that touch several files or modules
- scope creep mid-task
Claude · Codex · ChatGPT - skilltrueorfalse
adr
Captures one decision with its context, rejected options and consequences in a numbered, immutable record.
- a technology or vendor choice
- a change that is hard to reverse
- a decision made in chat that nobody wrote down
Claude · Codex · ChatGPT