| name | check-wiki |
| description | Run a health check on the wiki. Finds stale articles, missing coverage, broken backlinks, and opportunities for cross-linking. Use at the start of a new session, or when the user says "check wiki", "wiki health", "audit wiki", "wiki status".
|
Wiki Health Check
Audit the wiki for staleness, gaps, and broken links.
Fix issues automatically where possible; report what was fixed and what needs human attention.
Prerequisites
Wiki/ must exist.
If it doesn't, suggest running init-wiki.
Procedure
1. Load the wiki state
Read Wiki/Index.md to get the full article inventory.
Read Wiki/Status.md for current project context.
2. Check for stale articles
For each article in the index:
- Read the article
- Identify code files, functions, or entities it references
- Check if those still exist and match the article's description
- If stale: update the article to match current reality
Stale = article describes something that has changed, been renamed, removed, or works differently than described.
3. Find missing articles
Scan the repo for entities that should have wiki coverage but don't:
- Code files with no corresponding article
- Functions/classes/modules not mentioned in any article
- Resources in
Wiki/Resources/ not indexed
(Notebooks are generated artifacts in NotebooksLLM/, not wiki articles — do not expect them in the index.)
For each missing entity: create a wiki article and add it to the index.
4. Check cross-links
Scan all relative markdown links across all articles:
- If a link points to a nonexistent file: either create the article (if the entity exists) or remove the broken link
- If two articles are clearly related but not cross-linked: add the link
5. Check resources
For each Wiki/Resources/*.md file:
- Verify the
## Recover section exists and has a valid URL
- Optionally test URL reachability (only if the user explicitly asks for deep check)
- Flag resources with missing or malformed recover sections
6. Verify index completeness
Compare the files in Wiki/ subdirectories against entries in Wiki/Index.md.
Every .md file (except Index.md, Status.md) should have an index entry.
Add missing entries.
7. Check work items
Read Work/README.md and scan Work/Active/*.md (an item's status is its folder).
Flag any active item whose ## Progress has no recent session (or none at all) — it may be stalled.
Flag index rows whose "next task" no longer matches the first unchecked task, and active items missing from the index.
Light check — report, don't auto-fix.
8. Report
Present a summary to the user:
Wiki Health Check:
- Articles checked: N
- Stale articles fixed: N (list)
- New articles created: N (list)
- Broken links fixed: N
- Missing index entries added: N
- Resource issues: N (list)
- Stalled work items: N (list)
If everything is clean: "Wiki is healthy.
No issues found."
When to run automatically
- Start of a new conversation/session (quick check)
- After a large refactor or code reorganization
- When the user asks for project status
For session-start checks, keep it fast: only scan the index and status, don't deep-check every article.
Flag anything suspicious for manual review.