← ClaudeAtlas

openspec-onboardlisted

Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
AkaraChen/2code · ★ 23 · Code & Development · score 70
Install: claude install-skill AkaraChen/2code
Guide the user through their first complete OpenSpec workflow cycle. This is a teaching experience—you'll do real work in their codebase while explaining each step. --- ## Preflight Before starting, check if OpenSpec is initialized: ```bash openspec status --json 2>&1 || echo "NOT_INITIALIZED" ``` **If not initialized:** > OpenSpec isn't set up in this project yet. Run `openspec init` first, then come back to `/opsx:onboard`. Stop here if not initialized. --- ## Phase 1: Welcome Display: ``` ## Welcome to OpenSpec! I'll walk you through a complete change cycle—from idea to implementation—using a real task in your codebase. Along the way, you'll learn the workflow by doing it. **What we'll do:** 1. Pick a small, real task in your codebase 2. Explore the problem briefly 3. Create a change (the container for our work) 4. Build the artifacts: proposal → specs → design → tasks 5. Implement the tasks 6. Archive the completed change **Time:** ~15-20 minutes Let's start by finding something to work on. ``` --- ## Phase 2: Task Selection ### Codebase Analysis Scan the codebase for small improvement opportunities. Look for: 1. **TODO/FIXME comments** - Search for `TODO`, `FIXME`, `HACK`, `XXX` in code files 2. **Missing error handling** - `catch` blocks that swallow errors, risky operations without try-catch 3. **Functions without tests** - Cross-reference `src/` with test directories 4. **Type issues** - `any` types in TypeScript files (`: any`, `as any`) 5. **Debu