- Never work directly on
mainordev. - Reuse the current issue branch when one already exists; otherwise create a
feature/,fix/,chore/,refactor/, ortest/branch. - Keep the matching Linear issue in sync with scope, blockers, review, and completion state.
- Make small interstitial commits that explain why a change exists.
- Add deterministic unit and integration tests with every behavior change.
- Run the relevant TypeScript, Swift, Kotlin, Rust, container, migration, and accessibility checks before review.
- Never add secrets, provider tokens, signing material, or user content.
- Do not promote Development to Production or change production DNS without explicit approval.
Pull requests must describe the intent, implementation, verification evidence, risks, migrations, external provisioning, and rollback path.