b2a5b5a602
Auto-discover what the project actually has instead of a fixed doc list:
root files (incl. DEPLOY.md, SECURITY.md, ARCHITECTURE.md, ROADMAP.md),
docs/**, and .claude/{tasks,audits,memory}/.
Detect stack (Node/Python/Rust/Go/Ruby/PHP/Dart/.NET) and deploy
complexity (NONE/TRIVIAL/NON_TRIVIAL) to drive doc-needs:
- Propose DEPLOY.md only when non-trivial (Docker, fly.toml, k8s,
multi-stage CI).
- Propose inlining/removing DEPLOY.md when deploy is trivial.
- Enforce README presence with typical GitHub layout.
Add CREATE/REMOVE proposal categories to the validation gate. Update
auto-mode to map deploy artifacts to DEPLOY.md and decisions.md
architectural changes back to CLAUDE.md/README.
Sync skills/doc/SKILL.md description + triggers to match.
Co-Authored-By: Claude <noreply@anthropic.com>
1.5 KiB
1.5 KiB
| name | description | argument-hint | disable-model-invocation | allowed-tools | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| doc | 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. |
|
false |
|
Load and follow strictly:
- $HOME/.claude/agents/doc-syncer.md
Execute the DOC SYNCER on this project.
Context from the user (if any): $ARGUMENTS