docs: add CONTRIBUTING.md#371
Conversation
Documents the end-to-end contributor workflow (issue -> branch -> develop -> quality-check -> changeset -> PR -> review -> release), updated to reflect the current skills/CI setup: the check-licenses workflow and the in-repo api-design-review skill, and removing a reference to a personal board-issue skill that isn't checked into this repo. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
There was a problem hiding this comment.
Overall this looks good, but how do we manage the relationship between this and CLAUDE.md?
Some information looks overlapped
There was a problem hiding this comment.
Yep good point. We should have CLAUDE.md refer to CONTRIBUTING.md as an include so it is ensured to be read. I think a more human-friendly CONTRIBUTING is useful, as I did not find all the processes clear and intuitive when I came back to work on AppShell a few weeks ago
Addresses review feedback: the doc was re-documenting mutable rules from add-component/quality-check skills and CI trigger mechanics inline, which had already drifted (the CI table claimed `push` triggers when both ci-packages.yaml and ci-e2e.yaml are pull_request-triggered, and the e2e env var list was missing VITE_TAILOR_AI_GATEWAY_URL). Every section that duplicated a skill/workflow's content now points at it instead. Also link CLAUDE.md -> CONTRIBUTING.md so agents are guaranteed to read the contributor workflow doc, per review discussion. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
Thanks both — re-evaluated based on the common thread across these comments: the doc was re-documenting mutable rules (add-component's house rules, quality-check's procedure, CI trigger mechanics, four reference tables) that live authoritatively elsewhere, and it had already drifted as a result — the CI table said Pushed a trim (7ed1d16) that keeps the narrative/lifecycle framing but replaces every restated rule/table with a pointer to its source of truth ( |
- Fold the duplicated CLAUDE.md positioning note into the intro so CLAUDE is characterized once, not in two back-to-back paragraphs. - Replace the restated pnpm install/dev + version-pinning block in §1 with a pointer to README's Development section (the canonical home for commands); keep the repo-layout table, which README lacks. - Drop CLAUDE.md's redundant "Local Development" block (it already points to README for commands just above). - Fix stale fact: packages/core builds with Vite, not tsup. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
|
One more last thing: I found README.md also has mention to development setup, so let's trim that all out, and just add a link to CONTRIBUTION.md. Lines 30 to 71 in 78b182b |
Summary
CONTRIBUTING.mddocumenting the end-to-end contributor lifecycle (issue → branch → develop → quality-check → changeset → PR → review → release), sourced from a previously-drafted (stashed) version.check-licensesCI workflow (introduced in ci: add check-licenses workflow #353) to the CI table and CI/CD workflow reference.api-design-reviewskill (.agents/skills/api-design-review/) alongside the existing Copilot prompt./board-issuecommand reference — that's a personal Claude Code skill some contributors have installed locally, not something checked into this repo, so the doc now describes filing on the project board generically instead.Test plan
pnpm exec oxfmt --check CONTRIBUTING.mdpasses