SpecWeave Academy
Your journey from first command to production-ready workflows.
Welcome to SpecWeave Academy — a hands-on learning path that takes you from complete beginner to confident practitioner.
Video Tutorials
Prefer watching? Start with the Complete Masterclass:
| Video | Duration | What's Covered |
|---|---|---|
| 🎬 Complete Masterclass | 61 min | Full journey: concepts, 6 live demos, GitHub/JIRA/ADO sync |
📺 Watch on YouTube (link coming Nov 27, 2025)
More videos coming soon: Your First Increment, Daily Workflow, Integration Deep Dives.
How This Works
Each lesson builds on the previous one. You'll learn by doing, with simple examples that grow in complexity.
Lesson 1 → "Hello World" increment
Lesson 2 → Understand the three files
Lesson 3 → Build your first real feature
...and so on
Time commitment: ~5 hours for core lessons (1-10), ~9 hours for full curriculum including deep-dives (1-16).
Learning Paths
🌱 Path 1: Getting Started (Lessons 1-3)
For: Complete beginners Goal: Create and complete your first increment
| Lesson | What You'll Learn | Time |
|---|---|---|
| 1. Getting Started | Install SpecWeave, run your first command | 15 min |
| 2. The Three-File Structure | Understand spec.md, plan.md, tasks.md | 30 min |
| 3. Your First Increment | Build a complete feature from scratch | 45 min |
🔄 Path 2: Core Workflow (Lessons 4-5)
For: Users who completed Path 1 Goal: Master the daily workflow commands
| Lesson | What You'll Learn | Time |
|---|---|---|
| 4. The :next Command | Your workflow compass | 25 min |
| 5. Quality Gates | Ensure quality before shipping | 35 min |
✅ Path 3: Testing & Quality (Lesson 6)
For: Developers who want test-first development Goal: Implement features using TDD
| Lesson | What You'll Learn | Time |
|---|---|---|
| 6. TDD Workflow | Red-Green-Refactor with SpecWeave | 45 min |
🔗 Path 4: Integration & Mastery (Lessons 7-10)
For: Teams and advanced users Goal: Integrate tools and master advanced patterns
| Lesson | What You'll Learn | Time |
|---|---|---|
| 7. External Tools | Connect GitHub, JIRA, Azure DevOps | 35 min |
| 8. AI Model Selection | Choose the right model for each task | 25 min |
| 9. Troubleshooting | Fix common issues | 25 min |
| 10. Advanced Patterns | Enterprise workflows | 35 min |
🎓 Path 5: Deep Dive (Lessons 11-16)
For: Users who want comprehensive knowledge Goal: Master SpecWeave philosophy and integrations
| Lesson | What You'll Learn | Time |
|---|---|---|
| 11. The Vibe Coding Problem | Why SpecWeave exists, pain points solved | 30 min |
| 12. The specweave init Deep Dive | Every init question explained | 40 min |
| 13. Increment Lifecycle | Cleanup, archive, status management | 45 min |
| 14. GitHub Integration | Complete GitHub setup guide | 45 min |
| 15. JIRA Integration | Complete JIRA setup guide | 45 min |
| 16. Azure DevOps Integration | Complete ADO setup guide | 45 min |
Quick Reference Card
Save this for later:
┌─────────────────────────────────────────────────────────────┐
│ ESSENTIAL COMMANDS │
├─────────────────────────────────────────────────────────────┤
│ │
│ /specweave:increment "feature" → Plan new work │
│ /specweave:do → Execute tasks │
│ /specweave:next → Smart continuation │
│ /specweave:progress → Check status │
│ /specweave:done → Close increment │
│ │
└─────────────────────────────────────────────────────────────┘
Key Concepts (Glossary Links)
Before starting, familiarize yourself with these terms:
- Increment — A unit of work (feature, bug fix, etc.)
- spec.md — Business requirements (WHAT)
- Acceptance Criteria — Testable success conditions
- Source of Truth — Single authoritative data source
- Living Docs — Auto-synced documentation
- WIP Limits — Work-in-progress constraints
Choose Your Starting Point
New to SpecWeave? Start here → Lesson 1: Getting Started
Already familiar with basics? Jump to → Lesson 4: The :next Command
Want to understand WHY SpecWeave? Start with → Lesson 11: The Vibe Coding Problem
Setting up a new project? Deep dive → Lesson 12: The specweave init Deep Dive
Want to connect external tools? Overview → Lesson 7: External Tools GitHub → Lesson 14: GitHub Integration JIRA → Lesson 15: JIRA Integration Azure DevOps → Lesson 16: Azure DevOps Integration
Need to manage increment lifecycle? Complete guide → Lesson 13: Increment Lifecycle Management
Ready?
Let's begin your journey.
:next → Lesson 1: Getting Started