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

2.3 KiB

Raw Blame History

Subagent: frontmatter-migration

Trigger: wiki-do WMT-002 (on-demand) Output: 12 Wiki-Pages mit Frontmatter + Final-Commit + Topic-Report Model: ollama/glm-5.1 (Fallbacks: ollama/minimax-m3 → ollama/deepseek-v4-flash:cloud → ollama/glm-5)

Input

Lese wiki/tasks/maintenance-todo.md WMT-002. Files-Liste steht dort. Zusätzlich: output/test-lint-output.md hat die aktuelle Missing-Liste (kann sich aber zwischenzeitlich geändert haben — selbst re-linten oder Hauptagent fragen).

Aufgabe

Pro File aus der Missing-Liste:

Lies die Wiki-Page komplett
Erkunde den Inhalt kurz (Titel? Konzept-Typ? Quellen die referenziert werden?)

Erstelle minimales Frontmatter nach AGENTS.md-Schema. Für Fakten-Seiten:

---
created: <heute>
updated: <heute>
sources: [<liste der raw/-Files die in der Page referenziert werden>]
tags: [<2-4 passende tags>]
---

Schreibe das Frontmatter an den Anfang der Page (vor dem bestehenden Inhalt)
Commit einzeln mit Schema lint(wiki): add missing frontmatter to <path>
Push nach jedem Commit (oder am Ende gesammelt — egal, aber konsistent)

Wichtig: KEINE inhaltlichen Änderungen. Nur Frontmatter. Wenn du unsicher bist, welche sources oder tags, dann minimal halten: sources: [] + tags: [unclassified] ist OK, der Hauptagent reviewed später.

Final-Commit

Nach allen Frontmatter-Commits:

cd /home/node/workspace/knowledge-base
# 1. maintenance-todo.md updaten
# Verschiebe WMT-002 von "ToDo" → "Done" mit Datum + Liste der Commits
# 2. Commit + push
git add wiki/tasks/maintenance-todo.md
git commit -m "chore(wiki): mark WMT-002 done ($(date -I))"
git push origin main

Topic-Report

Im RamaDama-Topic posten:

## 🪴 WMT-002 done — Frontmatter-Migration

- **<n>** Pages ergänzt
- Commits: <kurze Liste>
- Rest: 0
- Nächste: WMT-003 (Stub-Killer) bereit zum `wiki-do`

Constraints

NICHT in raw/-Files schreiben
NICHT den Inhalt der Pages ändern
NICHT die Reihenfolge der Sektionen in den Pages ändern
NICHT mehrere Pages in einen Commit packen
Bei Unsicherheit: skip + in Topic-Report vermerken

Failover

ollama/glm-5.1 → ollama/minimax-m3 → ollama/deepseek-v4-flash:cloud → ollama/glm-5

Bei Model-Failure: Topic-Post mit Fehler, dann aufgeben.

2.3 KiB Raw Blame History