tutorial

# SDD Tutorial

## Overview

Interactive guide to Specification-Driven Development. Offers 3 learning paths based on your goals.

This skill provides structured onboarding for new users, explaining:
- What SDD is and why it matters
- The workflow phases and when to use each command
- Team collaboration patterns (when to share specs via PR)
- Decision guidance (which command for which situation)

## Context Detection

Before presenting paths, check the project state to customize messaging:

1. **Look for `specs/` directory** - indicates SDD may already be in use
2. **Check for `specs/constitution.md`** - indicates project principles exist
3. **Check for `.specify/` directory** - indicates spec-kit is initialized

Adapt the tutorial messaging based on findings:
- New project: Focus on getting started
- Existing SDD project: Focus on advanced patterns
- Team project: Emphasize collaboration workflows

## Learning Path Selection

Present the user with 3 learning paths using AskUserQuestion:

**Path A: Quick Start (5 min)**
- Core concepts and cheat sheet
- Best for: Experienced developers who want to jump in

**Path B: Full Introduction (15 min)**
- All phases explained with examples
- Best for: New users wanting thorough understanding

**Path C: Team Collaboration (10 min)**
- PR workflows and spec reviews
- Best for: Teams adopting SDD together

## Deliver Content

Based on the user's selection:

1. **Read the corresponding content file:**
   - Path A: Read `sdd/skills/tutorial/quick-start.md`
   - Path B: Read `sdd/skills/tutorial/full-introduction.md`
   - Path C: Read `sdd/skills/tutorial/team-collaboration.md`

2. **Present the content section by section:**
   - Show one major section at a time
   - Pause after each section: "Ready to continue, or any questions?"
   - Be prepared to answer questions before moving on

3. **Keep it conversational:**
   - Don't just dump the entire file
   - Engage with the user throughout
   - Offer to skip sections if they're alrea