knowledge-base/scripts/subagents/frontmatter-migration.md

71 lines
2.3 KiB
Markdown
Raw Permalink Normal View 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:
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.