openspec-onboard

You can learn the OpenSpec change lifecycle through a guided onboarding workflow that walks you through preflight, task selection, change creation, proposals, specs, design, tasks, apply, and archive phases with hands-on tasks.

The best way to teach OpenSpec change management is using a structured onboarding guide that enforces an EXPLAIN/DO/SHOW/PAUSE protocol, allowing users to perform real OpenSpec actions in a sample codebase while learning each step safely.

Yes, OpenSpec onboarding tutorials can be run in your own codebase. The guided workflow lets you perform real OpenSpec actions and stores all learning artifacts under the openspec/changes directory during the walkthrough.

Yes, the OpenSpec CLI is required for the onboarding workflow. The guided process relies on the OpenSpec CLI to create changes, manage proposals, and archive completed tasks throughout the structured lifecycle walkthrough.

The EXPLAIN/DO/SHOW/PAUSE protocol structures the onboarding by explaining each step, having you do the action, showing the result, and pausing for your acknowledgement before proceeding to the next phase or allowing a graceful exit.

A limitation of OpenSpec guided onboarding is that it requires manual user interaction at each pause phase, meaning it cannot be fully automated, and it depends entirely on the OpenSpec CLI for creating and archiving changes.