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).
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.
Fix wrong GitHub URL (philippsieder/klarheit-mit-idea2self) and align
plugin.json + marketplace.json with Claude Code plugin/marketplace
schema. Repository is hosted on the self-hosted Gitea at
git.slickservice.eu/Idea2Self/agent-skills, not GitHub.
plugin.json:
- homepage + repository point at git.slickservice.eu/Idea2Self/agent-skills
- repository changed from string to {type, url} object (schema-conform)
- version bumped 1.0.0 -> 2.0.0 (router + 7 atomic skills is a major
architectural change vs the monolithic v1)
- description updated to reflect the new router-and-atoms architecture
- author gains url field (think-slick.de)
- keywords expanded with the seven sub-skill domains (discovery,
problem-statement, persona, recherche, experiment, prototyp,
action-plan) + facilitator
marketplace.json:
- description expanded ("Sammlung von Claude-Code-Plugins ...")
- owner gains url field
- marketplace gains its own homepage + repository + license (Gitea URL)
- per-plugin entry gains homepage + license + keywords for marketplace
discovery
- plugin version synced to 2.0.0
- source stays "./" — marketplace.json and plugin.json sit in the
same repo, no cross-repo source needed
README.md:
- Lead paragraph now describes router + 7 atomic skills (not 7
workflows in a single skill)
- Installation: Gitea URL for /plugin marketplace add; install
command uses plugin@marketplace form
(klarheit-mit-idea2self@idea2self-ecosystem)
- SSH + local-path install variants added for contributors
- "Als einzelne Skills" copy command updated for new layout
- New "Architektur"-Section with ASCII tree of router + i2s-* skills
+ plugin-shared explanation
- Trigger-tabelle for direct sub-skill activation (7 rows mapping
german trigger-phrase to skill and output section)
- Repository link in footer
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.
Add plugin-shared/ as the canonical source of truth for cross-skill
references and templates. Holds full versions of methodik, artefakt-
pipeline, kommunikationsregeln, recherche-regeln, export-formate,
and the two templates.
Per workflow-skill design rules (no reference chains, no hardcoded
cross-skill paths), Skills do NOT reference plugin-shared/ at
runtime. Each Skill carries curated extracts in its own references/.
drift-check.sh (added in step 11) will compare those extracts against
the master here.
Step 1 of i2s-skill-split refactor.
Philipp Sieder
deployment