| layout | title | nav_order | has_children | format_version |
|---|---|---|---|---|
default |
OpenSpec Tutorial |
181 |
true |
v2 |
Learn how to use
Fission-AI/OpenSpecto make AI-assisted software delivery more predictable with artifact-driven planning, implementation, and archival workflows.
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
- repository:
Fission-AI/OpenSpec - stars: about 31k
- latest release:
v1.2.0(published 2026-02-23)
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]
| 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 |
- 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
- OpenSpec Repository
- README
- Getting Started
- Concepts
- Workflows
- Commands
- CLI Reference
- Customization
- Migration Guide
- Supported Tools
Start with Chapter 1: Getting Started and OPSX Basics.
- Start Here: Chapter 1: Getting Started and OPSX Basics
- Back to Main Catalog
- Browse A-Z Tutorial Directory
- Search by Intent
- Explore Category Hubs
- Chapter 1: Getting Started and OPSX Basics
- Chapter 2: Artifact Graph and Change Lifecycle
- Chapter 3: Command Surface and Agent Workflows
- Chapter 4: Spec Authoring, Delta Patterns, and Quality
- Chapter 5: Customization, Schemas, and Project Rules
- Chapter 6: Tool Integrations and Multi-Agent Portability
- Chapter 7: Validation, Automation, and CI Operations
- Chapter 8: Migration, Governance, and Team Adoption
Generated by AI Codebase Knowledge Builder