Remindme

# Code Lab Commands Reference

## Step Development Commands

### `/create-step-[n]`
Create new step branch with STEP[n].md, tests, and SOLUTION[n].md template

**Usage**: `/create-step-2`, `/create-step-3`, etc.

**What it does**:
- Creates `step-[n]` branch from main
- Creates STEP[n].md with content from LAB_OPPORTUNITY.md
- Creates src/__tests__/step-[n]/ directory
- Creates SOLUTION[n].md template
- Commits initial step structure

---

### `/add-solution-[n]`
Fill solution file, apply changes, and verify tests pass

**Usage**: `/add-solution-2`, `/add-solution-3`, etc.

**What it does**:
- Reads STEP[n].md tasks
- Implements the solution code
- Updates SOLUTION[n].md with exact changes
- Runs tests to verify solution works
- Commits solution

---

### `/apply-solution-[n]`
Apply existing solution from SOLUTION[n].md file

**Usage**: `/apply-solution-2`, `/apply-solution-3`, etc.

**What it does**:
- Reads SOLUTION[n].md
- Applies the documented changes to codebase
- Runs tests to verify solution
- Does NOT create new commits (learner will commit)

---

### `/test-step-[n]`
Run validation tests for step n

**Usage**: `/test-step-2`, `/test-step-3`, etc.

**What it does**:
- Runs xUnit tests tagged with @n.1, @n.2, etc.
- Shows which tasks are complete/incomplete
- Provides clear error messages for failing tests

---

### `/add-tests-[n]`
Generate tests for tasks in STEP[n].md that don't have tests yet

**Usage**: `/add-tests-3`, `/add-tests-4`, etc.

**What it does**:
- Analyzes [TASK] sections in STEP[n].md
- Checks existing test files for @n.x patterns
- Generates xUnit tests for missing tasks
- Uses file content validation and AST analysis
- Creates clean, actionable error messages

---

### `/learner-step-by-step-[n]`
Simulate learner experience with progressive test feedback

**Usage**: `/learner-step-by-step-4`

**What it does**:
1. Reset step to incomplete state
2. Run @n.1 test → Show error message
3. Apply minimal fix for that task only
4. Run test again → Show next error message
5. Continue incrementally through all tasks
6. Demonstrate each test message and solution until all pass

---

## Quick Workflow

1. **Create step**: `/create-step-2`
2. **Add tests**: `/add-tests-2` (if needed)
3. **Implement solution**: `/add-solution-2`
4. **Test**: `/test-step-2`
5. Repeat for next step

## Project Structure

main branch: STEPS.md (Introduction only) README.md Pages/ (initial problem state) .claude/commands/ (these commands)

step-n branches: STEPn.md (platform content) Tests/StepTests/ (validation tests) SOLUTIONn.md (exact changes)

solution branch: All completed code