OpenSpec v1.0.0: The OPSX Release

TL;DR

• OpenSpec 1.0 moves from experimental to stable with a new action-based workflow replacing the old proposal → apply → archive sequence
• Old commands and config files removed — run openspec init to upgrade (your work is safe)
• New `/opsx:*` commands, dynamic AI instructions, semantic spec syncing, and support for 21 AI tools including Claude Code, Cursor, and Windsurf

New

• Action-based workflow — Replaced rigid proposal → apply → archive with flexible actions. Edit any artifact anytime; the artifact graph tracks state automatically. New commands: /opsx:explore, /opsx:new, /opsx:continue, /opsx:ff, /opsx:apply, /opsx:verify, /opsx:sync, /opsx:archive, /opsx:bulk-archive, /opsx:onboard.
• Dynamic instructions — AI instructions assembled from context (your tech stack), rules (artifact constraints), and templates (output structure). AI queries CLI for real-time state instead of static prompts.
• Semantic spec syncing — Delta specs use markers like ## ADDED Requirements and ## MODIFIED Requirements. Archive parses at requirement level, not brittle header matching.
• Agent Skills — Single .claude/skills/ directory replaces 8+ scattered config files. YAML-fronted markdown works across Claude Code, Cursor, and Windsurf.
• Onboarding skill — /opsx:onboard walks new users through first complete change with codebase-aware task suggestions. 11 phases, ~15 minutes.
• Interactive setup — openspec init shows 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.

Breaking Changes

• Old commands removed — /openspec:proposal, /openspec:apply, /openspec:archive no longer exist. Use new /opsx:* commands instead.
• Config files removed — Tool-specific files (CLAUDE.md, .cursorrules, AGENTS.md, project.md) are no longer generated. Migrate to .claude/skills/ directory.
• 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). See the migration guide.

Update: npm install -g openspec@latest or visit the release page.

Source: OpenSpec