lit-lintlisted

# Lit-Lint ## Core Rule Lint **reports; it does not repair by inventing.** It surfaces where the vault has drifted — orphans, broken links, claims without locators, quotes without page numbers — and names the fix, but it never closes a gap by fabricating the missing piece. A summary missing a locator gets flagged, not given a guessed page number. A `.bib` key with no summary gets flagged, not given an imagined one. This is a read-only, advisory pass: it never modifies `sources/` and never silently auto-edits the vault. The output is a worklist for the author or for `/lit-ingest` to act on, not a set of edits. ## When to Use Invoke with `/lit-lint` when: - After a batch of `/lit-ingest` runs, to catch what slipped (orphans, missing locators). - Before `/literature-review`, so the synthesis draws on a clean, consistent vault. - Periodically, to find cross-source contradictions worth resolving before they reach the draft. - After editing `references.bib` by hand, to re-check summary ↔ `.bib` alignment. Read-only by default. With an explicit `--fix` argument it may propose (still not auto-apply) mechanical repairs like adding a missing `[[wikilink]]` stub — but never a fabricated locator, quote, finding, or DOI. ## Process ### Phase 1 — Inventory Build the picture before judging it: 1. Read `VAULT.md` (the schema the vault must conform to). 2. List `vault/summaries/*.md`, the keys in `references.bib`, and every page under `vault/concepts/` and `vault/entities/`. 3.