Nest Engineering Docs
Processes

Change Management

How changes are proposed, reviewed, and approved.

Purpose

Provide a consistent path from idea to production change.

Required artifacts

  • Linear project or issue with owner, scope, and priority.
  • Design or technical approach when impact is medium/large.
  • Risk assessment and rollback plan for production changes.
  • Documentation updates when behavior or API changes.

Procedure

  1. Draft the change in Linear with scope, dependencies, and success criteria.
  2. Confirm the work is scoped and scheduled in the project plan.
  3. Implement in a focused PR with tests and doc updates.
  4. Review for risk, schema impact, and backwards compatibility.
  5. Merge, then deploy via the standard release pipeline.
  6. Publish status updates in the Linear project (Pulse) as work progresses.

Last updated on