From 3479384600f1bbbc0f434aa913a205d6bbf2a148 Mon Sep 17 00:00:00 2001 From: Philipp Sieder <12394266+philippsied@users.noreply.github.com> Date: Tue, 19 May 2026 01:10:07 +0200 Subject: [PATCH] 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. --- skills/klarheit-mit-idea2self/SKILL.md | 219 +++++++++--------- .../references/routing-table.md | 77 ++++++ 2 files changed, 191 insertions(+), 105 deletions(-) create mode 100644 skills/klarheit-mit-idea2self/references/routing-table.md diff --git a/skills/klarheit-mit-idea2self/SKILL.md b/skills/klarheit-mit-idea2self/SKILL.md index dfa6236..8f29ac0 100644 --- a/skills/klarheit-mit-idea2self/SKILL.md +++ b/skills/klarheit-mit-idea2self/SKILL.md @@ -1,128 +1,137 @@ --- name: klarheit-mit-idea2self -description: "Strukturiert vage Ideen zu validierbaren Konzepten mit Action-Plan. Erzeugt iterativ Problem-Statement, Persona, Recherche-Report, Experiment-Card, Prototyp-Konzept und Action-Plan (WOOP) in einer zentralen idea2self-Datei. Wird ausgelöst bei Idee verwirklichen, Idee umsetzen, Klarheit zur Idee, Umsetzungsschwierigkeiten bei Idee, Idea2Self Sprint, Idea2Self Launchpad durchführen, Idea2Self Facilitator ausführen, Idea2Self Coaching, coach mich bei Umsetzung meiner Idee, Idee strukturieren, Geschäftsidee entwickeln, Problem-Statement, Persona erstellen, Experiment planen, Prototyp-Konzept, Action-Plan, Idee validieren, Nebenprojekt starten, Gründungsidee. Auch bei indirekten Formulierungen wie ich habe da eine Idee, ich will was ausprobieren, ich komme nicht weiter mit meiner Idee, ich schaffe es nicht anzufangen. Sprache: Deutsch." +description: "Idea2Self Facilitator-Router. Entry-Point fuer den Idea2Self-Prozess: vage Idee zu Action-Plan + WOOP. Loest aus bei 'Ich habe eine Idee', 'Idea2Self starten', 'Idea2Self Sprint', 'Idea2Self Launchpad durchfuehren', 'Idea2Self Coaching', 'Klarheit zur Idee', 'Coach mich bei Umsetzung meiner Idee', 'Idee strukturieren', 'Geschaeftsidee entwickeln', 'Gruendungsidee', 'Nebenprojekt starten', 'ich komme nicht weiter mit meiner Idee', 'ich schaffe es nicht anzufangen', sowie 'idea2self-Datei ueberarbeiten', 'idea2self iterieren', 'idea2self review'. Routet anschliessend an spezialisierte i2s-* Skills. NICHT aktivieren bei direkten Artefakt-Triggern wie 'Problem-Statement erstellen' (dafuer i2s-problem-statement), 'Persona erstellen' (i2s-persona), 'Problemraum recherchieren' (i2s-recherche), 'Experiment planen / MVE-Design' (i2s-experiment-card), 'Prototyp-Konzept erstellen' (i2s-prototyp-konzept), 'Action-Plan erstellen / WOOP' (i2s-action-plan), 'Discovery-Interview / vage Idee strukturieren' (i2s-discovery). Sprache: Deutsch." +allowed-tools: Read Write Edit Glob Grep AskUserQuestion TodoRead TodoWrite --- - +# Klarheit mit Idea2Self — Router - -Dieser Skill bildet den gesamten Idea2Self-Prozess als asynchronen, KI-gestützten Workflow ab. Ausgangspunkt ist immer eine Idee. Der Skill führt den Nutzer durch 7 aufeinander aufbauende Workflows, die jeweils die zentrale Datei idea2self-.md erweitern und verbessern. +Entry-Point fuer den Idea2Self-Prozess. Routet zwischen sieben spezialisierten Workflow-Skills und uebernimmt selbst nur drei cross-cut-Aufgaben: idea2self-Datei anlegen, Sequenz-Empfehlung geben, bestehende Datei iterieren. -Claim: „Von vager Idee zu messbarem nächsten Schritt." - +## Essential Principles - +1. **Routing only.** Der Router fuehrt selbst keine Artefakt-Workflows aus. Er erkennt das Intent, prueft Vorbedingungen, und uebergibt an den passenden `i2s-*` Skill. +2. **idea2self-Datei ist die einzige Quelle der Wahrheit.** Der Router legt sie an (`idea2self-.md`, kebab-case, 3-5 Woerter). Jeder Sub-Skill liest sie vor seiner Arbeit und schreibt seinen Abschnitt zurueck. +3. **Vorbedingungs-Pruefung vor Hand-off.** Persona braucht Problem-Statement, Experiment-Card braucht Recherche, etc. Wenn eine Vorbedingung fehlt: dem Nutzer den fehlenden Sub-Skill nennen, nicht selbst nachholen. +4. **Sequenz-Empfehlung, kein Zwang.** Standard-Reihenfolge 1 -> 2 -> 3 -> 4 -> 5 -> 6 -> 7. Nutzer kann ueberspringen, wenn er Infos anderweitig vorhaelt. +5. **Iteration als Router-Capability.** Bestehende idea2self-Datei ueberarbeiten lebt im Router (`workflows/review-iterate.md`) — ein separater Sub-Skill wuerde nur duplizieren. -1. **Output > Theorie:** Jeder Workflow-Durchlauf erzeugt ein konkretes, exportierbares Artefakt in der idea2self-Datei. Kein Block ohne Output. +## When to Use -2. **Hypothesen statt Behauptungen:** Alles ist Annahme bis Daten vorliegen. Unbelegte Annahmen: _(Annahme)_. KI-Ergänzungen: _(Vorschlag)_. +- Nutzer beschreibt eine vage Idee, will sie strukturieren ("ich habe da eine Idee", "wie packe ich das an?"). +- Nutzer fragt nach dem gesamten Idea2Self-Sprint / Launchpad / Coaching-Format. +- Nutzer hat eine bestehende `idea2self-.md` und will sie ueberarbeiten / iterieren / Konsistenz checken. +- Nutzer ist unsicher, welcher Artefakt-Schritt als naechstes dran ist. -3. **Schnelles Lernen:** Echte Validierung > Perfektion auf dem Papier. +## When NOT to Use -4. **Scope-Klarheit:** In jedem Workflow explizit fragen: „Was wird bewusst NICHT gebaut/gelöst?" +- Nutzer triggert direkt einen Artefakt-Workflow ("Persona erstellen", "Problem-Statement erstellen", "Action-Plan erstellen") -> der jeweilige `i2s-*` Skill aktiviert sich von selbst, der Router bleibt aus. +- Nutzer will Web-Recherche zu seinem Problemraum -> `i2s-recherche` direkt. +- Generelles Brainstorming ohne Idee-Bezug -> kein `i2s-*` Skill, nutze `compound-engineering:ce-brainstorm`. -5. **KI als Beschleuniger:** KI übernimmt Struktur, Recherche, Varianten. Mensch entscheidet. KI ersetzt nicht das Denken. +## Routing Pattern -6. **Iterativ:** Jeder Workflow-Durchlauf überarbeitet und verbessert die idea2self-Datei. Neue Erkenntnisse fließen rückwirkend in frühere Abschnitte ein. +``` +intake (intent + optional file path) + | + +-- "neue Idee" -> i2s-discovery (no prereq) + | + +-- "Problem-Statement" -> i2s-problem-statement (prereq: ## Idee) + +-- "Persona" -> i2s-persona (prereq: ## Problem-Statement) + +-- "Recherche" -> i2s-recherche (prereq: PS + Persona) + +-- "Experiment-Card" -> i2s-experiment-card (prereq: PS + Persona + Recherche) + +-- "Prototyp-Konzept" -> i2s-prototyp-konzept (prereq: Experiment-Card) + +-- "Action-Plan" -> i2s-action-plan (prereq: Prototyp-Konzept) + | + +-- "ueberarbeiten" -> workflows/review-iterate.md (router-internal) +``` -7. **Recherche an definierten Stellen:** Einfache Recherchen inline. Tiefergehende als eigener Workflow-Schritt (siehe references/recherche-regeln.md). - +Konkrete Trigger-Mapping-Tabelle und Vorbedingungs-Pruefung: `references/routing-table.md`. - -Die zentrale Datei heißt idea2self-.md (Kurztitel, 3–5 Wörter, kebab-case). Wird beim Discovery-Interview festgelegt. Beispiel: idea2self-nachbarschafts-tauschboerse.md +## Phases -Die Datei ist die Single Source of Truth (SSOT) für den gesamten Prozess. - +### Phase 1 — Intent erkennen - -Vor dem ersten Workflow: references/kommunikationsregeln.md lesen. +**Entry:** Skill ist aktiviert. -Kurzfassung: -- Nüchtern, sachlich, direkt. Keine Motivation, keine Emojis, keine Superlative. +**Aktionen:** +1. Pruefe Nutzer-Nachricht gegen die Trigger-Spalte in `references/routing-table.md`. +2. Falls Nutzer einen Dateipfad nennt: idea2self-Datei laden, vorhandene Sektionen registrieren. +3. Falls Intent unklar: ``-Block (siehe unten) anzeigen, eine Antwort erfragen. + +**Exit:** Intent ist auf genau einen der 8 Routing-Pfade gemappt. + +### Phase 2 — Vorbedingung pruefen + +**Entry:** Intent ist gemappt. + +**Aktionen:** +1. Aus `references/routing-table.md` die Vorbedingungs-Spalte lesen. +2. Falls Vorbedingung erfuellt (Sektion existiert in idea2self-Datei): weiter. +3. Falls Vorbedingung fehlt: Nutzer informieren: "Voraussetzung X fehlt. Trigger zuerst `/` oder bestaetige, dass du X anderweitig vorhaltst." + +**Exit:** Voraussetzungen sind erfuellt oder explizit uebergangen. + +### Phase 3 — Hand-off oder Iteration + +**Entry:** Phase 2 erfolgreich abgeschlossen. + +**Aktionen:** +- Fuer Pfad 1-7: Nenne den zustaendigen Sub-Skill und die Trigger-Phrase, mit der der Nutzer ihn aktiviert. Beispiel: "Sage 'Persona erstellen' fuer `i2s-persona`." +- Fuer Pfad 8 (ueberarbeiten): `workflows/review-iterate.md` lesen und exakt befolgen. + +**Exit:** Sub-Skill ist genannt (Pfad 1-7) oder Review-Workflow ist abgeschlossen (Pfad 8). + +## Intake (wenn Intent unklar) + +``` +Was moechtest du tun? + +1. Neue Idee starten +2. Problem-Statement erstellen -> i2s-problem-statement +3. Persona erstellen -> i2s-persona +4. Problemraum recherchieren -> i2s-recherche +5. Experiment-Card erstellen -> i2s-experiment-card +6. Prototyp-Konzept erstellen -> i2s-prototyp-konzept +7. Action-Plan erstellen (mit WOOP) -> i2s-action-plan +8. Bestehende Datei ueberarbeiten -> router-internal + +Wenn du eine bestehende idea2self-Datei hast, nenne den Dateipfad. +``` + +Warte auf Antwort, bevor du fortfaehrst. + +## File Convention + +Die zentrale Datei heisst `idea2self-.md` (Kurztitel, 3-5 Woerter, kebab-case). Wird in `i2s-discovery` Schritt 5 angelegt — der Router stellt nur sicher, dass sie existiert, bevor Sub-Skills aktiv werden. + +Datei-Skelett (waechst pro Workflow-Durchlauf): siehe `templates/idea2self-vorlage.md`. + +## Quick Reference — Kommunikation + +Vollstaendige Regeln: `references/kommunikationsregeln.md`. + +- Nuechtern, sachlich, direkt. Keine Motivation, keine Emojis, keine Superlative. - Alltagssprache. Sprache des Nutzers beibehalten. -- _(Vorschlag)_ / _(Annahme)_ für ungeklärte Inhalte. -- Max. 3–4 Sätze pro Nachricht. Strukturierte Ausgaben dürfen länger sein. -- Steuerbefehle: „Export", „Zurück", „Ich weiß es nicht", „Überspringen", „Weiter". -- Fortschrittsanzeige: „[X] von Y" pro Workflow. - +- `_(Vorschlag)_` / `_(Annahme)_` fuer ungeklaerte Inhalte. +- Max. 3-4 Saetze pro Nachricht. Strukturierte Ausgaben duerfen laenger sein. +- Steuerbefehle: "Export", "Zurueck", "Ich weiss es nicht", "Ueberspringen", "Weiter". +- Fortschrittsanzeige: "[X] von Y" pro Workflow. - -Der Idea2Self-Verhaltenskodex gilt für alle Interaktionen: -1. Respektiere Alle. 2. Sprechen und Zuhören. 3. Keine Toleranz gegenüber Mobbing. -4. Verantwortlichkeit und Lernen. 5. Inklusion. 6. Zusammenarbeit statt Konkurrenz. -7. Respekt nach außen – auch gegenüber Interview-Partnern. - +## Reference Index - +| File | Purpose | +|------|---------| +| `references/routing-table.md` | Trigger-Phrasen -> Sub-Skill + Vorbedingungs-Pruefung | +| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Steuerbefehle (curated extract aus `plugin-shared/`) | +| `references/artefakt-pipeline.md` | Pipeline-Uebersicht + idea2self-Datei-Lifecycle (curated extract) | +| `workflows/review-iterate.md` | Bestehende Datei ueberarbeiten (router-cross-cut) | +| `templates/idea2self-vorlage.md` | Datei-Skelett, wird in i2s-discovery angelegt | - -Was möchtest du tun? +## Success Criteria -1. **Neue Idee starten** – Discovery-Interview → idea2self-Datei anlegen. -2. **Problem-Statement erstellen** – Problem + Zielgruppe formulieren (v0.1/v0.2). -3. **Persona erstellen** – Verhaltensbasierte Zielgruppen-Persona (v0.1/v0.2). -4. **Problemraum recherchieren** – Web-Recherche + v0.2 + Interview-Impulse. -5. **Experiment-Card erstellen** – Hypothese, Experiment-Design, Metriken. -6. **Prototyp-Konzept erstellen** – Lösungsideen, Prototyp-Typ, Scope, User Flow. -7. **Action-Plan erstellen** – 10 Aufgaben / 14 Tage + Obstacle-Plan (WOOP). -8. **Bestehende Datei überarbeiten** – Erkenntnisse einarbeiten, Artefakte iterieren. - -Wenn du eine bestehende idea2self-Datei hast, kopiere den Inhalt oder nenne den Dateipfad. - -**Warte auf Antwort, bevor du fortfährst.** - - - -| Antwort | Workflow | Voraussetzung | -|---------|----------|---------------| -| 1, „neue Idee", „starten" | workflows/discovery-idea.md | Keine | -| 2, „Problem", „Problem-Statement" | workflows/problem-statement.md | Idee beschrieben | -| 3, „Persona", „Zielgruppe" | workflows/persona.md | Problem-Statement vorhanden | -| 4, „Recherche", „Problemraum" | workflows/recherche.md | PS + Persona vorhanden | -| 5, „Experiment", „Hypothese" | workflows/experiment-card.md | PS + Persona + Recherche | -| 6, „Prototyp", „Konzept" | workflows/prototyp-konzept.md | Experiment-Card vorhanden | -| 7, „Action-Plan", „WOOP" | workflows/action-plan.md | Prototyp-Konzept vorhanden | -| 8, „überarbeiten", „iterieren" | workflows/review-iterate.md | idea2self-Datei vorhanden | - -Voraussetzungs-Prüfung: Wenn Voraussetzung fehlt → darauf hinweisen + fehlenden Workflow anbieten. Nur überspringen wenn Nutzer explizit bestätigt, dass Infos anderweitig vorliegen. - -Sequenz-Empfehlung: 1 → 2 → 3 → 4 → 5 → 6 → 7. - -**Nach dem Lesen des Workflows: Folge ihm exakt.** - - - -references/kommunikationsregeln.md – Kommunikationsregeln für alle Workflows -references/methodik.md – Design Thinking, Lean Startup, WOOP, Methoden-Mapping -references/artefakt-pipeline.md – Pipeline, Kontextweitergabe, Versionierung -references/recherche-regeln.md – Wann/wie einfache und tiefe Recherchen -references/export-formate.md – Alle Export-Templates für die idea2self-Datei - - - -| Workflow | Zweck | Output-Sektion | -|----------|-------|----------------| -| discovery-idea.md | Vage Idee → strukturierter Kern | ## Idee | -| problem-statement.md | Problem + Zielgruppe formulieren | ## Problem-Statement | -| persona.md | Verhaltensbasierte Persona | ## Persona | -| recherche.md | Web-Recherche + v0.2 + Impulse | ## Recherche-Report | -| experiment-card.md | Hypothese + MVE-Design + Metriken | ## Experiment-Card | -| prototyp-konzept.md | Lösungsideen + Prototyp-Konzept | ## Prototyp-Konzept | -| action-plan.md | Aufgaben + WOOP-Obstacle-Plan | ## Action-Plan | -| review-iterate.md | Artefakte überarbeiten | Aktualisierte Sektionen | - - - -| Template | Zweck | -|----------|-------| -| idea2self-vorlage.md | Grundstruktur der idea2self-Datei – wird beim Discovery angelegt | - - - -Der Skill ist erfolgreich wenn: -- Die idea2self-Datei enthält alle durchlaufenen Artefakte als konsistente Kette. -- Jedes Artefakt ist intern konsistent und mit den vorherigen Artefakten kompatibel. -- Unbelegte Annahmen sind als _(Annahme)_ oder _(Vorschlag)_ markiert. -- Der Nutzer kann sein Problem und seine Zielgruppe einem Fremden in 60 Sekunden erklären. -- Am Ende existiert ein Action-Plan mit konkreten Aufgaben, der am nächsten Tag startbar ist. - +- [ ] Nutzer-Intent ist auf genau einen Routing-Pfad gemappt. +- [ ] Vorbedingungen sind geprueft. Fehlende Vorbedingungen werden mit Hand-off-Hinweis adressiert, nicht still uebergangen. +- [ ] Bei Pfad 1-7: der zustaendige Sub-Skill ist genannt mit Trigger-Phrase. Der Router fuehrt den Workflow NICHT selbst aus. +- [ ] Bei Pfad 8: `workflows/review-iterate.md` ist ausgefuehrt, idea2self-Datei wurde aktualisiert, Changelog-Eintrag vorhanden. +- [ ] idea2self-Datei bleibt die alleinige Quelle der Wahrheit. Keine parallelen Notizen. diff --git a/skills/klarheit-mit-idea2self/references/routing-table.md b/skills/klarheit-mit-idea2self/references/routing-table.md new file mode 100644 index 0000000..1708a07 --- /dev/null +++ b/skills/klarheit-mit-idea2self/references/routing-table.md @@ -0,0 +1,77 @@ +# 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 + +1. Lade die idea2self-Datei (Pfad steht meist im Nutzer-Prompt oder ist Standardpfad `./idea2self-.md` im aktuellen Verzeichnis). +2. Pruefe per Markdown-Heading-Match (`^## `), ob die Precondition-Sektion existiert UND nicht leer ist. +3. Vorbedingung erfuellt -> Hand-off ausfuehren (Phase 3). +4. Vorbedingung fehlt -> Nutzer informieren: + - Form: "Voraussetzung `## ` fehlt in `idea2self-.md`. Trigger zuerst `` 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: . +Trigger-Phrase: "". +Vorhandene Sektionen in idea2self-Datei: . + +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.