Development Workflow

Owner: Engineering
Reviewers: Tech Leads, QA
Status: Draft
Version: 0.1
Last Updated: 2026-09-16
Review Cycle: Per workflow change

Local Workflow

1. Create a branch using the approved naming convention.
2. Run the relevant local service:
   • Backend: npm run start:dev from backend/.
   • Web: npm run dev from web/.
   • Mobile: npm run start from mobile/.
   • Integrated stack: docker compose up.
3. Update code, tests and documentation together.
4. Run lint/build/test checks for touched surfaces.
5. Open a PR into the correct target branch.

Surface References

• Backend architecture: ../current/architecture/backend-architecture.md
• Web workflow: ../current/workflows/web-feature-workflow.md
• Web conventions: ../current/conventions/web-coding-conventions.md
• Mobile conventions: ../current/conventions/mobile-coding-conventions.md
• IoT local guide: ../current/workflows/iot-local-build-guide.md