# 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`.