knowledge-base/scripts/subagents/stub-killer.md
Hector 15dcf6428b chore(wiki): WMT-003 in-progress + stub-killer template
11 Stubs identifiziert (vorher 14, durch WMT-002 Frontmatter auf 11 gesunken).
Analyse in Topic-Post #6684: 7x expand, 4x tag-update (stub-toleriert fuer
junge Subconscious-Ideen).

Failover-Kette aktualisiert: Primary ollama/minimax-m3 (lokal), kein zai-
Fallback mehr (Billing-Error am 2026-06-16, siehe #6675).

Co-Authored-By: Hector <hector-bot@botreasury.local>
2026-06-16 12:38:12 +02:00

96 lines
4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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).