kb-lint
Bring an llmkb knowledge base back to health: fix the mechanical defects the
tool finds, then the semantic ones only a reader can catch.
When to use
Periodically, or when a KB feels stale or inconsistent, or before relying on it for an important query.
Steps
- Run the tool.
llmkb lint --kb <dir>. Fix every error: broken links, pages missing from the index (llmkb reindexrepairs the index), dangling index entries, malformed frontmatter. Address warnings (orphans, log-format) where they matter. - Judgment checks the tool cannot do:
- Contradictions. Read related pages together; reconcile claims that conflict, and note the resolution.
- Stale claims. Where a newer source supersedes an older page, update the
page and its
timestamp; keep provenance insources. - Missing concept pages. If several summaries reference an idea that has no concept page, create one and link them.
- Re-run
llmkb lintand confirm it is clean; append a## [YYYY-MM-DD] lint | <scope>line towiki/log.md.
Done when
llmkb lint is error-free and the semantic pass found no unresolved
contradictions, stale claims, or missing concept pages.