Philipp Sieder
7cf1c7c61e
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.
47 lines
2.1 KiB
Markdown
47 lines
2.1 KiB
Markdown
# 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`.
|