2
0
Files
agent-skills/plugin-shared/README.md
T
Philipp Sieder 7cf1c7c61e chore(plugin): scaffold plugin-shared developer master
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.
2026-05-19 01:05:14 +02:00

2.1 KiB

plugin-shared/ — Developer Master

Single source of truth for cross-skill references and templates used by the klarheit-mit-idea2self plugin (router + 7 atomic i2s-* workflow-skills).

Why this exists

Each Skill in this plugin is self-contained — its references/ and templates/ directories are read by Claude when the Skill activates. Per the workflow-skill design rules (no reference chains, no hardcoded cross-skill paths), Skills must not reach across boundaries to read shared content at runtime.

This directory holds the canonical, full versions of all shared content. Each Skill carries curated extracts in its own references/. To keep the extracts honest, drift-check.sh compares each Skill's copy against the relevant slice of the master here.

Contents

File Used by
artefakt-pipeline.md router, all i2s-* (defines the idea2self-Datei state machine)
kommunikationsregeln.md all i2s-* (tonality, markers, control commands)
methodik.md per-skill extracts (Design Thinking / Lean Startup / WOOP slices)
recherche-regeln.md i2s-recherche
export-formate.md per-skill extracts (one format block per Skill output)
templates/idea2self-vorlage.md router (file bootstrap), i2s-discovery
templates/prototyp-remixer-auswertung.md i2s-prototyp-konzept

Workflow

  1. Edit content here in plugin-shared/ as the canonical source.
  2. Propagate relevant slices into the corresponding Skill's references/.
  3. Run drift-check.sh to verify no Skill has fallen behind the master.

Direct runtime references from a Skill into plugin-shared/ are forbidden — they violate AP-3 (Reference Chains) and AP-4 (Hardcoded Paths) from the workflow-skill design guide.

Refactor history

Created 2026-05-19 during the split of the monolithic klarheit-mit-idea2self Skill (1.671 LOC, 1 Skill) into a router + 7 atomic Skills. See plan agentbrain/memory/plans/engineering/2026-05-19-i2s-skill-split.md in the parent repo and DEC-0010 in agentbrain/memory/insights/decision-log.md.