SpecWeave Essentials
Your journey from first command to production-ready workflows.
16 hands-on lessons that take you from complete beginner to confident practitioner. Each lesson builds on the previous — learn by doing.
What You'll Build
By the end of this curriculum, you'll have shipped:
| Project Type | Technologies | SpecWeave Features |
|---|---|---|
| Mobile App | React Native, Expo | Autonomous execution, iOS/Android builds |
| Web API | Node.js, PostgreSQL | OpenAPI generation, test coverage gates |
| Full-Stack | Next.js, Supabase | Multi-repo coordination, living docs |
| Infrastructure | Terraform, K8s | IaC generation, GitOps workflows |
Video Tutorials
Prefer watching? Start with the Complete Masterclass:
| Video | Duration | What's Covered |
|---|---|---|
| Complete Masterclass | 61 min | Full journey: concepts, 6 live demos, external sync |
Learning Paths
Path 1: Getting Started (Lessons 1-3)
For: Complete beginners | Time: 90 min
| Lesson | What You'll Learn |
|---|---|
| 1. Getting Started | Install SpecWeave, run your first command |
| 2. Three-File Structure | Understand spec.md, plan.md, tasks.md |
| 3. Your First Increment | Build a complete feature from scratch |
Path 2: Core Workflow (Lessons 4-5)
For: Users who completed Path 1 | Time: 60 min
| Lesson | What You'll Learn |
|---|---|
| 4. The :next Command | Your workflow compass |
| 5. Quality Gates | Ensure quality before shipping |
Path 3: Testing & Quality (Lesson 6)
For: Test-first developers | Time: 45 min
| Lesson | What You'll Learn |
|---|---|
| 6. TDD Workflow | Red-Green-Refactor with SpecWeave |
Path 4: Integration & Mastery (Lessons 7-10)
For: Teams and advanced users | Time: 2 hours
| Lesson | What You'll Learn |
|---|---|
| 7. External Tools | Connect GitHub, JIRA, Azure DevOps |
| 8. AI Model Selection | Choose the right model for each task |
| 9. Troubleshooting | Fix common issues |
| 10. Advanced Patterns | Enterprise workflows |
Path 5: Deep Dive (Lessons 11-16)
For: Comprehensive mastery | Time: 4.5 hours
| Lesson | What You'll Learn |
|---|---|
| 11. The Vibe Coding Problem | Why SpecWeave exists |
| 12. Init Deep Dive | Every init question explained |
| 13. Increment Lifecycle | Archive, cleanup, status management |
| 14. GitHub Integration | Complete GitHub setup |
| 15. JIRA Integration | Complete JIRA setup |
| 16. Azure DevOps | Complete ADO setup |
Quick Reference
┌─────────────────────────────────────────────────────────────┐
│ ESSENTIAL COMMANDS │
├─────────────────────────────────────────────────────────────┤
│ │
│ /sw:increment "feature" → Plan new work │
│ /sw:auto → Ship while you sleep │
│ /sw:do → Execute one task at a time │
│ /sw:next → Smart continuation │
│ /sw:progress → Check status │
│ /sw:done → Close increment │
│ │
└─────────────────────────────────────────────────────────────┘
Key Concepts
Before starting, familiarize yourself with these terms:
- Increment — A unit of work (feature, bug fix)
- spec.md — Business requirements (WHAT)
- Acceptance Criteria — Testable success conditions
- Living Docs — Auto-synced documentation
- Quality Gates — Validation before shipping
Choose Your Starting Point
| Your Situation | Start Here |
|---|---|
| New to SpecWeave | Lesson 1: Getting Started |
| Know the basics | Lesson 4: The :next Command |
| Want to understand WHY | Lesson 11: The Vibe Coding Problem |
| Setting up new project | Lesson 12: Init Deep Dive |
| Connecting external tools | Lesson 7: External Tools |
Ready? Let's begin → Lesson 1: Getting Started