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>
38 lines
1.5 KiB
Markdown
38 lines
1.5 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
|
|
|
|
Execute the DOC SYNCER on this project.
|
|
|
|
Context from the user (if any):
|
|
$ARGUMENTS
|