|
1 | 1 | # @fission-ai/openspec |
2 | 2 |
|
| 3 | +## 1.0.0 |
| 4 | + |
| 5 | +### Major Changes |
| 6 | + |
| 7 | +- [#578](https://github.com/Fission-AI/OpenSpec/pull/578) [`0cc9d90`](https://github.com/Fission-AI/OpenSpec/commit/0cc9d9025af367faa1688a7b2606a2549053cd3f) Thanks [@TabishB](https://github.com/TabishB)! - ## OpenSpec 1.0 — The OPSX Release |
| 8 | + |
| 9 | + The workflow has been rebuilt from the ground up. OPSX replaces the old phase-locked `/openspec:*` commands with an action-based system where AI understands what artifacts exist, what's ready to create, and what each action unlocks. |
| 10 | + |
| 11 | + ### Breaking Changes |
| 12 | + |
| 13 | + - **Old commands removed** — `/openspec:proposal`, `/openspec:apply`, and `/openspec:archive` no longer exist |
| 14 | + - **Config files removed** — Tool-specific instruction files (`CLAUDE.md`, `.cursorrules`, `AGENTS.md`, `project.md`) are no longer generated |
| 15 | + - **Migration** — Run `openspec init` to upgrade. Legacy artifacts are detected and cleaned up with confirmation. |
| 16 | + |
| 17 | + ### From Static Prompts to Dynamic Instructions |
| 18 | + |
| 19 | + **Before:** AI received the same static instructions every time, regardless of project state. |
| 20 | + |
| 21 | + **Now:** Instructions are dynamically assembled from three layers: |
| 22 | + |
| 23 | + 1. **Context** — Project background from `config.yaml` (tech stack, conventions) |
| 24 | + 2. **Rules** — Artifact-specific constraints (e.g., "propose spike tasks for unknowns") |
| 25 | + 3. **Template** — The actual structure for the output file |
| 26 | + |
| 27 | + AI queries the CLI for real-time state: which artifacts exist, what's ready to create, what dependencies are satisfied, and what each action unlocks. |
| 28 | + |
| 29 | + ### From Phase-Locked to Action-Based |
| 30 | + |
| 31 | + **Before:** Linear workflow — proposal → apply → archive. Couldn't easily go back or iterate. |
| 32 | + |
| 33 | + **Now:** Flexible actions on a change. Edit any artifact anytime. The artifact graph tracks state automatically. |
| 34 | + |
| 35 | + | Command | What it does | |
| 36 | + | -------------------- | ---------------------------------------------------- | |
| 37 | + | `/opsx:explore` | Think through ideas before committing to a change | |
| 38 | + | `/opsx:new` | Start a new change | |
| 39 | + | `/opsx:continue` | Create one artifact at a time (step-through) | |
| 40 | + | `/opsx:ff` | Create all planning artifacts at once (fast-forward) | |
| 41 | + | `/opsx:apply` | Implement tasks | |
| 42 | + | `/opsx:verify` | Validate implementation matches artifacts | |
| 43 | + | `/opsx:sync` | Sync delta specs to main specs | |
| 44 | + | `/opsx:archive` | Archive completed change | |
| 45 | + | `/opsx:bulk-archive` | Archive multiple changes with conflict detection | |
| 46 | + | `/opsx:onboard` | Guided 15-minute walkthrough of complete workflow | |
| 47 | + |
| 48 | + ### From Text Merging to Semantic Spec Syncing |
| 49 | + |
| 50 | + **Before:** Spec updates required manual merging or wholesale file replacement. |
| 51 | + |
| 52 | + **Now:** Delta specs use semantic markers that AI understands: |
| 53 | + |
| 54 | + - `## ADDED Requirements` — New requirements to add |
| 55 | + - `## MODIFIED Requirements` — Partial updates (add scenario without copying existing ones) |
| 56 | + - `## REMOVED Requirements` — Delete with reason and migration notes |
| 57 | + - `## RENAMED Requirements` — Rename preserving content |
| 58 | + |
| 59 | + Archive parses these at the requirement level, not brittle header matching. |
| 60 | + |
| 61 | + ### From Scattered Files to Agent Skills |
| 62 | + |
| 63 | + **Before:** 8+ config files at project root + slash commands scattered across 21 tool-specific locations with different formats. |
| 64 | + |
| 65 | + **Now:** Single `.claude/skills/` directory with YAML-fronted markdown files. Auto-detected by Claude Code, Cursor, Windsurf. Cross-editor compatible. |
| 66 | + |
| 67 | + ### New Features |
| 68 | + |
| 69 | + - **Onboarding skill** — `/opsx:onboard` walks new users through their first complete change with codebase-aware task suggestions and step-by-step narration (11 phases, ~15 minutes) |
| 70 | + |
| 71 | + - **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 |
| 72 | + |
| 73 | + - **Interactive setup** — `openspec init` shows animated welcome screen and searchable multi-select for choosing tools. Pre-selects already-configured tools for easy refresh. |
| 74 | + |
| 75 | + - **Customizable schemas** — Define custom artifact workflows in `openspec/schemas/` without touching package code. Teams can share workflows via version control. |
| 76 | + |
| 77 | + ### Bug Fixes |
| 78 | + |
| 79 | + - Fixed Claude Code YAML parsing failure when command names contained colons |
| 80 | + - Fixed task file parsing to handle trailing whitespace on checkbox lines |
| 81 | + - Fixed JSON instruction output to separate context/rules from template — AI was copying constraint blocks into artifact files |
| 82 | + |
| 83 | + ### Documentation |
| 84 | + |
| 85 | + - New getting-started guide, CLI reference, concepts documentation |
| 86 | + - Removed misleading "edit mid-flight and continue" claims that weren't implemented |
| 87 | + - Added migration guide for upgrading from pre-OPSX versions |
| 88 | + |
3 | 89 | ## 0.23.0 |
4 | 90 |
|
5 | 91 | ### Minor Changes |
|
0 commit comments