Guides
Durable contributor and maintainer how-tos and workflow guides — task-oriented
pages that outlive any single mission. For effort-scoped working notes
(audits, debriefs, investigations) see ../plans/.
Contributor guides
- Test-flakiness handling policy — detection tiers and the never-retry-to-green rule.
- Running the test suite in parallel — the parallel-run workflow and volume gates.
- Contract pinning workflow — pinning observable contracts in tests.
- Review gates — the pre-PR / pre-review checklist.
- Local overrides for cross-package development — dev-only editable installs that must never be committed.
Maintainer guides
The split rule: guides are repo-workflow how-tos regardless of audience; run-the-system runbooks live in operations.
- Landing contributor PRs — the claim → isolate → rebase → classify → fold → squad → hand-off runbook, with field-tested gotchas.