Skip to content

Commit 0e6f42c

Browse files
Version Packages (Fission-AI#579)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
1 parent 0cc9d90 commit 0e6f42c

3 files changed

Lines changed: 87 additions & 84 deletions

File tree

.changeset/opsx-1.0.md

Lines changed: 0 additions & 83 deletions
This file was deleted.

CHANGELOG.md

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,91 @@
11
# @fission-ai/openspec
22

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+
389
## 0.23.0
490

591
### Minor Changes

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@fission-ai/openspec",
3-
"version": "0.23.0",
3+
"version": "1.0.0",
44
"description": "AI-native system for spec-driven development",
55
"keywords": [
66
"openspec",

0 commit comments

Comments
 (0)