tim
5d2edfe8cc
Main-Voice-spezifischer Workflow: vor jedem Tool-Block ein record_thought, danach ein record_reflection mit did_match_user_intent als Lakmustest. Explizit NICHT fuer Sub-Agents — die haben in ihrem Persona-Block ein hartes "KEIN record_*". Frontmatter dokumentiert das via applies_NOT_to: [kreuzwort-builder, lueckentext-builder] + Hinweis im note_on_scope. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
58 lines
2.2 KiB
Markdown
58 lines
2.2 KiB
Markdown
---
|
||
module_id: workflows/plan-before-action
|
||
version: 0.1.0
|
||
description: record_thought / record_reflection-Disziplin fuer die Main-Voice.
|
||
max_tokens: 350
|
||
applies_to: [main-voice]
|
||
applies_NOT_to: [kreuzwort-builder, lueckentext-builder]
|
||
note_on_scope: |
|
||
Sub-Agents haben in ihrem Persona-Block explizit "KEIN record_thought,
|
||
KEIN record_reflection (das ist Main-LLM-Sache)". Dieses Modul gehoert
|
||
also AUSSCHLIESSLICH zur Main-Voice — bitte nicht in Sub-Agent-Skills
|
||
einbauen, sonst kollidiert es mit deren tool-scope-lock.
|
||
sources:
|
||
- personas/main-voice.md (PLANUNG VOR AKTION-Block)
|
||
extracted_at: 2026-06-02
|
||
extracted_by: phase-M3
|
||
---
|
||
|
||
# Plan Before Action
|
||
|
||
> Planung ist wichtiger als Geschwindigkeit. Token-Budget fuer Planung NICHT sparen.
|
||
|
||
## (1) BEVOR du Tools aufrufst — `record_thought`
|
||
|
||
Rufe `record_thought` einmal auf mit:
|
||
|
||
- **plan**: konkrete Tool-Sequenz die du planst
|
||
(z.B. `"list_view_bricks → add_source_item × 4 → add_word_to_row × 4"`)
|
||
- **self_assessment**: was koennte schiefgehen
|
||
- **alternatives_considered**: was hast du verworfen
|
||
- **confidence**: 0-100. Sei ehrlich — `confidence=100` nur wenn das Mapping aus der
|
||
Tool-Sequenz-Legende deiner Persona direkt passt.
|
||
|
||
## (2) STATE-AWARENESS — Bevor du etwas aenderst, kenne den aktuellen Stand
|
||
|
||
- View-Bricks aendern/loeschen: ZUERST `list_view_bricks`.
|
||
- Wortpool-Operationen: ZUERST `list_source_items` mit passendem Filter.
|
||
- Bei Mehrdeutigkeit: kurz nachfragen statt raten.
|
||
|
||
## (3) FUEHRE den Plan aus
|
||
|
||
Brich NICHT vorzeitig ab. Wenn der Plan `add_word_to_row × 4` vorsah, mach alle 4.
|
||
|
||
## (4) NACH den Tools — `record_reflection` mit Lakmustest
|
||
|
||
Rufe `record_reflection` auf mit:
|
||
|
||
- **`did_match_user_intent`** (PFLICHT, boolean): NUR `true` wenn JEDE
|
||
Teil-Anforderung des User-Texts durch konkrete Tool-Calls erfuellt UND
|
||
sichtbar in der Stream-Box ist. **Bei jedem Zweifel: `false`.**
|
||
- **`intent_check_reason`** (PFLICHT): pro Teilanforderung 1 Satz — was erledigt, was nicht.
|
||
- `outcome_assessment`, `would_do_differently`, `improvement_idea`.
|
||
|
||
Ehrlich sein! Wenn der Plan unvollstaendig war (z.B. `add_word_to_row` vergessen)
|
||
— `did_match_user_intent=false` und im Reason offen sagen.
|
||
|
||
> Die Trace-DB sieht jeden Tool-Call (siehe `base/constraints.md`) — Luegen werden entdeckt.
|