Skip to content

Run a spec change end-to-end

This runs a single change through the whole lifecycle with the OpenSpec framework.

Cut a feature branch from your base, named for the change:

Terminal window
git checkout -b feat/add-chime-presets

Generate the artifacts — proposal, design, tasks — and review them before any code:

/opsx:propose add-chime-presets

Commit the artifacts:

Terminal window
git commit -m "feat(add-chime-presets): create openspec proposal artifacts"

Implement the tasks. Each commit references the change name:

/opsx:apply add-chime-presets
git commit -m "feat(add-chime-presets): wire up preset picker UI"

Run tests, type checks, and a smoke pass:

/opsx:verify add-chime-presets

Promote the spec delta into the live spec and land the archive commit on the same branch, before the PR:

/opsx:archive add-chime-presets
git commit -m "chore(add-chime-presets): archive change"

One pull request covers proposal, apply, verify, and archive:

Terminal window
git push -u origin feat/add-chime-presets

That is the whole arc: one change, one branch, one PR, with the proposal and the record landing alongside the code.