Prompt file imported from IvanKRZ/LLM-Wiki-Template (.claude/commands/lint.md). Copyright stays with the author.

/lint

Name: lint
Author: IvanKRZ

WRITE-MODEL

Agent writes the wiki, human curates the raw sources.

/lint schreibt NUR in wiki/lint-reports/ und wiki/log.md.
Keine automatischen Fixes in anderen Wiki-Pages.
User entscheidet pro Item, was zu tun ist.

Ablauf

Scanne wiki/ vollständig. Erzeuge Report in wiki/lint-reports/YYYY-MM-DD.md.

Check 1: Contradictions

grep -r "## Contradictions" wiki/ --include="*.md" -l

Für jede gefundene Page: Section-Inhalt lesen und im Report dokumentieren.

Check 2: Orphans

Für jede Page in wiki/ (außer index.md und log.md):

grep -r "[[PageName]]" wiki/ --include="*.md" | grep -v "^wiki/index.md"

Pages ohne inbound Links → Orphan.

Check 3: Stubs

Für jede Page: Body-Text-Wörter zählen (ohne Frontmatter, ohne Headings). Pages < 50 Wörter → Stub.

Check 4: Missing Concepts

Extrahiere alle Terme, die in ≥3 Pages vorkommen, aber keine eigene wiki/concepts/-Page haben.

# Pseudo-Logik: grep häufiger Terme, abgleichen gegen wiki/concepts/

Check 5: Stale Claims

Pages ohne evergreen: true in Frontmatter, deren verlinkte Sources älter als 180 Tage sind. Datum aus ingested_at Frontmatter der Source-Pages auslesen.

Check 6: Broken Links

Alle [[...]]-Links in wiki/ extrahieren. Prüfen ob Ziel-File existiert.

grep -ro "\[\[.*\]\]" wiki/ | sed 's/.*\[\[//;s/\]\].*//'

Check 7: Index-Drift

Pages in wiki/ aber nicht in wiki/index.md → fehlende Einträge.
Einträge in wiki/index.md aber kein entsprechendes File → tote Links.

Report-Format

# Lint Report — YYYY-MM-DD

## Summary
- Contradictions: N
- Orphans: N
- Stubs: N
- Missing Concepts: N
- Stale Claims: N
- Broken Links: N
- Index-Drift: N

## Contradictions
- [[page]] ↔ [[page2]] — Claim X

## Orphans
- [[entities/X]] — keine inbound links

## Stubs
- [[concepts/y]] — 23 Wörter

## Missing Concepts
- "Begriff" — erwähnt in [[p1]], [[p2]], [[p3]]

## Stale Claims
- [[sources/old-source]] — ingested 2025-06-01, kein evergreen

## Broken Links
- [[entities/ghost]] — referenziert in [[sources/x]], File existiert nicht

## Index-Drift
- In wiki/, nicht im Index: [[concepts/z]]
- Im Index, kein File: [[entities/deleted]]

## Recommended Actions
- Fix Contradiction in [[page]]: re-ingest [[sources/a]] mit neuem Fokus
- Delete Orphan [[entities/X]] oder verlinken
- Expand Stub [[concepts/y]]
- Create Concept-Page für "Begriff"

Log-Entry

## [YYYY-MM-DD HH:MM] lint | <N> issues found

- Report: [[lint-reports/YYYY-MM-DD]]
- Critical: <Contradictions-Count> contradictions, <Broken-Links-Count> broken links

# /lint ## WRITE-MODEL Agent writes the wiki, human curates the raw sources. - `/lint` schreibt NUR in `wiki/lint-reports/` und `wiki/log.md`. - Keine automatischen Fixes in anderen Wiki-Pages. - User entscheidet pro Item, was zu tun ist. ## Ablauf Scanne `wiki/` vollständig. Erzeuge Report in `wiki/lint-reports/YYYY-MM-DD.md`. ### Check 1: Contradictions ```bash grep -r "## Contradictions" wiki/ --include="*.md" -l ``` Für jede gefundene Page: Section-Inhalt lesen und im Report dokumentieren. ### Check 2: Orphans Für jede Page in `wiki/` (außer `index.md` und `log.md`): ```bash grep -r "[[PageName]]" wiki/ --include="*.md" | grep -v "^wiki/index.md" ``` Pages ohne inbound Links → Orphan. ### Check 3: Stubs Für jede Page: Body-Text-Wörter zählen (ohne Frontmatter, ohne Headings). Pages < 50 Wörter → Stub. ### Check 4: Missing Concepts Extrahiere alle Terme, die in ≥3 Pages vorkommen, aber keine eigene `wiki/concepts/`-Page haben. ```bash # Pseudo-Logik: grep häufiger Terme, abgleichen gegen wiki/concepts/ ``` ### Check 5: Stale Claims Pages ohne `evergreen: true` in Frontmatter, deren verlinkte Sources älter als 180 Tage sind. Datum aus `ingested_at` Frontmatter der Source-Pages auslesen. ### Check 6: Broken Links Alle `[[...]]`-Links in `wiki/` extrahieren. Prüfen ob Ziel-File existiert. ```bash grep -ro "\[\[.*\]\]" wiki/ | sed 's/.*\[\[//;s/\]\].*//' ``` ### Check 7: Index-Drift - Pages in `wiki/` aber nicht in `wiki/index.md` → fehlende Einträge. - Einträge in `wiki/index.md` aber kein entsprechendes File → tote Links. ## Report-Format ```markdown # Lint Report — YYYY-MM-DD ## Summary - Contradictions: N - Orphans: N - Stubs: N - Missing Concepts: N - Stale Claims: N - Broken Links: N - Index-Drift: N ## Contradictions - [[page]] ↔ [[page2]] — Claim X ## Orphans - [[entities/X]] — keine inbound links ## Stubs - [[concepts/y]] — 23 Wörter ## Missing Concepts - "Begriff" — erwähnt in [[p1]], [[p2]], [[p3]] ## Stale Claims - [[sources/old-source]] — ingested 2025-06-01, kein evergreen ## Broken Links - [[entities/ghost]] — referenziert in [[sources/x]], File existiert nicht ## Index-Drift - In wiki/, nicht im Index: [[concepts/z]] - Im Index, kein File: [[entities/deleted]] ## Recommended Actions - Fix Contradiction in [[page]]: re-ingest [[sources/a]] mit neuem Fokus - Delete Orphan [[entities/X]] oder verlinken - Expand Stub [[concepts/y]] - Create Concept-Page für "Begriff" ``` ## Log-Entry ``` ## [YYYY-MM-DD HH:MM] lint | <N> issues found - Report: [[lint-reports/YYYY-MM-DD]] - Critical: <Contradictions-Count> contradictions, <Broken-Links-Count> broken links ```

