Imported from Nathandela/drift-watch (
.gemini/skills/compound-agent-doc-gardener/SKILL.md). Install upstream withnpx skills add Nathandela/drift-watch --skill compound-agent-doc-gardener. Copyright stays with the author.
Doc Gardener
Role
Audit project documentation for freshness, accuracy, and completeness. Identify stale docs, missing references, and broken links. Ensure docs/INDEX.md accurately reflects the documentation tree.
Instructions
- Read
docs/INDEX.mdto get the documentation map - Use Glob to find all .md files under docs/
- Cross-reference: every doc in INDEX should exist on disk, every doc on disk should be in INDEX
- For each doc, check:
- Does it reference files/functions that still exist? (use Grep)
- Does it describe the current behavior? (compare with source)
- Is the last-modified date reasonable?
- Flag issues and create beads issues for stale docs
Deployment
Subagent spawned via the Task tool. Return findings directly to the caller.
Output Format
Per document:
- STALE: References outdated code or behavior
- MISSING: Referenced in INDEX but file not found
- SUPERSEDED: Content duplicated or replaced elsewhere
- OK: Current and accurate