Files

T

Philipp Sieder 3479384600 refactor(router): slim klarheit-mit-idea2self to routing pattern

Rewrite SKILL.md to be a pure router per workflow-skill design rules:

- description: trigger conditions only (AP-20). Entry triggers + explicit
  anti-triggers naming each i2s-* sub-skill.
- 3 numbered phases (intent / precondition / hand-off) with entry/exit
  criteria (AP-6, AP-7).
- Routing pattern with 8 paths: 7 hand-offs to i2s-* sub-skills + 1
  cross-cut workflow (review-iterate) kept internal.
- Reference set reduced to router-essentials: routing-table.md (new),
  kommunikationsregeln.md, artefakt-pipeline.md.
- Tools narrowed to read/write/edit/glob/grep/ask/todo.

Add references/routing-table.md with trigger -> sub-skill mapping,
precondition rules, hand-off message format, sequence diagram, and
anti-trigger guards.

Vestigial refs (methodik.md, export-formate.md, recherche-regeln.md)
and templates/prototyp-remixer-auswertung.md remain in router for now;
they will be removed in step 10b after sub-skill extraction so any
inter-step git mv preserves rename detection.

Step 3 of i2s-skill-split refactor.

2026-05-19 01:10:07 +02:00

3.6 KiB

Raw Blame History

Routing Table — klarheit-mit-idea2self

Maps user-intent trigger phrases to the responsible Sub-Skill or to the router's internal review workflow. Used in Phase 1 (intent recognition) and Phase 2 (precondition check) of the router.

Trigger -> Sub-Skill -> Precondition

Routing path	Trigger phrases (German + indirect)	Target	Precondition section in idea2self-file
1	"neue Idee", "starten", "Idea2Self starten", "Idee strukturieren", "Discovery", "ich habe da eine Idee", "ich will was ausprobieren"	`i2s-discovery`	none — entry point
2	"Problem-Statement", "HMW formulieren", "Problem formulieren", "Wie koennen wir ..."	`i2s-problem-statement`	`## Idee`
3	"Persona", "Zielgruppe", "Wer ist die Zielgruppe", "JTBD", "Verhaltensbasierte Persona"	`i2s-persona`	`## Problem-Statement`
4	"Recherche", "Problemraum recherchieren", "Web-Recherche zur Idee", "Marktrecherche", "Interview-Orte"	`i2s-recherche`	`## Problem-Statement` + `## Persona`
5	"Experiment", "Hypothese", "Experiment-Card", "MVE-Design", "Minimum Viable Experiment"	`i2s-experiment-card`	`## Recherche-Report`
6	"Prototyp", "Prototyp-Konzept", "Loesungsidee", "Ideen-Werkstatt", "User Flow"	`i2s-prototyp-konzept`	`## Experiment-Card`
7	"Action-Plan", "WOOP", "Umsetzungsplan", "naechste Schritte", "Obstacle-Plan"	`i2s-action-plan`	`## Prototyp-Konzept`
8	"ueberarbeiten", "iterieren", "review", "Konsistenz-Check", "neuer Input", "Erkenntnisse einarbeiten"	`workflows/review-iterate.md` (router-internal)	any existing idea2self-Datei

Precondition check rules

Lade die idea2self-Datei (Pfad steht meist im Nutzer-Prompt oder ist Standardpfad ./idea2self-<idee>.md im aktuellen Verzeichnis).
Pruefe per Markdown-Heading-Match (^## <Sektionsname>), ob die Precondition-Sektion existiert UND nicht leer ist.
Vorbedingung erfuellt -> Hand-off ausfuehren (Phase 3).
Vorbedingung fehlt -> Nutzer informieren:
- Form: "Voraussetzung ## <Sektion> fehlt in idea2self-<idee>.md. Trigger zuerst <voraussetzungs-skill> oder bestaetige, dass du die Info anderweitig vorhaeltst."
- Falls Nutzer bestaetigt -> trotzdem Hand-off, Sub-Skill wird die Info via Dialog erfragen.

Hand-off message format (paths 1-7)

Nach Phase 2 (Vorbedingung OK):

Naechster Schritt: <Sub-Skill-Name>.
Trigger-Phrase: "<eine der Trigger-Phrasen aus Spalte 2>".
Vorhandene Sektionen in idea2self-Datei: <Liste>.

Nach Abschluss kannst du mit "Weiter" zum naechsten Sub-Skill in der Sequenz wechseln.

Beispiel:

Naechster Schritt: i2s-persona.
Trigger-Phrase: "Persona erstellen".
Vorhandene Sektionen in idea2self-Datei: ## Idee, ## Problem-Statement.

Sequence recommendation (default flow)

1. i2s-discovery
   |
   v
2. i2s-problem-statement
   |
   v
3. i2s-persona
   |
   v
4. i2s-recherche
   |
   v
5. i2s-experiment-card
   |
   v
6. i2s-prototyp-konzept
   |
   v
7. i2s-action-plan

Schritt 8 (review-iterate) lebt im Router und kann zu jedem Zeitpunkt aufgerufen werden — z.B. nach Schritt 4 wenn die Recherche Erkenntnisse fuer das Problem-Statement liefert (Rueckwaerts-Update).

Anti-trigger guards

Falls der Nutzer eine Trigger-Phrase aus Spalte 2 ohne Router-Aktivierung sagt (z.B. direkt "Persona erstellen"), aktiviert sich der jeweilige Sub-Skill von selbst per eigener description:. Der Router bleibt aus. Das ist by design.

Falls Trigger zweifelhaft (z.B. "Idee strukturieren" matcht Router-Pfad 1 UND koennte als Sub-Skill-Trigger gelesen werden): Router gewinnt, Sub-Skill bleibt aus. Trigger-Specificity ist in der description: jedes Skills entsprechend kalibriert.

3.6 KiB Raw Blame History