knowledge-base/scripts/subagents/wiki-lint-runner.md
Hector 4f95a55c70 chore(wiki): maintenance-system v1.0 (lint script + test suite + subagent templates)
Plan abgestimmt mit k9ert im RamaDama-Topic 2026-06-16.
Detection/Execution-Trennung: scripts/wiki-lint.sh ist mechanisch
(kein LLM), Subagent-Spawn nur für Fixes.

Includes:
- scripts/wiki-lint.sh (v0.1, 360 lines, 8 checks, exit 0/1/2)
- scripts/wiki-lint-test.sh (17 asserts, 3 fixtures, all green)
- scripts/test-fixtures/wiki-lint/{clean,messy,broken}-wiki/
- scripts/subagents/{wiki-lint-runner,frontmatter-migration}.md
- wiki/tasks/maintenance-todo.md (WMT-001..006, WMT-000 done)
- AGENTS.md v1.4 (Maintenance-Section hinzugefügt)
- wiki/log.md (Eintrag)
- scripts/wiki-lint-report.md (erster Lint-Run: 46 Pages, 2 Issues)

Erste Lint-Befunde (siehe Report):
- 12 Wiki-Pages ohne Frontmatter
- 14 Stubs (30% Quote)

Co-Authored-By: Hector <hector-bot@botreasury.local>
2026-06-16 11:39:47 +02:00

1.8 KiB

Subagent: wiki-lint-runner

Trigger: On-demand (wiki-do WMT-001) oder weekly cron (So 04:30 CEST) Output: Lint-Report in scripts/wiki-lint-report.md + Topic-Post Model: n/a (Script) für den Lint, dann ollama/glm-5.1 für die Topic-Zusammenfassung

Aufgabe

  1. Lint-Script ausführen:

    cd /home/node/workspace/knowledge-base
    ./scripts/wiki-lint.sh . scripts/wiki-lint-report.md
    

    Exit-Code 0 = sauber, 1 = Issues gefunden, 2 = Script-Fehler.

  2. Report lesen (scripts/wiki-lint-report.md).

  3. Topic-Post erstellen im RamaDama-Topic. Format:

    ## 🪴 Wiki Lint — <datum>
    
    **Issues: <n>** | Total: <n> Pages
    <Kurze Zusammenfassung der Probleme + Recommended Subagent Spawns>
    
    Voller Report: `scripts/wiki-lint-report.md`
    
  4. Falls Issues: prüfe ob es passende WMT-XXX-ToDos in wiki/tasks/maintenance-todo.md gibt. Wenn nicht, lege neue an.

Constraints

  • KEINE Wiki-Edits
  • KEINE Subagent-Spawns (außer das ToDo existiert schon — dann wiki-do WMT-XXX posten und der Hauptagent spawnt)
  • Script-Output NUR lesen, nicht interpretieren/ändern
  • Report-Post: max 2000 Zeichen

Output

  • Topic-Post im RamaDama-Topic
  • Optional: Hinweis an Hauptagent, dass neue WMT-ToDos angelegt wurden

Commit

Nur falls neue ToDos angelegt wurden:

cd /home/node/workspace/knowledge-base
git add wiki/tasks/maintenance-todo.md
git commit -m "chore(wiki): add WMT-XXX from lint-runner ($(date -I))"
git push origin main
tea push  # falls nötig

Failover

Falls Model-Aufruf fehlschlägt (ollama/glm-5.1):

  1. ollama/minimax-m3
  2. ollama/deepseek-v4-flash:cloud
  3. ollama/glm-5

Bei 3 aufeinanderfolgenden Failures: Topic-Post mit Fehler, dann aufgeben (Hauptagent übernimmt).