How-to (contributor & maintainer tasks)
Step-by-step runbooks for the recurring tasks of contributing to and maintaining Spec Kitty. Each page is scoped to one job you can pick up and finish.
- Landing contributor PRs — the claim → isolate → rebase → classify → fold → squad → hand-off maintainer runbook.
- Review gates: pre-PR / pre-review checklist — the hygiene steps to run locally before requesting review.
- Local overrides for cross-package development — dev-only editable installs across
spec-kitty-cli/-events/-trackerthat must never be committed. - Managing the issue tracker — epics vs. meta-trackers, native sub-issue parenting, and triage conventions.
- Contract pinning workflow — pinning the
spec-kitty-eventsenvelope contract in tests. - Cut-over guard: fail-closed pre-merge gate — what
spec-kitty cutover-guardchecks, how it is wired into CI, and how to register it as a required status check. - Create a doctrine artifact — author a new doctrine artifact end to end, including the loose-contract asset kind.