You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
AI-native system for spec-driven development. Keep living specifications alongside code, propose changes as deltas, and archive once reality matches the spec.
9
+
**Supported AI Tools:** ✅ Claude Code | 🔜 Cursor (coming soon) | 🔜 AGENTS.md support (coming soon)
10
+
11
+
Universal spec-driven development that works with your AI coding assistant. Keep living specifications alongside code, propose changes as deltas, and archive once reality matches the spec. **No API keys required.**
10
12
11
13
OpenSpec turns specifications into living documentation that drives development. Your specs and code stay in sync—propose changes, track implementation, and know exactly when features are complete. No more outdated docs or unclear requirements.
12
14
@@ -24,10 +26,11 @@ OpenSpec turns specifications into living documentation that drives development.
24
26
## What You Get
25
27
26
28
-**Better AI Code Generation** - Create specs first, get the code you actually want
29
+
-**Universal Tool Support** - Works with any AI assistant - Claude Code, Cursor, or future tools
30
+
-**No API Keys Required** - Integrates through context rules, not external services
27
31
-**Alignment with AI** - Your AI assistant understands exactly what to build through clear specifications
28
32
-**Plan Before You Build** - Clarify features and requirements before implementation
29
33
-**Team Clarity** - Everyone reviews specs, not code changes
30
-
-**No API Keys** - Works with your existing AI tools (Claude Code, Cursor) by adding context rules
31
34
-**Track Progress** - See what changes are proposed, in progress, or completed
32
35
33
36
## How It Works
@@ -74,7 +77,7 @@ cd my-project
74
77
# Initialize OpenSpec
75
78
openspec init
76
79
77
-
#You'll be asked:
80
+
#Select your AI tool (more coming soon!):
78
81
# "Which AI tool do you use?"
79
82
# > Claude Code
80
83
# Cursor (coming soon)
@@ -83,12 +86,12 @@ openspec init
83
86
# openspec/
84
87
# ├── specs/ # Current specifications (truth)
85
88
# ├── changes/ # Proposed changes
86
-
# └── README.md # AI instructions
89
+
# └── README.md # AI instructions for your tool
87
90
```
88
91
89
92
### 2. Create Your First Change
90
93
91
-
Jump straight into creating a change proposal with your AI assistant:
94
+
Jump straight into creating a change proposal with your AI assistant (works with Claude Code, Cursor, or any AI tool):
92
95
93
96
```markdown
94
97
// Quick win - Add a simple new feature:
@@ -234,7 +237,7 @@ OpenSpec creates **alignment** between you and your AI coding assistant:
234
237
4.**AI implements** exactly what was specified
235
238
5.**Everyone understands** what's being built through clear specs
236
239
237
-
No API keys needed - OpenSpec works by adding context rules to your existing AI tools (Claude Code, Cursor, etc.).
240
+
**True Interoperability:** OpenSpec is designed to be universal. No API keys, no vendor lock-in. It works by adding context rules to ANY AI coding tool - whether you use Claude Code today, switch to Cursor tomorrow, or adopt the next breakthrough AI assistant. Your specs remain portable and your workflow stays consistent.
238
241
239
242
240
243
## How OpenSpec Compares
@@ -254,7 +257,7 @@ Without specs, AI coding assistants generate code based on vague prompts, often
254
257
3.**Build incrementally** - Each new feature adds to your spec library
255
258
4.**Future capability** - We're working on tools to generate specs from existing code
256
259
257
-
`openspec update` is team-friendly: it updates instruction files without forcing tools on teammates. Multiple AI assistants can coexist without conflicts.
260
+
**Tool Freedom:** Your team can use different AI assistants. One developer might use Claude Code while another uses Cursor - OpenSpec keeps everyone aligned through shared specifications. Run `openspec update` to configure for any supported tool without affecting others.
0 commit comments