2
0

2 Commits

Author SHA1 Message Date
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 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