README.md

layout	title	nav_order	has_children	format_version
default	OpenSpec Tutorial	181	true	v2

OpenSpec Tutorial: Spec-Driven Workflows for AI Coding Agents

Learn how to use Fission-AI/OpenSpec to make AI-assisted software delivery more predictable with artifact-driven planning, implementation, and archival workflows.

Why This Track Matters

OpenSpec adds a strong specification layer on top of coding agents, reducing ambiguity between intent, design, and implementation.

This track focuses on:

• using OPSX commands to move from idea to implemented change
• managing proposal/spec/design/tasks artifacts as a connected graph
• customizing schemas and rules for team-specific standards
• operating validation, migration, and governance in real repositories

Current Snapshot (auto-updated)

• repository: Fission-AI/OpenSpec
• stars: about 31k
• latest release: v1.2.0 (published 2026-02-23)

Mental Model

flowchart LR
    A[Idea] --> B[/opsx:new]
    B --> C[proposal, specs, design, tasks]
    C --> D[/opsx:apply]
    D --> E[/opsx:verify]
    E --> F[/opsx:archive]
    F --> G[Updated source-of-truth specs]

Loading

Chapter Guide

Chapter	Key Question	Outcome
01 - Getting Started and OPSX Basics	How do I install and initialize OpenSpec safely?	Clean project bootstrap
02 - Artifact Graph and Change Lifecycle	How do specs and change artifacts interact over time?	Strong lifecycle model
03 - Command Surface and Agent Workflows	Which commands belong to humans vs agents?	Better execution discipline
04 - Spec Authoring, Delta Patterns, and Quality	How do you write robust ADDED/MODIFIED/REMOVED specs?	Higher artifact quality
05 - Customization, Schemas, and Project Rules	How do teams adapt OpenSpec to their delivery model?	Tailored workflows
06 - Tool Integrations and Multi-Agent Portability	How does OpenSpec span many coding assistants?	Cross-tool consistency
07 - Validation, Automation, and CI Operations	How do we enforce quality gates continuously?	Repeatable validation
08 - Migration, Governance, and Team Adoption	How do teams migrate and scale OpenSpec usage safely?	Sustainable adoption plan

What You Will Learn

• how to run an end-to-end spec-driven workflow with coding agents
• how to separate planning artifacts from implementation execution
• how to customize OpenSpec behavior with config and schema controls
• how to enforce validation and governance as part of CI/CD

Source References

• OpenSpec Repository
• README
• Getting Started
• Concepts
• Workflows
• Commands
• CLI Reference
• Customization
• Migration Guide
• Supported Tools

Related Tutorials

• Claude Task Master Tutorial
• OpenCode Tutorial
• Codex CLI Tutorial
• Continue Tutorial

---

Start with Chapter 1: Getting Started and OPSX Basics.

Navigation & Backlinks

• Start Here: Chapter 1: Getting Started and OPSX Basics
• Back to Main Catalog
• Browse A-Z Tutorial Directory
• Search by Intent
• Explore Category Hubs

Full Chapter Map

1. Chapter 1: Getting Started and OPSX Basics
2. Chapter 2: Artifact Graph and Change Lifecycle
3. Chapter 3: Command Surface and Agent Workflows
4. Chapter 4: Spec Authoring, Delta Patterns, and Quality
5. Chapter 5: Customization, Schemas, and Project Rules
6. Chapter 6: Tool Integrations and Multi-Agent Portability
7. Chapter 7: Validation, Automation, and CI Operations
8. Chapter 8: Migration, Governance, and Team Adoption

Generated by AI Codebase Knowledge Builder