What's New in v1.0.0
OpenSpec 1.0 marks the transition from experimental to stable. The workflow has been rebuilt around an action-based system where AI understands your project's state—what artifacts exist, what's ready to create, and what each action unlocks.
⚠️ Migrating from Pre-1.0
Breaking changes:
- Old commands removed —
/openspec:proposal,/openspec:apply,/openspec:archiveno longer exist - Config files removed — Tool-specific files (
CLAUDE.md,.cursorrules,AGENTS.md,project.md) are no longer generated
To upgrade: Run openspec init. Your existing work is safe—active changes, archived changes, and main specs are all preserved. Only obsolete config files are cleaned up (with confirmation).
New
- Action-based workflow — Replaced the rigid proposal → apply → archive sequence with flexible actions. Edit any artifact anytime. The artifact graph tracks state automatically.
| Command | What it does |
|---|---|
/opsx:explore
| Think through ideas before committing to a change |
/opsx:new
| Start a new change |
/opsx:continue
| Create one artifact at a time (step-through) |
/opsx:ff
| Create all planning artifacts at once (fast-forward) |
/opsx:apply
| Implement tasks |
/opsx:verify
| Validate implementation matches artifacts |
/opsx:sync
| Sync delta specs to main specs |
/opsx:archive
| Archive completed change |
/opsx:bulk-archive
| Archive multiple changes with conflict detection |
/opsx:onboard
| Guided 15-minute walkthrough of complete workflow |
-
Dynamic instructions — AI instructions are now assembled from three layers: context (your tech stack), rules (artifact-specific constraints), and templates (output structure). AI queries the CLI for real-time state instead of receiving static prompts.
-
Semantic spec syncing — Delta specs use markers like
## ADDED Requirementsand## MODIFIED Requirements. Archive parses these at the requirement level, not brittle header matching. -
Agent Skills — Single
.claude/skills/directory replaces 8+ scattered config files. YAML-fronted markdown files that work across Claude Code, Cursor, and Windsurf. -
Onboarding skill —
/opsx:onboardwalks new users through their first complete change with codebase-aware task suggestions. 11 phases, ~15 minutes. -
Interactive setup —
openspec initshows animated welcome screen and searchable multi-select for tools. Pre-selects already-configured tools for easy refresh. -
21 AI tools supported — Claude Code, Cursor, Windsurf, Continue, Gemini CLI, GitHub Copilot, Amazon Q, Cline, RooCode, Kilo Code, Auggie, CodeBuddy, Qoder, Qwen, CoStrict, Crush, Factory, OpenCode, Antigravity, iFlow, and Codex.
-
Custom schemas — Define custom artifact workflows in
openspec/schemas/without touching package code.
Fixed
- Claude Code YAML parsing failure when command names contained colons
- Task file parsing to handle trailing whitespace on checkbox lines
- JSON instruction output now separates context/rules from template (AI was copying constraint blocks into artifact files)
Documentation
New guides: Getting Started · CLI Reference · Commands · Concepts · Customization