22.2 Spec-first workflow
Observable behavior changes start in platform-spec, not in a surprise PR comment thread.
Spec-first workflow
Spec leads code: extend or update normative platform-spec text before (or in the same change set as) implementation that changes observable language or platform behavior.
Practical rules
Section titled “Practical rules”- Do not mark scaffold-only hubs as Standard to win an argument.
- Prefer updating existing feature hubs over spawning duplicate stubs.
- Run
cd site/website && bun run verify:trudoc -- --preset ciafter platform-spec edits.