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
parent de85d675a2
commit 7cf1c7c61e
8 changed files with 839 additions and 0 deletions
@@ -0,0 +1,46 @@
+# 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`.