{ "prompt": "# /lint\n\n## WRITE-MODEL\nAgent writes the wiki, human curates the raw sources.\n- `/lint` schreibt NUR in `wiki/lint-reports/` und `wiki/log.md`.\n- Keine automatischen Fixes in anderen Wiki-Pages.\n- User entscheidet pro Item, was zu tun ist.\n\n## Ablauf\n\nScanne `wiki/` vollständig. Erzeuge Report in `wiki/lint-reports/YYYY-MM-DD.md`.\n\n### Check 1: Contradictions\n```bash\ngrep -r \"## Contradictions\" wiki/ --include=\"*.md\" -l\n```\nFür jede gefundene Page: Section-Inhalt lesen und im Report dokumentieren.\n\n### Check 2: Orphans\nFür jede Page in `wiki/` (außer `index.md` und `log.md`):\n```bash\ngrep -r \"[[PageName]]\" wiki/ --include=\"*.md\" | grep -v \"^wiki/index.md\"\n```\nPages ohne inbound Links → Orphan.\n\n### Check 3: Stubs\nFür jede Page: Body-Text-Wörter zählen (ohne Frontmatter, ohne Headings).\nPages < 50 Wörter → Stub.\n\n### Check 4: Missing Concepts\nExtrahiere alle Terme, die in ≥3 Pages vorkommen, aber keine eigene `wiki/concepts/`-Page haben.\n```bash\n# Pseudo-Logik: grep häufiger Terme, abgleichen gegen wiki/concepts/\n```\n\n### Check 5: Stale Claims\nPages ohne `evergreen: true` in Frontmatter, deren verlinkte Sources älter als 180 Tage sind.\nDatum aus `ingested_at` Frontmatter der Source-Pages auslesen.\n\n### Check 6: Broken Links\nAlle `[[...]]`-Links in `wiki/` extrahieren. Prüfen ob Ziel-File existiert.\n```bash\ngrep -ro \"\\[\\[.*\\]\\]\" wiki/ | sed 's/.*\\[\\[//;s/\\]\\].*//'\n```\n\n### Check 7: Index-Drift\n- Pages in `wiki/` aber nicht in `wiki/index.md` → fehlende Einträge.\n- Einträge in `wiki/index.md` aber kein entsprechendes File → tote Links.\n\n## Report-Format\n\n```markdown\n# Lint Report — YYYY-MM-DD\n\n## Summary\n- Contradictions: N\n- Orphans: N\n- Stubs: N\n- Missing Concepts: N\n- Stale Claims: N\n- Broken Links: N\n- Index-Drift: N\n\n## Contradictions\n- [[page]] ↔ [[page2]] — Claim X\n\n## Orphans\n- [[entities/X]] — keine inbound links\n\n## Stubs\n- [[concepts/y]] — 23 Wörter\n\n## Missing Concepts\n- \"Begriff\" — erwähnt in [[p1]], [[p2]], [[p3]]\n\n## Stale Claims\n- [[sources/old-source]] — ingested 2025-06-01, kein evergreen\n\n## Broken Links\n- [[entities/ghost]] — referenziert in [[sources/x]], File existiert nicht\n\n## Index-Drift\n- In wiki/, nicht im Index: [[concepts/z]]\n- Im Index, kein File: [[entities/deleted]]\n\n## Recommended Actions\n- Fix Contradiction in [[page]]: re-ingest [[sources/a]] mit neuem Fokus\n- Delete Orphan [[entities/X]] oder verlinken\n- Expand Stub [[concepts/y]]\n- Create Concept-Page für \"Begriff\"\n```\n\n## Log-Entry\n\n```\n## [YYYY-MM-DD HH:MM] lint | <N> issues found\n\n- Report: [[lint-reports/YYYY-MM-DD]]\n- Critical: <Contradictions-Count> contradictions, <Broken-Links-Count> broken links\n```", "variables": [], "notes": "Periodischer Health-Check des gesamten Wiki. Findet Contradictions, Orphans, Stubs, Missing Concepts, Stale Claims, Broken Links, Index-Drift. Keine automatischen Fixes. Tools: Read, Write(wiki/lint-reports/**), Write(wiki/log.md), Glob, Grep, Bash.", "metadata": { "source": { "provider": "github-claude-commands", "repository": "https://github.com/IvanKRZ/LLM-Wiki-Template", "path": ".claude/commands/lint.md", "ref": "398651f5bb2c3511c40c561e7d7ec733a9c27559", "url": "https://github.com/IvanKRZ/LLM-Wiki-Template/blob/398651f5bb2c3511c40c561e7d7ec733a9c27559/.claude/commands/lint.md", "key": "IvanKRZ/LLM-Wiki-Template/.claude/commands/lint.md" } } }

lint

About