51 lines
2.2 KiB
Markdown
51 lines
2.2 KiB
Markdown
---
|
|
name: doc
|
|
description: |
|
|
Full documentation audit and sync. Auto-detects what doc files the project
|
|
actually has — root docs (README, CLAUDE.md, INSTALL.md, CONFIGURE.md,
|
|
USAGE.md, DEPLOY.md, CONTRIBUTING.md, CHANGELOG.md), docs/**/*.md, project-state
|
|
files in .claude/{tasks,audits,memory}/, and inline comments (JSDoc, docstrings,
|
|
rustdoc, godoc). Stack-aware: detects framework + deploy complexity, proposes
|
|
DEPLOY.md only when non-trivial (Docker, fly.toml, k8s, multi-stage CI), skips
|
|
for trivial deploys (FTP push, single scp, plain static). Enforces README
|
|
presence with typical GitHub layout (title, quick start, links to existing
|
|
sub-docs). Cross-references git history for drift; detects added features
|
|
missing from docs and removed features still documented (feature delta
|
|
detection). Reports drift with commit refs, proposes fixes, patches approved
|
|
items.
|
|
Trigger: "doc", "sync docs", "audit docs", "update readme", "check documentation",
|
|
"are docs up to date", "documentation drift", "stale docs", "new feature not documented",
|
|
"removed feature still in docs", "create README", "should I have a DEPLOY doc".
|
|
Replaces the old /readme skill with broader scope.
|
|
argument-hint: [leave empty for full audit, or list specific files/docs to check]
|
|
disable-model-invocation: false
|
|
allowed-tools:
|
|
- Read
|
|
- Edit
|
|
- Write
|
|
- Bash
|
|
- Grep
|
|
- Glob
|
|
---
|
|
|
|
Load and follow strictly:
|
|
- $HOME/.claude/agents/doc-syncer.md
|
|
|
|
## Resources
|
|
|
|
The agent uses these reusable templates instead of inlining markdown each time:
|
|
|
|
- `resources/templates/README.md.tpl` — GitHub-style README skeleton (title, quick start, sub-doc links, stack, license).
|
|
- `resources/templates/DEPLOY.md.tpl` — Deploy doc skeleton (prereqs, build, deploy, verify, rollback, common failures).
|
|
|
|
When the agent decides a doc must be created (STEP 5 / STEP 6 in the agent flow),
|
|
read the matching template, substitute `{{PLACEHOLDERS}}` from project state
|
|
(stack detection, manifest, env signals), and write to project root. Do not
|
|
copy the placeholders verbatim — every `{{...}}` must be replaced or removed
|
|
before writing.
|
|
|
|
Execute the DOC SYNCER on this project.
|
|
|
|
Context from the user (if any):
|
|
$ARGUMENTS
|