The most loved spec framework. Our philosophy: Follow @0xTab on X for updates · Join the OpenSpec Discord for help and questions. Using OpenSpec in a team? Email here for access to our Slack channel. OpenSpec Dashboard Requires Node.js 20.19.0 or higher. Install OpenSpec globally: Then navigate to your project directory and initialize: Now tell your AI: /opsx:propose If you want the expanded workf
Add this skill
npx mdskills install Fission-AI/openspecWell-documented spec framework with clear workflows and slash commands for AI-guided development
1<p align="center">2 <a href="https://github.com/Fission-AI/OpenSpec">3 <picture>4 <source srcset="assets/openspec_bg.png">5 <img src="assets/openspec_bg.png" alt="OpenSpec logo">6 </picture>7 </a>8</p>910<p align="center">11 <a href="https://github.com/Fission-AI/OpenSpec/actions/workflows/ci.yml"><img alt="CI" src="https://github.com/Fission-AI/OpenSpec/actions/workflows/ci.yml/badge.svg" /></a>12 <a href="https://www.npmjs.com/package/@fission-ai/openspec"><img alt="npm version" src="https://img.shields.io/npm/v/@fission-ai/openspec?style=flat-square" /></a>13 <a href="./LICENSE"><img alt="License: MIT" src="https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square" /></a>14 <a href="https://discord.gg/YctCnvvshC"><img alt="Discord" src="https://img.shields.io/discord/1411657095639601154?style=flat-square&logo=discord&logoColor=white&label=Discord&suffix=%20online" /></a>15</p>1617<details>18<summary><strong>The most loved spec framework.</strong></summary>1920[](https://github.com/Fission-AI/OpenSpec/stargazers)21[](https://www.npmjs.com/package/@fission-ai/openspec)22[](https://github.com/Fission-AI/OpenSpec/graphs/contributors)2324</details>25<p></p>26Our philosophy:2728```text29→ fluid not rigid30→ iterative not waterfall31→ easy not complex32→ built for brownfield not just greenfield33→ scalable from personal projects to enterprises34```3536> [!TIP]37> **New workflow now available!** We've rebuilt OpenSpec with a new artifact-guided workflow.38>39> Run `/opsx:propose "your idea"` to get started. → [Learn more here](docs/opsx.md)4041<p align="center">42 Follow <a href="https://x.com/0xTab">@0xTab on X</a> for updates · Join the <a href="https://discord.gg/YctCnvvshC">OpenSpec Discord</a> for help and questions.43</p>4445### Teams4647Using OpenSpec in a team? [Email here](mailto:teams@openspec.dev) for access to our Slack channel.4849<!-- TODO: Add GIF demo of /opsx:propose → /opsx:archive workflow -->5051## See it in action5253```text54You: /opsx:propose add-dark-mode55AI: Created openspec/changes/add-dark-mode/56 ✓ proposal.md — why we're doing this, what's changing57 ✓ specs/ — requirements and scenarios58 ✓ design.md — technical approach59 ✓ tasks.md — implementation checklist60 Ready for implementation!6162You: /opsx:apply63AI: Implementing tasks...64 ✓ 1.1 Add theme context provider65 ✓ 1.2 Create toggle component66 ✓ 2.1 Add CSS variables67 ✓ 2.2 Wire up localStorage68 All tasks complete!6970You: /opsx:archive71AI: Archived to openspec/changes/archive/2025-01-23-add-dark-mode/72 Specs updated. Ready for the next feature.73```7475<details>76<summary><strong>OpenSpec Dashboard</strong></summary>7778<p align="center">79 <img src="assets/openspec_dashboard.png" alt="OpenSpec dashboard preview" width="90%">80</p>8182</details>8384## Quick Start8586**Requires Node.js 20.19.0 or higher.**8788Install OpenSpec globally:8990```bash91npm install -g @fission-ai/openspec@latest92```9394Then navigate to your project directory and initialize:9596```bash97cd your-project98openspec init99```100101Now tell your AI: `/opsx:propose <what-you-want-to-build>`102103If you want the expanded workflow (`/opsx:new`, `/opsx:continue`, `/opsx:ff`, `/opsx:verify`, `/opsx:sync`, `/opsx:bulk-archive`, `/opsx:onboard`), select it with `openspec config profile` and apply with `openspec update`.104105> [!NOTE]106> Not sure if your tool is supported? [View the full list](docs/supported-tools.md) – we support 20+ tools and growing.107>108> Also works with pnpm, yarn, bun, and nix. [See installation options](docs/installation.md).109110## Docs111112→ **[Getting Started](docs/getting-started.md)**: first steps<br>113→ **[Workflows](docs/workflows.md)**: combos and patterns<br>114→ **[Commands](docs/commands.md)**: slash commands & skills<br>115→ **[CLI](docs/cli.md)**: terminal reference<br>116→ **[Supported Tools](docs/supported-tools.md)**: tool integrations & install paths<br>117→ **[Concepts](docs/concepts.md)**: how it all fits<br>118→ **[Multi-Language](docs/multi-language.md)**: multi-language support<br>119→ **[Customization](docs/customization.md)**: make it yours120121122## Why OpenSpec?123124AI coding assistants are powerful but unpredictable when requirements live only in chat history. OpenSpec adds a lightweight spec layer so you agree on what to build before any code is written.125126- **Agree before you build** — human and AI align on specs before code gets written127- **Stay organized** — each change gets its own folder with proposal, specs, design, and tasks128- **Work fluidly** — update any artifact anytime, no rigid phase gates129- **Use your tools** — works with 20+ AI assistants via slash commands130131### How we compare132133**vs. [Spec Kit](https://github.com/github/spec-kit)** (GitHub) — Thorough but heavyweight. Rigid phase gates, lots of Markdown, Python setup. OpenSpec is lighter and lets you iterate freely.134135**vs. [Kiro](https://kiro.dev)** (AWS) — Powerful but you're locked into their IDE and limited to Claude models. OpenSpec works with the tools you already use.136137**vs. nothing** — AI coding without specs means vague prompts and unpredictable results. OpenSpec brings predictability without the ceremony.138139## Updating OpenSpec140141**Upgrade the package**142143```bash144npm install -g @fission-ai/openspec@latest145```146147**Refresh agent instructions**148149Run this inside each project to regenerate AI guidance and ensure the latest slash commands are active:150151```bash152openspec update153```154155## Usage Notes156157**Model selection**: OpenSpec works best with high-reasoning models. We recommend Opus 4.5 and GPT 5.2 for both planning and implementation.158159**Context hygiene**: OpenSpec benefits from a clean context window. Clear your context before starting implementation and maintain good context hygiene throughout your session.160161## Contributing162163**Small fixes** — Bug fixes, typo corrections, and minor improvements can be submitted directly as PRs.164165**Larger changes** — For new features, significant refactors, or architectural changes, please submit an OpenSpec change proposal first so we can align on intent and goals before implementation begins.166167When writing proposals, keep the OpenSpec philosophy in mind: we serve a wide variety of users across different coding agents, models, and use cases. Changes should work well for everyone.168169**AI-generated code is welcome** — as long as it's been tested and verified. PRs containing AI-generated code should mention the coding agent and model used (e.g., "Generated with Claude Code using claude-opus-4-5-20251101").170171### Development172173- Install dependencies: `pnpm install`174- Build: `pnpm run build`175- Test: `pnpm test`176- Develop CLI locally: `pnpm run dev` or `pnpm run dev:cli`177- Conventional commits (one-line): `type(scope): subject`178179## Other180181<details>182<summary><strong>Telemetry</strong></summary>183184OpenSpec collects anonymous usage stats.185186We collect only command names and version to understand usage patterns. No arguments, paths, content, or PII. Automatically disabled in CI.187188**Opt-out:** `export OPENSPEC_TELEMETRY=0` or `export DO_NOT_TRACK=1`189190</details>191192<details>193<summary><strong>Maintainers & Advisors</strong></summary>194195See [MAINTAINERS.md](MAINTAINERS.md) for the list of core maintainers and advisors who help guide the project.196197</details>198199200201## License202203MIT204
Full transparency — inspect the skill content before installing.