openspec-onboard

To onboard your team to the OpenSpec workflow, this guide walks users through a complete change cycle end-to-end, performing hands-on practice directly within your real repository. It creates a change container and guides you through proposal, specs, design, tasks, and archiving.

The best way to learn OpenSpec specifications is through artifact-driven learning, which guides you to perform real work in your repository while selecting small tasks. This enforces a structured workflow with explicit artifacts and guardrails to preserve decisions.

Yes, OpenSpec onboarding specifically targets small, real-codebase tasks and teaches through incremental artifact creation. It guides users step-by-step through task selection, proposal drafting, spec design, and task execution.

You can preserve decisions during OpenSpec change management by reusing the generated proposal, specs, design, tasks, and archive artifacts. This structured workflow ensures a clear restore path and enables future learning from past changes.

The guided OpenSpec workflow focuses on small, real-codebase tasks to ensure manageable hands-on education. It is not designed for large-scale migrations, as it enforces structured guardrails and explicit artifacts tailored for incremental change cycles.