knowledge-base/scripts/subagents/frontmatter-migration.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

70 lines
2.3 KiB
Markdown

# 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:
1. **Lies** die Wiki-Page komplett
2. **Erkunde** den Inhalt kurz (Titel? Konzept-Typ? Quellen die referenziert werden?)
3. **Erstelle** minimales Frontmatter nach `AGENTS.md`-Schema. Für Fakten-Seiten:
```yaml
---
created: <heute>
updated: <heute>
sources: [<liste der raw/-Files die in der Page referenziert werden>]
tags: [<2-4 passende tags>]
---
```
4. **Schreibe** das Frontmatter an den Anfang der Page (vor dem bestehenden Inhalt)
5. **Commit einzeln** mit Schema `lint(wiki): add missing frontmatter to <path>`
6. **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:
```bash
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.