knowledge-base/scripts/subagents/stub-killer.md

97 lines
4 KiB
Markdown
Raw Permalink Normal View History

# Subagent: stub-killer
**Trigger:** `wiki-do WMT-003` (on-demand)
**Output:** 11 Stubs erweitert/tagged + Final-Commit + Topic-Report
**Model:** `ollama/minimax-m3` (Fallback: KEIN zai-Retry — bei Fail aufgeben, Pit informiert)
## Input
Lies `wiki/tasks/maintenance-todo.md` WMT-003. Aktuelle Stub-Liste in `scripts/wiki-lint-report.md` Abschnitt "### Stub-Quote". Heuristik aus Topic-Post #6684:
- **7× expand** (10-15 Zeilen hinzufügen, basierend auf `sources` in Frontmatter)
- **4× tag** (`tags: [stub-toleriert]` zu bestehenden Tags addieren, kein Content-Add)
Stand 2026-06-16 12:36:
**Expand:**
- `wiki/concepts/llm/llm-knowledge-base.md` (27 lines)
- `wiki/concepts/agents/ai-agents-2026.md` (29 lines)
- `wiki/tools/openai-gpt.md` (24 lines)
- `wiki/tools/fincept-terminal.md` (29 lines)
- `wiki/architecture/byterover-knowledge-mining.md` (29 lines)
- `wiki/decisions/2026-04-volume-persistence.md` (26 lines)
- `wiki/tools/ecosystem-tools-april-2026.md` (24 lines)
**Tag:**
- `wiki/ideas/2026-04-08_git-auto-commit.md` (28 lines)
- `wiki/ideas/2026-05-28_plur1bus-audit.md` (27 lines)
- `wiki/ideas/2026-05-29_plur1bus-priority-fix.md` (27 lines)
- `wiki/ideas/2026-06-06_plur1bus-priority-fix.md` (29 lines)
## Aufgabe
Pro Expand-File:
1. **Lies** die Page + das/die `sources` raw/-File(s)
2. **Identifiziere** was fehlt: weitere Sektionen, Beispiele, Cross-Refs, Hintergrund, Entscheidungs-Begründung
3. **Schreibe 10-15 zusätzliche Zeilen** am Ende der Page (vor dem Frontmatter-Bereich — Frontmatter bleibt oben). Inhaltlich konsistent mit der Source, keine Fabrikation. Wenn die Source nichts hergibt, schreib eine "## Kontext" / "## Notes"-Sektion mit den vorhandenen Infos.
4. **Update Frontmatter `updated`** auf 2026-06-16 (Tagesdatum)
5. **Commit einzeln** mit Message: `content(wiki): expand stub {filename} (+{n} lines)`
Pro Tag-File:
1. **Lies** Frontmatter
2. **Update Frontmatter:** addiere `stub-toleriert` zu `tags: [...]`, setze `updated: 2026-06-16`
3. **Commit** mit Message: `lint(wiki): tag stub-toleriert on {filename}`
## WICHTIGE CONSTRAINTS
- **KEINE inhaltlichen Änderungen am bestehenden Body** (nur ADD am Ende, nicht umschreiben)
- **KEINE rohen Dateien** (`raw/`) anfassen
- **KEINE Meta-Files** (index.md, log.md, ideas.md, maintenance-todo.md)
- **NICHT erfinden:** Wenn die Source nichts zum Expanden hergibt, dann expandiere mit "## Related Work" + Cross-References zu existierenden Wiki-Pages, nicht mit Fabrikation
- **Sub-Tag `stub-toleriert`** darf das Wiki-Lint-Script in Zukunft ignorieren? **Nein**, das Lint-Script kennt das Tag noch nicht. Erstmal nur Markierung, Threshold-Anpassung kommt später (WMT-007 oder so)
- Nach dem Expand sollte die File ≥35 Zeilen haben (sicher über 30-Schwelle)
## Final-Commit (ToDo-Update)
```bash
cd /home/node/workspace/knowledge-base
# Editiere wiki/tasks/maintenance-todo.md:
# - Verschiebe WMT-003 von "ToDo" → "Done" mit Datum 2026-06-16 und Commit-Hashes
# - Setze Status von "in-progress" zurück auf (leer)
git add wiki/tasks/maintenance-todo.md
git commit -m "chore(wiki): mark WMT-003 done (11 stubs resolved, $(date -I))"
git push origin main
```
## Topic-Report
Im RamaDama-Topic (target=-1003839640481, message_thread_id=6169) posten:
```
## 🪴 WMT-003 done — Stub-Killer
- **<n>** Stubs erweitert (7 expand + 4 tag-only)
- Commits: <Hashes>
- Lint-Verify: <neue Stub-Quote>
- Rest: 0
- Nächste: WMT-004 (Dup-Cluster Hub-Pages) bereit zum `wiki-do`
```
## Model-Failover
Du läufst auf `ollama/minimax-m3`. Bei Failover-Fehler: Topic-Post mit Fehler-Beschreibung, dann aufgeben. KEIN weiterer Fallback-Versuch — wir warten auf zai-Credits.
## Verification
Nach allen Commits Lint laufen lassen:
```bash
cd /home/node/workspace/knowledge-base
./scripts/wiki-lint.sh . scripts/wiki-lint-report.md
```
Stub-Quote sollte von 11/47 (23%) auf 4/47 (9%) sinken (4 ideas/Pages werden mit `stub-toleriert` markiert, aber das Lint-Script zählt sie weiterhin — Threshold-Senkung kommt später). Lint-Issues sollten 0 bleiben (oder nur 1-2 hinzukommen durch zwischenzeitliche Ingest-Commits).