Second Brain, Lint

Health-check the wiki and report issues with actionable fixes.

Audit Steps

Run all checks below, then present a consolidated report.

1. Broken wikilinks

Scan all wiki pages for [[wikilink]] references. For each link, verify the target page exists. Report any broken links.

# Find all wikilinks across wiki pages
grep -roh '\[\[[^]]*\]\]' wiki/ | sort -u

Cross-reference against actual files in wiki/.

2. Orphan pages

Find pages with no inbound links, no other page references them via [[wikilink]].

For each .md file in wiki/sources/, wiki/entities/, wiki/concepts/, wiki/synthesis/:

• Extract the page name (filename without extension)
• Search all other wiki pages for [[Page Name]]
• If no other page links to it, it's an orphan

3. Contradictions

Read pages that share entities or concepts and look for conflicting claims. Flag when:

• Two source summaries make opposing claims about the same topic
• An entity page contains information that conflicts with a source summary
• Dates, figures, or factual claims differ between pages

4. Stale claims

Cross-reference source dates with wiki content. Flag when:

• A concept page cites only old sources and newer sources exist on the same topic
• Entity information hasn't been updated despite newer sources mentioning that entity

5. Missing pages

Scan for [[wikilinks]] that point to pages that don't exist yet. These are topics the wiki mentions but hasn't given their own page. Assess whether they warrant a page.

6. Missing cross-references

Find pages that discuss the same topics but don't link to each other. Look for:

• Entity pages that mention concepts without linking them
• Concept pages that mention entities without linking them
• Source summaries that cover the same topic but don't reference each other

7. Index consistency