Skip to content

Conversation

@openspec-release-bot
Copy link
Contributor

This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.

Releases

@fission-ai/openspec@1.0.0

Major Changes

  • #578 0cc9d90 Thanks @TabishB! - ## OpenSpec 1.0 — The OPSX Release

    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.

    Breaking Changes

    • Old commands removed/openspec:proposal, /openspec:apply, and /openspec:archive no longer exist
    • Config files removed — Tool-specific instruction files (CLAUDE.md, .cursorrules, AGENTS.md, project.md) are no longer generated
    • Migration — Run openspec init to upgrade. Legacy artifacts are detected and cleaned up with confirmation.

    From Static Prompts to Dynamic Instructions

    Before: AI received the same static instructions every time, regardless of project state.

    Now: Instructions are dynamically assembled from three layers:

    1. Context — Project background from config.yaml (tech stack, conventions)
    2. Rules — Artifact-specific constraints (e.g., "propose spike tasks for unknowns")
    3. Template — The actual structure for the output file

    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.

    From Phase-Locked to Action-Based

    Before: Linear workflow — proposal → apply → archive. Couldn't easily go back or iterate.

    Now: Flexible actions on a change. 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

    From Text Merging to Semantic Spec Syncing

    Before: Spec updates required manual merging or wholesale file replacement.

    Now: Delta specs use semantic markers that AI understands:

    • ## ADDED Requirements — New requirements to add
    • ## MODIFIED Requirements — Partial updates (add scenario without copying existing ones)
    • ## REMOVED Requirements — Delete with reason and migration notes
    • ## RENAMED Requirements — Rename preserving content

    Archive parses these at the requirement level, not brittle header matching.

    From Scattered Files to Agent Skills

    Before: 8+ config files at project root + slash commands scattered across 21 tool-specific locations with different formats.

    Now: Single .claude/skills/ directory with YAML-fronted markdown files. Auto-detected by Claude Code, Cursor, Windsurf. Cross-editor compatible.

    New Features

    • 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)

    • 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

    • Interactive setupopenspec init shows animated welcome screen and searchable multi-select for choosing tools. Pre-selects already-configured tools for easy refresh.

    • Customizable schemas — Define custom artifact workflows in openspec/schemas/ without touching package code. Teams can share workflows via version control.

    Bug Fixes

    • Fixed Claude Code YAML parsing failure when command names contained colons
    • Fixed task file parsing to handle trailing whitespace on checkbox lines
    • Fixed JSON instruction output to separate context/rules from template — AI was copying constraint blocks into artifact files

    Documentation

    • New getting-started guide, CLI reference, concepts documentation
    • Removed misleading "edit mid-flight and continue" claims that weren't implemented
    • Added migration guide for upgrading from pre-OPSX versions

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Jan 26, 2026

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.


Comment @coderabbitai help to get the list of available commands and usage tips.

@vibe-kanban-cloud
Copy link

Review Complete

Your review story is ready!

View Story

Comment !reviewfast on this PR to re-generate the story.

@greptile-apps
Copy link

greptile-apps bot commented Jan 26, 2026

Greptile Overview

Greptile Summary

This automated release PR bumps the package version from 0.23.0 to 1.0.0 and publishes the comprehensive OPSX release notes to the CHANGELOG. The changeset file .changeset/opsx-1.0.md has been consumed and deleted as part of the standard Changesets workflow.

Major Changes:

  • Version bumped to 1.0.0 in package.json:3
  • OPSX release notes added to CHANGELOG.md documenting the complete workflow redesign
  • Breaking changes include removal of old /openspec:* commands and legacy config files
  • New action-based system with 10 new commands (/opsx:explore, /opsx:new, /opsx:continue, etc.)
  • Added onboarding skill and support for 21 AI tools

This is a standard Changesets release PR generated by automation. All changes are correctly formatted and follow the expected release workflow pattern.

Confidence Score: 5/5

  • This PR is safe to merge - it's an automated release following standard Changesets workflow
  • This is a standard automated release PR generated by Changesets. All changes are mechanical: version bump in package.json (0.23.0 → 1.0.0), CHANGELOG update with the release notes, and deletion of the consumed changeset file. No code logic changes, no security concerns, and follows established release patterns perfectly.
  • No files require special attention

Important Files Changed

Filename Overview
package.json Version bumped from 0.23.0 to 1.0.0 for major release
CHANGELOG.md Added 1.0.0 release notes with comprehensive OPSX feature documentation
.changeset/opsx-1.0.md Changeset file deleted after being processed into CHANGELOG

Sequence Diagram

sequenceDiagram
    participant Dev as Developer
    participant CS as Changesets Action
    participant Repo as Repository
    participant NPM as NPM Registry
    
    Dev->>Repo: Merge PR #578 with changeset
    Note over Repo: .changeset/opsx-1.0.md added
    CS->>Repo: Detect changeset on main branch
    CS->>CS: Generate release PR #579
    CS->>Repo: Create PR with version bump
    Note over Repo: package.json: 0.23.0 → 1.0.0
    CS->>Repo: Update CHANGELOG.md
    Note over Repo: Add 1.0.0 release notes
    CS->>Repo: Delete consumed changeset
    Note over Repo: Remove .changeset/opsx-1.0.md
    Dev->>Repo: Review & merge PR #579
    CS->>NPM: Publish @fission-ai/openspec@1.0.0
    NPM-->>CS: Package published
    Note over NPM: Version 1.0.0 available
Loading

@TabishB TabishB merged commit 0e6f42c into main Jan 26, 2026
10 checks passed
@TabishB TabishB deleted the changeset-release/main branch January 26, 2026 00:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants