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:40 +02:00
|
|
|
# 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
|
2026-06-17 15:26:54 +02:00
|
|
|
**Model:** n/a (Script) für den Lint, dann `ollama/minimax-m3` für die Topic-Zusammenfassung
|
|
|
|
|
**Lint-Script-Version:** v1.0 (2026-06-17, SCRIPT_VERSION-Variable im Header)
|
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:40 +02:00
|
|
|
|
|
|
|
|
## Aufgabe
|
|
|
|
|
|
|
|
|
|
1. **Lint-Script ausführen:**
|
|
|
|
|
```bash
|
|
|
|
|
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:
|
|
|
|
|
```bash
|
|
|
|
|
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
|
|
|
|
|
|
2026-06-17 15:26:54 +02:00
|
|
|
Falls Model-Aufruf fehlschlägt (`ollama/minimax-m3`):
|
|
|
|
|
1. `ollama/deepseek-v4-flash:cloud`
|
|
|
|
|
2. `ollama/glm-5`
|
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:40 +02:00
|
|
|
|
2026-06-17 15:26:54 +02:00
|
|
|
**Wichtig:** `ollama/glm-5.1` ist seit 2026-06-16 von zai-Billing-Errors blockiert — **nicht** als Primary einsetzen.
|
|
|
|
|
|
|
|
|
|
Bei 2 aufeinanderfolgenden Failures: Topic-Post mit Fehler, dann aufgeben (Hauptagent übernimmt).
|