devbook-openspec

Fold an accepted change into the devbook — check both gates, merge every delta into the chapter it targets with devbook's delta.mjs, then let openspec archive move the change folder to openspec/changes/archive/<date>-<name>/. Refuses a change that is not accepted or whose acceptance has lapsed. Use when: a change is accepted and ready to land, "archive this change", "merge the deltas", "close out the change". Never openspec archive alone: it moves the folder and merges nothing.

Bring the change lane into a repository for the first time — check the OpenSpec CLI against the supported range, run openspec init at the repository root, write the managed devbook schema and a seeded openspec/config.yaml, remove the specs/ folder the CLI scaffolds, install the change-folder rule with a wrapper per host, and stamp components.openspec in .devbook/config.json. Never installs the CLI. Refused where components.openspec already exists: run devbook-openspec:update. Use when: adopting OpenSpec over a devbook, setting up the change lane. Triggers on: "devbook-openspec init", "install devbook-openspec", "set up OpenSpec here", "adopt the change lane".

Walk a person through their first change in the change lane, one move at a time — pick a small real change, propose it with OpenSpec as devbook deltas, approve it, build its steps, verify, accept, and archive — saying at each stop what happened on disk and who acts next. Use when: new to the change lane, "how do I make a change with OpenSpec here", "walk me through a first change", "onboard me to OpenSpec". Triggers on: "devbook-openspec onboard", "first change", "show me the lane".

Return an approved change's specification unchanged — its proposal, the deltas a step delivers, its solution, and the step itself — for a run to build from, and refuse a change whose proposal is not approved or whose approval has lapsed. The provider an engine binds at its spec point as "devbook-openspec:spec". Use when: a run builds one step of a change under openspec/changes/, "what does this step have to build", "hand me the approved spec for step N". Writes nothing.

Report where a change under openspec/changes/ stands in one table — OpenSpec's artifact progress, every step's state, the verify-change verdict for every delta, and both gates, approval and acceptance, each with whether its fingerprint still holds — and name the one next move. With --replan, the engine's flow.start chore: re-check one change's deltas, open steps, and related chapters against main and fail on any flag. Writes nothing. Use when: "where is this change", "what is left before I can accept it", "can this change be archived", "is the approval still current", or before devbook-openspec:archive. Triggers on: "devbook-openspec status", "change status", "status of the change", "does the plan still hold", "replan".

Keep a change's tasks.md as its work items — read a step, set its state and tick its tasks, or leave a note on it — for an engine that binds its tracker as { "provider": "devbook-openspec:tracker" }. Implements read_item, update_item, and comment over the steps of openspec/changes/<name>/tasks.md, with the four step states open, in progress, in review, and done read off the step's branch and pull request — or, under single-branch, where a step is a commit, off its ticks. Use when: a run reads or updates the step it is building, "which steps of this change are merged", "mark step 2 in review".

Move a repository's change lane forward after upgrading devbook-openspec or the OpenSpec CLI — check the CLI against the stamped range, run openspec update, replace the devbook schema and the change-folder rule wherever they still hash to what this plugin wrote, report the customized ones, and re-stamp components.openspec. Never rewrites openspec/config.yaml. Refused where no components.openspec stamp exists: run devbook-openspec:init. Use when: upgrading devbook-openspec, a new OpenSpec release, the schema or rule is stale. Triggers on: "devbook-openspec update", "update devbook-openspec", "upgrade the change lane", "openspec update".