openspec-onboard

OpenSpec onboarding workflow is a structured process guiding teams through a complete cycle from exploration to archival. It covers preflight checks, task selection, proposal creation, and specs design, ensuring safe and repeatable hands-on learning.

Guide new contributors by applying an EXPLAIN → DO → SHOW → PAUSE rhythm. This structured flow walks them through preflight, explore/demo, create/change, and apply phases, enforcing guardrails to keep learning safe and repeatable.

Yes, you can use this workflow for codebase walkthroughs. It applies to onboarding new contributors and hands-on tutorials, providing in-codebase guided tasks that explain each step and reflect real-world engineering workflows.

The best way to run a safe OpenSpec tutorial is using built-in guardrails and pause points. These ensure learning without breaking the project, providing a structured flow from preflight checks through to archival.

Yes, you need to run openspec init to set up the project before starting the onboarding flow. This setup allows you to walk through a complete OpenSpec cycle from task selection to archiving.

If an onboarding workflow is interrupted, it includes graceful exit handling. This ensures the structured learning flow can safely stop or resume without breaking the project or losing the tutorial's repeatable state.