Staleness Detector — Development agent for Claude Code
Use this agent to detect stale documentation by comparing git timestamps between source files and their corresponding doc files.
How to install Staleness Detector
Installs to ~/.claude/agents/xiaolai-docs-guardian-for-claude-staleness-detector.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/xiaolai/docs-guardian-for-claude/HEAD/agents/staleness-detector.md -o ~/.claude/agents/xiaolai-docs-guardian-for-claude-staleness-detector.md Restart Claude Code, or start a new session, for it to be picked up.
What Staleness Detector does
name: staleness-detector description: Use this agent to detect stale documentation by comparing git timestamps between source files and their corresponding doc files. Runs staleness-check.sh for mechanical git work, then interprets the results.
Context: Auditing documentation freshness user: "Check if our docs are up to date" assistant: "I'll use the staleness-detector agent to compare git timestamps between code and docs." Staleness detection is the firstAlternatives in Development
- Docs Drift Review — Given a session's commits or diff, finds the docs that the change made wrong — stale paths and symbols, checkl 7.2k ★
- Review Agent — You are a specialized review agent 3.6k ★
- Subdomain Enumeration — subfinder -d {domain} -silent sort -u subs.txt amass enum -passive -d {domain} subs.txt sort -u subs.txt -o su 213 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Doc Janitor
Use this agent to clean up stale documentation artifacts before merging a branch. Finds plan files, session su
Docs Staleness Detector
Use this agent when a core change has been made to the repository and you need to verify that related document
Performance Debt Detector
Detect performance anti-patterns including N+1 queries, sync in async, unbounded collections, and O(n²) algori
Memory Builder
Use when memory-orchestrator reports the context-pack missing or stale and it must be rebuilt — scans the repo
Dotfile Drift Reporter
Detect drift between the chezmoi source state and the live $HOME files. Summarize what's out of sync and propo
API Contract Watcher
Use to detect breaking changes to public APIs (HTTP endpoints, library exports, gRPC methods, CLI flags) betwe
Related Skills
Audit Docs
Scan documentation for staleness — broken links, outdated counts, stale version references, and inconsistencie
Cfn Detect Stale Docs
Find documentation that's out of sync with code
Docs Audit
Detect stale or fabricated documentation after code changes — symmetric to /onboard-codebase