openspec-onboard

To onboard an existing codebase with OpenSpec, run the guided workflow from your project root. It walks through preflight, exploration, proposal, specs, design, tasks, apply, and archive phases to generate repeatable artifacts.

The OpenSpec change-management workflow is a structured, end-to-end process for managing codebase changes. It enforces a defined artifact suite including proposal.md, design.md, specs/, tasks.md, and archive to ensure safe, auditable modifications.

Yes, you need a compatible OpenSpec CLI to use this onboarding guide. The workflow relies on the CLI to execute real tasks in your repository safely while providing narrated, hands-on coding practice.

The OpenSpec onboarding workflow generates a defined artifact suite comprising proposal.md, design.md, specs/, tasks.md, and an archive. These reusable templates structure your project changes from setup to completion.

Yes, you can use this OpenSpec tutorial for a new project. The hands-on onboarding guide is applicable to both new projects and existing codebases, walking you through a full guided workflow with real tasks.

Use a structured specification workflow to reduce onboarding friction and ensure safe, auditable learning. It provides step-by-step guidance through proposal, design, and task phases, generating repeatable artifacts for any project.