2
0
Commit Graph

12 Commits

Author SHA1 Message Date
Philipp Sieder 276c7b24fc chore(i2s): add metadata.version to all skill frontmatter
Per DEC-0013 D1 + R-008 (lint_skill_version hook) +
architecture-defaults (version lives at metadata.version, never
top-level). Router klarheit-mit-idea2self = 2.0.0 (continues the
monolith); the 7 i2s-* sub-skills = 1.0.0 (new).
2026-05-21 22:40:54 +02:00
Philipp Sieder 92b2688565 refactor(router): remove vestigial refs after sub-skill extraction
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).
2026-05-21 22:40:54 +02:00
Philipp Sieder 3074ea9c6c feat(i2s-action-plan): extract from monolith
Step 10 of i2s-skill-split refactor. Seventh and final atomic
sub-skill — completes the monolith split.

Contents:
- SKILL.md: 5 numbered phases (load, 7 TAs, consistency, export,
  abschluss with zusammenfassung). description with action-plan/
  WOOP/14-tage-plan triggers, anti-trigger to ce-strategy for
  longer horizons. Precondition: ## Prototyp-Konzept required.
- workflows/action-plan.md: 5-step workflow with 7 TAs (was,
  wie, wann, risiken, kontrollpunkt, hindernisse WOOP, wenn-dann).
  git mv from monolith, paths updated.
- references/kommunikationsregeln.md: curated extract with
  action-plan-specific dialog heuristics (10-task-max, deadline-
  pflicht, woop-not-optional, wenn-dann-konkret, staerken-
  kopplung).
- references/woop.md: curated extract from plugin-shared/
  methodik.md, woop block. WOOP-Mapping zu Idea2Self-TAs,
  inner-vs-extern-table, wenn-dann anti-patterns + corrections,
  staerken-kopplung-regel, evidenz-paragraph.
- references/action-plan-format.md: full markdown schema with
  10-row aufgaben-tabelle, externe-risiken-tabelle, woop-
  obstacle-plan with staerken-kopplung + wenn-dann. Full filled
  example (hausflur-set 14-day pilot plan).

Tools: standard workflow-skill set (no WebFetch — recherche
lives upstream; this is execution planning).

Outcome: all 7 i2s-* sub-skills now exist. Router (klarheit-
mit-idea2self) routes to them. Remaining steps: 10b router
cleanup, 11 drift-check + manifests, 12 README, 13 QA audits +
post-impl specs, 14 submodule pointer bump.
2026-05-19 01:38:15 +02:00
Philipp Sieder 1556a25171 feat(i2s-prototyp-konzept): extract from monolith
Step 9 of i2s-skill-split refactor. Sixth atomic sub-skill.

Contents:
- SKILL.md: 4 numbered phases (load + experiment-status, 4 TAs
  including ideen-werkstatt, consistency, export). description
  with prototyp/loesungsidee/user-flow triggers, anti-trigger
  to ce-brainstorm for non-Idea2Self ideation. Precondition:
  ## Experiment-Card required.
- workflows/prototyp-konzept.md: 4-step workflow (git mv,
  paths updated).
- references/kommunikationsregeln.md: curated extract with
  prototyp-specific heuristics (5-ideas-must-differ, scope-out-
  pflicht, user-flow-max-5, role-vs-solution-mismatch).
- references/prototyp-konzept-format.md: full schema with
  verworfene-ideen-tabelle (alle 4 mit grund) and filled
  hausflur-set example.
- templates/prototyp-remixer-auswertung.md: optional 3-
  dimensions / kombinations / bewertung variantenanalyse,
  copied from plugin-shared.

Tools include WebFetch + WebSearch for inline format/tool
checks (NOT markt/wettbewerb — that's in recherche).
2026-05-19 01:35:10 +02:00
Philipp Sieder 052d0c6e60 feat(i2s-experiment-card): extract from monolith
Step 8 of i2s-skill-split refactor. Fifth atomic sub-skill.

Contents:
- SKILL.md: 4 numbered phases (load context, 5 TAs, consistency,
  export) with precondition triple (## PS + ## Persona + ##
  Recherche-Report all required). description with explicit
  hypothesis/MVE/experiment triggers, anti-triggers naming
  i2s-recherche and i2s-prototyp-konzept.
- workflows/experiment-card.md: 5-step workflow with the 5 TAs
  and entscheidungslogik formalism. git mv from monolith with
  paths updated.
- references/kommunikationsregeln.md: curated extract with
  experiment-card-specific dialog heuristics (hypothesis as
  loesung, hypothesis-stacking, decision-threshold-pflicht,
  lassen-schwelle-pflicht).
- references/lean-startup.md: curated extract from
  plugin-shared/methodik.md, lean_startup block.
  Build-Measure-Learn miniformat, MVE-vs-MVP, evidenz-
  abstufungen, MVE-options-tabelle, anti-patterns.
- references/experiment-card-format.md: full markdown schema
  with filled example (Anna-Tauschboerse pilot, 14 days,
  measurable thresholds).

Tools: includes WebFetch + WebSearch for inline interview-
technique research; rest unchanged from the workflow-skill
default set.
2026-05-19 01:32:43 +02:00
Philipp Sieder 571bbe2084 feat(i2s-recherche): extract from monolith
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).
2026-05-19 01:29:57 +02:00
Philipp Sieder 1233d7d0a6 feat(i2s-persona): extract from monolith
Step 6 of i2s-skill-split refactor. Third atomic sub-skill.

