OpenSpec v1.0.0: Action-Based Workflow Stable

TL;DR

• OpenSpec exits beta with action-based workflow replacing rigid proposal → apply → archive sequence
• Old commands and config files removed; run openspec init to migrate (work preserved)
• New `/opsx:*` commands, semantic spec syncing, and support for 21 AI tools including Claude Code, Cursor, and Windsurf

New

• Action-based workflow — Flexible commands (/opsx:explore, /opsx:new, /opsx:continue, /opsx:ff, /opsx:apply, /opsx:verify, /opsx:sync, /opsx:archive, /opsx:bulk-archive) replace the old rigid sequence; edit artifacts anytime with automatic state tracking.
• Dynamic instructions — AI instructions assembled from context (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 for requirement-level parsing instead of 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 in ~15 minutes.
• Interactive setup — openspec init shows animated welcome and searchable multi-select for tools; pre-selects already-configured tools.
• 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 modifying 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 Agent Skills in .claude/skills/.
• Migration required — Run openspec init to upgrade. Your active changes, archived changes, and main specs are preserved; only obsolete config files are cleaned up with confirmation. See the migration guide.

Update: npm install -g openspec@latest or npm update openspec if already installed. See full release notes.

Source: OpenSpec