Context
The kit's entire value proposition is "improve centrally, propagate via
/plugin marketplace update." Yet there is no documented contract for extending it,
and the versions have already drifted: marketplace.json metadata.version is 1.0.0
while pipeline is 1.4.0, knowledge 1.1.0, stack-go 1.1.0, stack-flutter
1.0.0 — with no stated policy for what a bump means or how a consuming project knows to
update. Since the plan is to keep expanding this, the authoring path needs to be written
down before contributors (including future-me on another machine) diverge.
Proposal
Add CONTRIBUTING.md covering:
- Adding a skill — directory +
SKILL.md frontmatter contract: when to use
paths:-scoped loading vs description-matched loading, and how to write a description
that actually triggers.
- Adding an agent — frontmatter (
name, description with examples, model,
color, memory), and the role-boundary discipline the four current agents follow.
- Adding a stack — the full checklist: new plugin,
templates/<stack>/ dir,
sync-permissions/stack-<x>.json, install.sh case, marketplace.json entry.
- Make
install.sh's stack set data-driven (derive from templates/*/ or a small
manifest) so adding a stack is not "edit the hardcoded go|flutter case in a shell
script."
- Version & release policy — when to bump a plugin version vs the marketplace
version, whether marketplace.json metadata.version tracks anything, a
CHANGELOG.md, and optional git tags per release.
Acceptance criteria
Context
The kit's entire value proposition is "improve centrally, propagate via
/plugin marketplace update." Yet there is no documented contract for extending it,and the versions have already drifted:
marketplace.jsonmetadata.versionis1.0.0while
pipelineis1.4.0,knowledge1.1.0,stack-go1.1.0,stack-flutter1.0.0— with no stated policy for what a bump means or how a consuming project knows toupdate. Since the plan is to keep expanding this, the authoring path needs to be written
down before contributors (including future-me on another machine) diverge.
Proposal
Add
CONTRIBUTING.mdcovering:SKILL.mdfrontmatter contract: when to usepaths:-scoped loading vs description-matched loading, and how to write a descriptionthat actually triggers.
name,descriptionwith examples,model,color,memory), and the role-boundary discipline the four current agents follow.templates/<stack>/dir,sync-permissions/stack-<x>.json,install.shcase,marketplace.jsonentry.install.sh's stack set data-driven (derive fromtemplates/*/or a smallmanifest) so adding a stack is not "edit the hardcoded
go|fluttercase in a shellscript."
version, whether
marketplace.jsonmetadata.versiontracks anything, aCHANGELOG.md, and optional git tags per release.Acceptance criteria
CONTRIBUTING.mdmerged with the three "how to add X" sections.(and the current drift reconciled or explicitly declared independent).
install.shno longer hardcodes the stack list — or the guide names the singleplace to edit when adding one.
CHANGELOG.mdseeded.