Engineering Workflow

Branch and PR expectations

• Keep PRs scoped to one feature or one risk area.
• Run npm run typecheck and npm run build before creating a PR.
• If worker logic changed, run npm run worker or targeted job tests.

Required docs updates per PR

1. Update any impacted root source specs.
2. Update relevant pages under content/docs/.
3. Add or modify an ADR in docs/decisions/ for architecture/tooling changes.

Use .github/pull_request_template.md as the merge gate checklist.

Local docs preview

npm run docs:dev