Agent Wiki Lint¶

Implements the LLM-Wiki "lint" operation as a periodic / on-demand health pass.

When to use¶

• After every 5+ ingests (heuristic).
• Weekly cadence.
• "Lint the wiki", "check wiki health", "what's broken in my notes?".

Procedure¶

1. Read AGENTS.md for conventions.
2. Walk the wiki to enumerate all pages with their frontmatter and inbound/outbound links.
3. Compute checks:
4. Orphans: pages with zero inbound links from non-index pages.
5. Source-less pages: entity/concept/topic pages with empty sources:.
6. Implicit concepts: terms repeatedly mentioned in body text but lacking their own page.
7. Cross-ref breakage: outbound link targets that don't resolve.
8. Contradictions: pages with ## Contradictions / open questions blocks still unresolved.
9. Staleness: pages whose updated: is older than N days but whose subject has been touched in log.md since.
10. Schema drift: pages missing required frontmatter or H1.
11. Suggest follow-ups: under-covered topics, sources to seek, questions to ask.
12. Write a lint report to log.md as ## [<yyyy-mm-dd>] lint | full, with bullets for each finding category.
13. Optionally fix trivial issues (e.g., add missing created: from file mtime). Anything non-trivial leaves a TODO instead.

Report format (for the log entry and for chat)¶

## [<yyyy-mm-dd>] lint | full

### Orphans
- ...

### Source-less pages
- ...

### Implicit concepts (no dedicated page)
- ...

### Broken cross-references
- ...

### Open contradictions
- ...

### Staleness
- ...

### Schema drift
- ...

### Suggested follow-ups
- ...

Anti-patterns¶

• Don't auto-resolve contradictions silently — they're flags for human attention.
• Don't delete pages, only flag.
• Don't apply destructive fixes without explicit approval.

Compatibility¶

• Read access to entire agent-wiki/.
• Write access only to log.md and small targeted fixes (frontmatter dates, etc.).
• No cloud egress required.