refactor(skills): migrate all 8 SKILL.md to pure-XML + apply audit fixes
Pure-XML body structure per marketplace-tools use-xml-tags.md (DEC-0013 D-XML, founder-approved): all markdown headings removed from skill bodies, replaced with semantic tags (<objective>, <quick_start>, <success_criteria> required; <essential_principles>, <when_to_use>, <when_not_to_use>, <precondition_check>, <workflow>, <reference_guides>, plus router <routing>/<intake>/<file_convention>/<guardrails>). Phases kept as bold labels inside <workflow>. Frontmatter (name, description, allowed-tools, metadata.version) preserved; all reference paths intact. Audit fixes (REV 2026-05-21) folded into the per-skill migration: - F1 i2s-persona: drop inline-research line (no WebFetch/WebSearch declared) -> point to i2s-recherche. - F2 i2s-discovery: web_search -> WebSearch (correct tool name). - F3 i2s-discovery/experiment-card/prototyp-konzept: document that WebFetch/WebSearch fire only on explicit confirmation for a single lookup (full research lives in i2s-recherche). - F4 router: shorten 897-char description to ~480 (exhaustive trigger list lives in references/routing-table.md). - F5 i2s-experiment-card: soften description preconditions (v0.2 preferred, not enforced — matches the actual precondition check). Verification (8 checks): no markdown headings, 3 required tags/skill, frontmatter integrity, XML tags balanced (code-fence aware), local refs resolve, 8 skills, gitignore present, drift-check exit 0. All green. 8 parallel general-purpose subagents (one per SKILL.md, disjoint files).
This commit is contained in:
@@ -6,40 +6,39 @@ metadata:
|
||||
version: 1.0.0
|
||||
---
|
||||
|
||||
# i2s-prototyp-konzept — Loesungsskizze + Scope
|
||||
|
||||
<objective>
|
||||
Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Feedback + persoenlicher Passung **eine** Loesung formen und scharf abgrenzen. Generiert 5 Roh-Ideen, faechert sie auf, der Nutzer waehlt und schaerft.
|
||||
</objective>
|
||||
|
||||
## Essential Principles
|
||||
|
||||
<essential_principles>
|
||||
1. **Ideen-Werkstatt vor Konzept.** Erst 5 Roh-Ideen aus dem Problemraum + Recherche + Interessen synthetisieren, dann waehlen. Nicht direkt das erste Konzept ausbauen.
|
||||
2. **5 Ideen muessen substanziell unterschiedlich sein.** Wenn alle 5 dasselbe in Variationen sind: zurueck. "Welche Richtung waere komplett anders?"
|
||||
3. **Persoenliche Rollenpassung ist Pflichtfeld.** Builder / Coach / Kurator / Erklaerer / Gastgeber — eine Loesung, die nicht zur Rolle des Founders passt, scheitert nicht am Markt sondern an der Umsetzung.
|
||||
4. **Scope IN UND Scope OUT explizit.** Was wird NICHT gebaut, ist genauso wichtig wie was gebaut wird. Ohne Scope-OUT bleibt der Action-Plan unmoeglich.
|
||||
5. **Konzept, kein Bau.** Wir definieren das Konzept (Typ, Funktionen, Flow), nicht den lauffaehigen Prototyp. Der Bau lebt im Action-Plan.
|
||||
</essential_principles>
|
||||
|
||||
## When to Use
|
||||
|
||||
<when_to_use>
|
||||
- `## Experiment-Card` existiert + Experiment idealerweise durchgefuehrt; `## Prototyp-Konzept` fehlt oder iteriert werden soll.
|
||||
- Aus Router-Hand-off (Pfad 6) oder direkter Trigger ("Prototyp-Konzept erstellen", "Loesungsideen entwickeln").
|
||||
- Nach erstem Konzept-Run + neuen Erkenntnissen: v0.2 mit anderem Typ oder Scope.
|
||||
</when_to_use>
|
||||
|
||||
## When NOT to Use
|
||||
|
||||
<when_not_to_use>
|
||||
- `## Experiment-Card` fehlt -> erst `i2s-experiment-card`.
|
||||
- Nutzer will Aufgabenliste / 14-Tage-Plan -> `i2s-action-plan`.
|
||||
- Allgemeines Produkt-Brainstorming ohne Idea2Self-Anker -> `compound-engineering:ce-brainstorm`.
|
||||
</when_not_to_use>
|
||||
|
||||
## Precondition Check
|
||||
|
||||
<precondition_check>
|
||||
**Vor Phase 1:**
|
||||
1. idea2self-Datei laden.
|
||||
2. Auf `^## Experiment-Card` matchen + Sektion-Inhalt > 100 Zeichen.
|
||||
3. Fehlt -> abbrechen mit Hinweis: "`## Experiment-Card` fehlt. Trigger zuerst `i2s-experiment-card`."
|
||||
</precondition_check>
|
||||
|
||||
## Phases
|
||||
|
||||
### Phase 1 — Kontext laden + Experiment-Status klaeren
|
||||
<workflow>
|
||||
**Phase 1 — Kontext laden + Experiment-Status klaeren**
|
||||
|
||||
**Entry:** Vorbedingung erfuellt.
|
||||
|
||||
@@ -52,20 +51,20 @@ Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Fee
|
||||
|
||||
**Exit:** Experiment-Stand erfasst.
|
||||
|
||||
### Phase 2 — 4 Teilaspekte
|
||||
**Phase 2 — 4 Teilaspekte**
|
||||
|
||||
**Entry:** Phase 1 abgeschlossen.
|
||||
|
||||
**Aktionen:**
|
||||
1. **TA1 FEEDBACK.** Bisherige Loesungsidee + was Interviews bestaetigten/infrage stellten.
|
||||
2. **TA2 INTERESSEN.** Persoenliche Zugkraft + Rollenpassung (Builder / Coach / Kurator / Erklaerer / Gastgeber).
|
||||
3. **TA3 IDEEN-WERKSTATT.** Synthetisiere 5 substanziell unterschiedliche Roh-Ideen (Titel + Kurzbeschreibung). Praesentiere als `_(Vorschlag)_`. Feedback einholen, max. 2 Iterationsrunden. Optionale Inline-Recherche zu Formaten / Tools (NICHT Markt — das steht im Recherche-Report).
|
||||
3. **TA3 IDEEN-WERKSTATT.** Synthetisiere 5 substanziell unterschiedliche Roh-Ideen (Titel + Kurzbeschreibung). Praesentiere als `_(Vorschlag)_`. Feedback einholen, max. 2 Iterationsrunden. Optionale Inline-Recherche zu Formaten / Tools (NICHT Markt — das steht im Recherche-Report). Web-Tools (WebFetch / WebSearch) werden hier nur auf ausdrueckliche Bestaetigung des Nutzers und ausschliesslich zur Klaerung von Formaten / Tools genutzt — nicht fuer Markt oder Wettbewerb, denn das steht bereits im Recherche-Report.
|
||||
4. **TA4 KONZEPT.** Fuer die gewaehlte Idee: Typ (App / Service / Kurs / Community / ...), 3-5 Kernfunktionen, Scope IN, Scope OUT, User Flow in 3-5 Schritten.
|
||||
5. Anti-Pattern-Detection: Idee ignoriert Interview-Feedback / alle 5 Ideen sind Variationen desselben / Ideen ignorieren Persona.
|
||||
|
||||
**Exit:** Alle 4 TAs sind durch, eine Idee ist gewaehlt + ausgearbeitet.
|
||||
|
||||
### Phase 3 — Konsistenzpruefung
|
||||
**Phase 3 — Konsistenzpruefung**
|
||||
|
||||
**Entry:** Phase 2 abgeschlossen.
|
||||
|
||||
@@ -77,7 +76,7 @@ Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Fee
|
||||
|
||||
**Exit:** Keine offenen Konsistenz-Konflikte.
|
||||
|
||||
### Phase 4 — Export
|
||||
**Phase 4 — Export**
|
||||
|
||||
**Entry:** Phase 3 abgeschlossen.
|
||||
|
||||
@@ -89,25 +88,30 @@ Schritt 6 im Idea2Self-Prozess. Aus dem Problemraum + Recherche + Experiment-Fee
|
||||
5. Hand-off: "Prototyp-Konzept steht. Letzter Schritt: Action-Plan. Trigger: 'Action-Plan erstellen' fuer `i2s-action-plan`. Oder 'Weiter'."
|
||||
|
||||
**Exit:** Datei aktualisiert, Hand-off ausgesprochen.
|
||||
</workflow>
|
||||
|
||||
## Quick Reference
|
||||
<quick_start>
|
||||
Trigger: "Prototyp-Konzept erstellen" / "Loesungsideen entwickeln".
|
||||
Vorbedingung: idea2self-Datei mit `## Experiment-Card`.
|
||||
Ablauf: Kontext laden -> 4 Teilaspekte (Feedback, Interessen, Ideen-Werkstatt mit 5 Roh-Ideen, Konzept) -> Konsistenzpruefung -> Export.
|
||||
Output: `## Prototyp-Konzept` Sektion (Typ, 3-5 Kernfunktionen, Scope IN/OUT, User Flow 3-5 Schritte).
|
||||
</quick_start>
|
||||
|
||||
<reference_guides>
|
||||
Kommunikation: `references/kommunikationsregeln.md`.
|
||||
Format-Schema: `references/prototyp-konzept-format.md`.
|
||||
Workflow-Detail: `workflows/prototyp-konzept.md`.
|
||||
Optional Variantenanalyse: `templates/prototyp-remixer-auswertung.md`.
|
||||
|
||||
## Reference Index
|
||||
|
||||
| File | Purpose |
|
||||
|------|---------|
|
||||
| `workflows/prototyp-konzept.md` | Vollstaendiger 4-Schritt-Ablauf mit 4 TAs + Ideen-Werkstatt-Regeln |
|
||||
| `references/kommunikationsregeln.md` | Tonalitaet, Marker, Prototyp-spezifische Heuristiken (curated) |
|
||||
| `references/prototyp-konzept-format.md` | Markdown-Schema fuer `## Prototyp-Konzept` |
|
||||
| `templates/prototyp-remixer-auswertung.md` | Optionale Variantenanalyse (3 Dimensionen, Kombinationen, Bewertung) |
|
||||
</reference_guides>
|
||||
|
||||
## Success Criteria
|
||||
|
||||
<success_criteria>
|
||||
- [ ] Experiment-Feedback ist einbezogen oder explizit als fehlend markiert.
|
||||
- [ ] 5 substanziell unterschiedliche Roh-Ideen wurden generiert + bewertet.
|
||||
- [ ] 1 Idee ist gewaehlt mit knapper Begruendung.
|
||||
@@ -115,3 +119,4 @@ Optional Variantenanalyse: `templates/prototyp-remixer-auswertung.md`.
|
||||
- [ ] Persoenliche Rolle ist reflektiert + matcht den Loesungstyp.
|
||||
- [ ] idea2self-Datei enthaelt `## Prototyp-Konzept` mit Versions-Header + Changelog-Eintrag.
|
||||
- [ ] Hand-off zu `i2s-action-plan` ist ausgesprochen.
|
||||
</success_criteria>
|
||||
|
||||
Reference in New Issue
Block a user