<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> OpenSpec enforces spec-driven development for AI coding assistants, aligning humans and AI on requirements before code generation. It ensures deterministic, auditable outputs, benefiting teams seeking predictable AI-assisted development and clear scope management.

How It Works

OpenSpec uses a lightweight specification workflow: developers draft proposals, review/align with AI, implement AI-generated tasks, and archive changes to update source specs. This ensures human-AI agreement on intent before implementation, providing structured, auditable change folders.

Quick Start & Requirements

• Install: npm install -g @fission-ai/openspec@latest
• Prerequisites: Node.js >= 20.19.0.
• Initialization: Run openspec init in your project directory. This prompts for AI tool selection, configures slash commands or AGENTS.md, and creates an openspec/ directory.
• Docs/Community: Join the OpenSpec Discord for support.

Highlighted Details

• AI Tool Compatibility: Supports native slash commands (Claude Code, Cursor, OpenCode) and integrates with others (e.g., GitHub Copilot) via the AGENTS.md convention.
• Structured Change Management: Organizes development into explicit change folders (openspec/changes/<feature-name>/) containing proposals, tasks, and spec deltas.
• AI-Generated Artifacts: AI assistants automatically generate spec deltas, task lists, and proposals based on requirements and codebase context.
• Delta Specification Format: Uses ADDED, MODIFIED, REMOVED sections for requirements/scenarios to track spec evolution.

Maintenance & Community

• Community: Active support via the OpenSpec Discord.
• Updates: Follow @0xTab on X for project updates.
• Contributing: Development contributions are welcomed, with build/test scripts using pnpm.

Licensing & Compatibility

• License: MIT License.
• Compatibility: Permissive MIT license allows commercial use and integration within closed-source projects.

Limitations & Caveats

• AI Interpretation Dependency: Effectiveness relies on AI's ability to interpret AGENTS.md for non-native integrations.
• Initial Setup: Requires Node.js and global CLI installation, followed by project initialization.
• Evolving Ecosystem: Integrates with rapidly evolving AI assistants, potentially leading to frequent compatibility or feature set changes.