Skip to content

feat(contribution-model): publish governance docs + wire contributor skills#10

Merged
efordee24 merged 1 commit into
mainfrom
feature/contribution-model
Jun 23, 2026
Merged

feat(contribution-model): publish governance docs + wire contributor skills#10
efordee24 merged 1 commit into
mainfrom
feature/contribution-model

Conversation

@efordee24

Copy link
Copy Markdown
Collaborator

What

Publishes the finalised Kuat contribution model (decisions resolved by Ed, 19 Jun 2026) and wires the Phase-7 contributor skills into it — so the federated EE network knows what to contribute, how, and who reviews it. Executes docs/migration/contribution-model-rollout-prompt.md; kuat-agent-rules scope only (the kuat-mono half is handed off).

New docs

  • CONTRIBUTING.md — front door: hybrid model, contribution-vs-participation, the four sizes (Fix/Light/Medium/Heavy), the 5-step process, the Slack #design-system request step, links into contribute/.
  • contribute/overview.md (canonical model, adapted from kuat-contribution-model.md §1–7 incl. the review-everything-now → relax-later posture and the surface→skill→gate table); six per-type "Proposing a…" pages (component, token change, reference change, slide asset, icon/image, skill) each naming size · skill · gate · Slack step; decision-log.md seeded from the seed (append-only); deprecation-guidelines.md stub flagging the Phase-5 fast-follow.
  • docs/migration/report-contribution-model.md — execution report; plus the source inputs (rollout prompt, model, decision-log seed) carried into the repo.

Wiring

  • AGENTS.md gains a Contributing subsection linking the model.
  • All 7 .claude/skills/*/SKILL.md get a ## Related pointer mapping each skill to its size · surface and its proposing-page.

Why

Phase 7 built the contributor skills + gates; this publishes the governance layer that tells contributors how to use them. Folds the contribution-model slice of Phase 5 into a concrete, skill-backed workflow.

Reviewer notes

  • Guardrail: governance docs live top-level in contribute/, not under reference/ — so they never bundle into a consumer plugin and don't trip the passive-reference gate. build-plugin.mjs only snapshots reference/ + skills, so contribute/ is excluded by construction.
  • Gates green: verify:plugins ALL CHECKS PASSED (7 repo-local skills kept out, reference snapshot unchanged); grep confirms no contribute/ in either payload; reference:check green with 0 changed reference files; link sweep 0 broken across 18 touched files.
  • No plugin payload changes — incidental rebuild restamps were reverted to keep the diff focused.
  • Handoff: kuat-mono needs its own branch for a focused CONTRIBUTING.md (component + downstream token regen, linking back to the canonical contribute/overview.md here) + an AGENTS.md link — see the report's Follow-ups.

🤖 Generated with Claude Code

…skills

Publish the finalised Kuat contribution model (decisions resolved 19 Jun 2026)
and wire the Phase-7 contributor skills into it, so the federated EE network
knows what to contribute, how, and who reviews it.

- CONTRIBUTING.md (front door) + contribute/ section: overview (model §1-7),
  6 per-type "Proposing a..." pages, seeded decision log, deprecation stub
- AGENTS.md gains a Contributing link
- Each .claude/skills/* SKILL.md points at its size/surface path in the model
- Carry the source inputs (rollout prompt, model, decision-log seed) + report

Governance docs live top-level in contribute/ (not reference/) so they never
bundle into a consumer plugin and don't trip the passive-reference gate.
verify:plugins and reference:check stay green; contribute/ excluded from
payloads by construction. kuat-agent-rules scope only; kuat-mono half handed off.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@efordee24 efordee24 merged commit dc13997 into main Jun 23, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant