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

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)

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:

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