Contents:
- SKILL.md: 5 numbered phases with precondition check
  (## Problem-Statement required, > 100 chars). description scoped
  to Persona/JTBD/Gains triggers with explicit anti-triggers.
- workflows/persona.md: full 5-step workflow with 5 TAs +
  anti-patterns + facilitation heuristics (git mv from monolith,
  required_reading paths updated).
- references/kommunikationsregeln.md: curated extract
  (persona-specific dialog heuristics: stereotype-vs-segment,
  JTBD-contains-solution, demografie-ohne-verhalten).
- references/persona-format.md: curated extract from
  plugin-shared/export-formate.md, persona_format block. Includes
  filled example (Anna Berger, 38, Leipzig).

Tools: Read, Write, Edit, Glob, Grep, AskUserQuestion, TodoRead,
TodoWrite. No WebFetch/WebSearch (inline-recherche limited to
berufsbezeichnungen / lebensstil — full recherche lives in
i2s-recherche).
2026-05-19 01:26:39 +02:00
Philipp Sieder 127bba5af3 refactor(router): apply quality-checklist HIGH fixes
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.
2026-05-19 01:23:35 +02:00
Philipp Sieder 6067d2ba0e feat(i2s-problem-statement): extract from monolith
Step 5 of i2s-skill-split refactor. Second atomic sub-skill.

Contents:
- SKILL.md: 5 numbered phases (load context, 7 TAs, consistency,
  3 variants, export). description with explicit HMW/Problem-Statement
  triggers, anti-triggers naming klarheit-mit-idea2self (router),
  i2s-discovery, i2s-persona. Precondition check formalized.
- workflows/problem-statement.md: full workflow (git mv from monolith,
  rename detection preserved, required_reading paths updated to local
  curated refs).
- references/kommunikationsregeln.md: curated (PS-specific dialog
  heuristics: loesung-vs-problem, "alle als zielgruppe", widerspruch
  zu idee).
- references/problem-statement-format.md: curated extract from
  plugin-shared/export-formate.md, problem_statement_format block.
  Includes versions header rules and a filled example.
- references/artefakt-pipeline.md: curated (pipeline position +
  rueckwaerts-updates rules for PS -> ## Idee back-propagation).

Tools: Read, Write, Edit, Glob, Grep, AskUserQuestion, TodoRead,
TodoWrite. (No WebFetch/WebSearch — recherche lives in i2s-recherche.)
2026-05-19 01:16:01 +02:00
Philipp Sieder c56093405f feat(i2s-discovery): extract from monolith
Step 4 of i2s-skill-split refactor. First atomic sub-skill extracted
from klarheit-mit-idea2self monolith.

Contents:
- SKILL.md: routing-pattern entry, 5 numbered phases (orientation,
  vertiefung, widerspruchspruefung, bestaetigung, datei-bootstrap)
  with entry/exit criteria. Description scoped to discovery triggers
  with explicit anti-triggers naming sibling i2s-* skills.
- workflows/discovery.md: full 5-step interview (git mv from
  klarheit-mit-idea2self/workflows/discovery-idea.md, rename
  detection preserved).
- references/kommunikationsregeln.md: curated extract from
  plugin-shared (tonality, markers, control commands,
  discovery-specific dialog heuristics, export rule).
- references/idee-format.md: curated extract from
  plugin-shared/export-formate.md, idee_format block only.
- templates/idea2self-vorlage.md: full copy from plugin-shared
  (this Skill bootstraps the idea2self-file in Phase 5).

Tools: Read, Write, Edit, Glob, Grep, AskUserQuestion, WebFetch,
WebSearch, TodoRead, TodoWrite.
2026-05-19 01:13:18 +02:00
Philipp Sieder 3479384600 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.
2026-05-19 01:10:07 +02:00
Philipp Sieder de85d675a2 chore(plugin): commit baseline plugin state pre-refactor
Baseline commit before splitting klarheit-mit-idea2self into router +
7 atomic workflow-skills. Captures the monolithic skill (1.671 LOC,
8 workflows, 5 references, 2 templates) as the starting point so
subsequent steps can use git mv with rename detection.

Files added:
- .claude-plugin/plugin.json + marketplace.json
- README.md (plugin overview, ex-skills/README.md)
- skills/klarheit-mit-idea2self/ (full monolith)

Refactor tracked in parent repo: DEC-0010,
agentbrain/memory/plans/engineering/2026-05-19-i2s-skill-split.md.
2026-05-19 01:05:02 +02:00