openspec-onboard

You can learn the OpenSpec workflow through a guided, hands-on onboarding experience that walks you through a complete change cycle with real codebase work, narration, and safe incremental tasks. It covers preflight checks, proposals, specs, design, and archiving.

The OpenSpec change workflow cycle moves from idea to implemented change using specific artifacts: proposals, specs, design documents, and tasks. It includes preflight checks, task selection, applying changes, and archiving completed work.

To start onboarding, run the /opsx:explore command and follow the prompts to create a new change and draft the required onboarding artifacts. This initiates a structured, narrated process for practicing the workflow safely.

Yes, this onboarding process provides real-codebase practice with narrated explanations and safe, incremental tasks. It includes clearly defined guardrails to ensure you learn the end-to-end workflow without risking uncontrolled changes.

The workflow steps include preflight checks, task selection, proposal drafting, creating specs, design, defining tasks, applying changes, and archiving. Each step produces specific artifacts to guide developers from initial idea to implemented change.

No prior experience is needed. The onboarding is designed for new users or teams learning OpenSpec, providing a structured, hands-on process with clear artifacts and guardrails to teach the complete end-to-end change workflow from scratch.