openspec-onboard

OpenSpec onboarding is guided interactively by performing a complete change cycle on a real codebase. This hands-on approach walks new developers through task selection, artifact creation, implementation, and archiving to ensure practical learning in under 30 minutes.

The OpenSpec workflow cycle encompasses exploring, proposing, specifying, designing, implementing, and archiving codebase changes. It provides a structured development lifecycle that ensures all artifacts are properly created and tracked from initial task selection to final archiving.

You create proposals and specs by following the guided OpenSpec workflow, which assists in generating required artifacts like design documents and tasks. This interactive process ensures you understand each step while performing real operations on your project.

Yes, you need an existing codebase because the onboarding experience performs actual operations on your project to reinforce learning through practice. Working with a real, small task in your project provides the contextual narration needed to understand the development lifecycle.

Yes, this onboarding is designed for new developers joining teams using OpenSpec. It helps them understand the entire development lifecycle from commit to archive by using a real task in their project, making it ideal for team integration.

The interactive onboarding focuses on a single, complete change cycle with a small task to keep the learning experience under 30 minutes. It is an introductory guide and does not cover advanced, complex, or multi-branch workflow scenarios outside the standard archiving lifecycle.