Skip to content

docs(framework): add plugin concern taxonomy and skill placement rules#248

Merged
blafourcade merged 1 commit into
mainfrom
docs/plugin-concern-taxonomy
Jun 6, 2026
Merged

docs(framework): add plugin concern taxonomy and skill placement rules#248
blafourcade merged 1 commit into
mainfrom
docs/plugin-concern-taxonomy

Conversation

@alexsoyes
Copy link
Copy Markdown
Contributor

@alexsoyes alexsoyes commented Jun 6, 2026

🎯 What & why

Neither doc said which plugin a new capability belongs to - the concern taxonomy was only implicit in each plugin.json. This makes placement decidable: a canonical taxonomy plus the rules that follow from it.

🛠️ How it works

  • docs/ARCHITECTURE.md:82 - new "Plugin concerns and layers": a concern/layer table for the 6 plugins, then three rules - knowledge vs execution is a firewall, the concern decides placement (not whether a skill exists yet), and orchestration = sequencing across multiple concerns (delegating one sub-step does not make a skill an orchestrator).
  • docs/CREATE_PLUGIN.md:7 - new "Adding a skill to an existing plugin": which plugin (by concern, linking the taxonomy) and which number (<NN> encodes logical pipeline order, with the renumbering cost called out).
  • CLAUDE.md:19 - points at the taxonomy in ARCHITECTURE.md instead of restating it, so the "never duplicate, link to the canonical home" rule holds.

The taxonomy lives in ARCHITECTURE.md as the single source; the other two link to it. Docs-only - no skill, manifest, or catalog touched.

🧪 How to verify

  • Open docs/CREATE_PLUGIN.md:7 and follow the "concern taxonomy" link; it resolves to the new ARCHITECTURE.md section.

✅ I certify

  • Docs updated to match the new behaviour.
  • I self-reviewed this PR.
  • No cross-plugin references introduced.

🤖 Generated with Claude Code

Document the concern/layer taxonomy as the canonical reference in ARCHITECTURE.md, add a 'concern decides placement, not existence' rule and an orchestration criterion, and a CREATE_PLUGIN section on placing/numbering a skill in an existing plugin. Tighten CLAUDE.md to point at the canonical home instead of restating it.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Signed-off-by: alexsoyes <contact.alexsoyes@gmail.com>
@alexsoyes alexsoyes requested a review from a team as a code owner June 6, 2026 09:55
@alexsoyes alexsoyes added the documentation Improvements or additions to documentation label Jun 6, 2026
@blafourcade blafourcade merged commit c6b474f into main Jun 6, 2026
10 checks passed
@blafourcade blafourcade deleted the docs/plugin-concern-taxonomy branch June 6, 2026 11:58
@aidd-bot aidd-bot Bot mentioned this pull request Jun 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants