OpenSpec — What is it?

OpenSpec is an AI-native system for spec-driven development, facilitating collaboration between humans and AI coding assistants by ensuring alignment on specifications before coding begins.

⭐ 50,324 Stars 🍴 3,528 Forks TypeScript — Author: Fission-AI
Source: Official README and linked documentation View on GitHub →

Why it matters

OpenSpec is being discussed because its unique approach to integrating AI coding assistants with spec-driven development, addressing the challenge of aligning human and AI expectations. It differs through its lightweight spec layer, configurable workflow, and support for a wide range of AI assistants.

Source: Official README and linked documentation

Core Features

Spec-driven Development

OpenSpec uses plain Markdown for specifications, allowing teams to define requirements and scenarios clearly. It ensures that both humans and AI coding assistants are aligned on what needs to be built before any code is written.

Source: Official README and linked documentation
AI Integration

OpenSpec integrates with a variety of AI coding assistants, enabling users to interact with their AI through slash commands and use AI capabilities for code generation and planning.

Source: Official README and linked documentation
Cross-Repo Collaboration

OpenSpec supports cross-repo features, allowing a single change to be planned and executed across multiple repositories, ensuring consistency and alignment across the codebase.

Source: Official README and linked documentation

Architecture

The architecture of OpenSpec is modular, with a clear separation of concerns. It uses TypeScript as the primary language and use various npm packages for CLI interactions, AI integration, and workflow management. The code structure is organized into modules for agents, skills, and the core OpenSpec functionality.

Source: Official repository tree and dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) @inquirer/core @inquirer/prompts@inquirer/prom… chalk commander Spec-driven DevelopmentSpec-driven Develop… AI Integration Cross-Repo CollaborationCross-Repo Collabor… OpenSpec Project Core feature Key dependency

Tech Stack

LanguageTypeScriptFrameworkNPM packages for CLI, AI integration, and workflow management
@inquirer/core@inquirer/promptschalkcommander
Node.js, npm
Source: Official repository tree and dependency files

Quick Start

Install OpenSpec globally: ```bash npm install -g @fission-ai/openspec@latest ``` Initialize in your project directory: ```bash cd your-project openspec init ```
Source: Official README and linked documentation

Use Cases

OpenSpec is suitable for teams and individuals involved in AI-assisted software development. It is useful in scenarios where there is a need for clear specification management, collaboration between humans and AI, and cross-repository feature development.

Source: Official README and linked documentation

Strengths & Limitations

Strengths

  • Facilitates spec-driven development, ensuring alignment between humans and AI.
  • Supports a wide range of AI coding assistants, enhancing productivity.
  • Enables cross-repo collaboration, maintaining consistency across the codebase.

Limitations

  • Limited to TypeScript and specific AI assistants.
  • Beta features like Stores may not be fully stable.
Source: Official README and linked documentation

Latest Release

At the 2026-09-23 review, v1.13.1 was Latest on GitHub, dated 2026-09-17, and package.json on main also reported 1.13.1. The release focuses on CLI security hardening, archive and validation reliability, profile-aware commands, and next-step hints in status.

Source: github.com/Fission-AI/OpenSpec/releases/tag/v1.13.1;https://github.co…

Verification and evidence

status: docs-only  |  checked_at: 2026-09-23  |  environment: Docs only. Read the official Fission-AI/OpenSpec README, package.json, v1.13.1 release, and the official GitHub Spec Kit README. The npm package was not installed and openspec init was not run.  |  limitations: Generated init content, client commands, propose, apply, archive, validate, security hardening, and Stores were not observed. Described command results come from official materials, not local output.  |  observed_output: The official README and package.json require Node.js 20.19.0 or newer. package.json reports 1.13.1, and GitHub Releases marks v1.13.1 as Latest, dated 2026-09-17.

Source: github.com/Fission-AI/OpenSpec;https://github.com/Fission-AI/OpenSpec…

Comparison

OpenSpec concentrates on proposal, specs, design, tasks, and archival for each change, with adapters for several coding assistants. Spec Kit currently exposes specification-driven development, fixes, and idea evaluation as separate workflow entry points and requires Python 3.11 or newer plus uv. OpenSpec fits a lightweight change directory in an existing Node project. Spec Kit offers a broader workflow catalog, extensions, and presets.

Source: github.com/Fission-AI/OpenSpec;https://github.com/github/spec-kit/blo…

Verdict

OpenSpec is a tool for teams looking to integrate AI coding assistants into their development process. Its spec-driven approach and support for a variety of AI tools make it a valuable asset for enhancing collaboration and productivity, especially in complex, cross-repository projects.

Frequently Asked Questions

What did the documentation review verify for OpenSpec on 2026-09-23?

The official README and package.json require Node.js 20.19.0 or newer. package.json reports 1.13.1, and GitHub Releases marks v1.13.1 as Latest, dated 2026-09-17. Generated init content, client commands, propose, apply, archive, validate, security hardening, and Stores were not observed.

What evidence boundary applies to this OpenSpec review?

The review environment was: Docs only. Read the official Fission-AI/OpenSpec README, package.json, v1.13.1 release, and the official GitHub Spec Kit README. The npm package was not installed and openspec init was not run. OpenSpec behavior outside that scope still needs a local check.

Sources and review scope
This review is based on the project's public documentation. Versions, installation commands, and feature boundaries can change upstream; check the cited sources and current release before use. Sources checked on: 2026-09-23 13:55.

Reference materials: README, GitHub API, dependency files