The 7 sub-skill workflows were git mv'd from the monolith. Their
<required_reading> headers were updated during extraction, but the
export-step prose still pointed at the monolith's export-formate.md,
which does not exist inside the self-contained sub-skills.
Repoint each to the local curated format ref:
- i2s-action-plan -> references/action-plan-format.md
- i2s-discovery -> references/idee-format.md
- i2s-experiment-card -> references/experiment-card-format.md
- i2s-persona -> references/persona-format.md
- i2s-problem-statement -> references/problem-statement-format.md
- i2s-recherche -> references/recherche-report-format.md
Low-risk consistency fix (the correct format was already loaded via
required_reading); removes a dead reference an executing agent would
fail to resolve.
Step 7 of i2s-skill-split refactor. Fourth atomic sub-skill — first
one that uses external tools (WebFetch, WebSearch).
Contents:
- SKILL.md: 6 numbered phases (load + frame questions, show +
stadt-frage, web-research, report, v0.2-vorschlaege, export)
with entry/exit. description includes anti-trigger to
compound-engineering:ce-web-researcher for non-Idea2Self
research.
- workflows/recherche.md: 6-step workflow with two cluster
schemas (Problem / Zielgruppe). git mv from monolith, paths
updated to local refs.
- references/kommunikationsregeln.md: curated extract with
recherche-specific dialog heuristics (no source halluci-
nation, source-conflict-handling, scope-recovery).
- references/recherche-regeln.md: full curated extract -
einfache vs tiefe recherche table, quellen-qualitaet pflichten
(min 2 unabh quellen, primaer > sekundaer, datum-pflicht),
widerspruchs-handling, stadt-spezifische recherche, output-
schema pro frage, anti-patterns.
- references/recherche-report-format.md: curated markdown
schema for ## Recherche-Report sektion with full filled
example.
Tools include WebFetch + WebSearch (the recherche actually
hits the web). Read, Write, Edit, Glob, Grep, AskUserQuestion,
TodoRead, TodoWrite round out the set.
Precondition: ## Problem-Statement + ## Persona both required.
Output: ## Recherche-Report + optional v0.2-updates to PS and
Persona (only on explicit user confirmation).
Drop reference to references/export-formate.md (does not exist in
this sub-skill) and references/artefakt-pipeline.md (not extracted
here; pipeline rules live in i2s-problem-statement curated extract
where they matter). Point at the local references/persona-format.md
curated extract instead.
Close 4 HIGH-priority gaps from router-quality-checklist audit
(agentbrain/memory/templates/router-quality-checklist.md):
1. Quick-Start-Trace (section 3): three end-to-end dialog examples
added before the Routing Pattern section.
- Beispiel A: Happy path (new idea, no file yet)
- Beispiel B: Precondition-Gap (Persona triggered without PS)
- Beispiel C: No-Match (Marketing-Funnel request)
Each example shows phase-by-phase trace + hand-off wording incl.
confirmation question.
2. Phase 1b — No-Match-Handling (section 9): new phase between
intent recognition and precondition check. Explicit out-of-scope
wording, scope-statement, anchor question, and rules against
semantic-fallback routing or hallucinated capabilities.
3. Tiebreaker-Regeln (section 8): added to routing-table.md.
Four-rule hierarchy (Explicit > Semantic; Earlier-pipeline >
Later; Sub-Skill > Router; review-iterate beats any artifact
verb when iteration is explicit). One-question-max with two
options for true ambiguity; otherwise fall through to Phase 1b.
Includes a worked-example table.
4. Guardrails section (section 10): consolidated 8-item "Never X"
block at the end of SKILL.md. Covers no-self-execute, no-silent-
routing-on-missing-precondition, no menu-dump > 8, no halluci-
nated capabilities, no untied tiebreaker routing, no skipped
file-state read, no bypassed user context, no iterated
clarification.
MEDIUM gaps (sections 5/6/7 — bucket grouping, required/optional
precondition split, good/bad output examples) remain open as a
polish pass after step 10b. EVAL strategy (section 11) is a
separate workstream tracked in a future plan.
Files: 117 insertions, 1 deletion across SKILL.md + routing-table.md.
The workflow file (git mv'd from the monolith) still referenced
references/export-formate.md, which does not exist in this sub-skill.
Point it at the curated extract references/problem-statement-format.md
instead. Missed in the previous commit because the Edit was attempted
before Read.
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.
Philipp Sieder
deployment