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).
methodik.md, recherche-regeln.md and templates/prototyp-remixer-
auswertung.md are no longer referenced by the router after the
monolith split (verified: rg found no inbound refs). Masters live in
plugin-shared/; the template is used by i2s-prototyp-konzept.
export-formate.md is kept (workflows/review-iterate.md needs it).
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).
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.
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