Developer Workflow and Quality Gates
Local Developer Loop
Section titled “Local Developer Loop”- Run app locally (
npm run dev). - Make focused changes by route/section.
- Run lint/tests as needed.
- Commit only after pre-commit checks pass.
CI/CD Workflow
Section titled “CI/CD Workflow”- Lint workflow validates JavaScript quality on pushes.
- Deploy workflow can manually deploy selected branch/environment to Vercel.
Why this matters
Section titled “Why this matters”For non-technical readers: quality gates prevent avoidable defects from reaching users.
For technical readers: consistent linting and controlled deploy paths reduce merge/deploy risk.
Documentation Maintenance Rule
Section titled “Documentation Maintenance Rule”When features change, update relevant docs in the same branch/PR:
- architecture-level changes ->
architecture/* - route/feature behavior changes ->
codebase/* - release/process changes ->
operations/*