diff --git a/scripts/subagents/stub-killer.md b/scripts/subagents/stub-killer.md new file mode 100644 index 0000000..0e941c4 --- /dev/null +++ b/scripts/subagents/stub-killer.md @@ -0,0 +1,96 @@ +# 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 + +- **** Stubs erweitert (7 expand + 4 tag-only) +- Commits: +- Lint-Verify: +- 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). diff --git a/wiki/tasks/maintenance-todo.md b/wiki/tasks/maintenance-todo.md index 9bfc151..6eef75b 100644 --- a/wiki/tasks/maintenance-todo.md +++ b/wiki/tasks/maintenance-todo.md @@ -18,11 +18,12 @@ - Lint-Verify: `./scripts/wiki-lint.sh` → `Total: 47 | Issues: 0` (Frontmatter-Check ✅ 0 missing) - Retry 2: ollama/minimax-m3 (Retry 1 auf ollama/glm-5.1 scheiterte an zai-billing-error) -- [ ] **WMT-003** — 14 Stubs analysieren (füllen oder killen) - - Category: content | Effort: L | Status: planning - - Subagent: `scripts/subagents/stub-killer.md` - - Files: 14 (siehe `output/test-lint-output.md` → Stub-Quote-Sektion) - - Strategie: pro Stub entscheiden — kurze Meta-Files ergänzen, inhaltlich dünne killen, konzeptuell wichtige expandieren. +- [ ] **WMT-003** — 11 Stubs analysieren (füllen oder killen) + - Category: content | Effort: L | Status: **in-progress** (gestartet 2026-06-16 12:36, Subagent-Spawn ausgelöst durch k9ert "go" in #6679) + - Subagent: `scripts/subagents/stub-killer.md` (neu geschrieben 2026-06-16 12:36) + - Files: 11 (siehe `scripts/wiki-lint-report.md` → Stub-Quote-Sektion; vorher 14, durch WMT-002 Frontmatter auf 11 gesunken) + - Strategie: 7× expand (10-15 Zeilen aus `sources`) + 4× tag-update (`stub-toleriert` für junge Subconscious-Ideen). Analyse: Topic-Post #6684. + - **Failover-Kette aktualisiert (2026-06-16):** Primary `ollama/minimax-m3` (lokal, kein zai-Billing), KEIN zai-Fallback mehr — bei Fail Topic-Post, dann aufgeben. - [ ] **WMT-004** — Dup-Topic-Cluster auflösen (Hub-Pages) - Category: structure | Effort: M | Status: planning @@ -44,7 +45,9 @@ ## In Progress -*(leer)* +- [ ] **WMT-003** — 11 Stubs analysieren (füllen oder killen) | content | L | Subagent läuft + - Strategie: 7× expand + 4× tag-update (`stub-toleriert`). + - Template: `scripts/subagents/stub-killer.md` (neu) --- @@ -73,7 +76,7 @@ wiki-do WMT-002 | `wiki-lint-weekly` | So 04:30 CEST | Lint-Script ausführen, Report in Topic posten | n/a (Shell) | | `wiki-weekly-summary` | So 19:00 CEST | Wartungszusammenfassung inkl. Wiki-Status | ollama/glm-5.1 | -Subagent-Failover: `ollama/glm-5.1 → ollama/minimax-m3 → ollama/deepseek-v4-flash:cloud → ollama/glm-5` +Subagent-Failover (2026-06-16): Primary `ollama/minimax-m3` (lokal), KEIN zai-Fallback — zai-Billing-Error (siehe #6675). Bei Fail Topic-Post, dann aufgeben. ### Workflow für Subagents