name: openspec description: | OpenSpec - Lightweight Spec-Driven Development (SDD) for AI coding assistants. A fluid, iterative approach to specifications that works with 20+ AI assistants. Use when users want:

• Lightweight spec-driven development
• Quick iteration and flexibility
• Brownfield projects (not just greenfield)
• Seamless AI-assisted coding workflow homepage: https://github.com/Fission-AI/OpenSpec

OpenSpec Integration

This skill integrates OpenSpec capabilities into OpenClaw, providing a lightweight spec-driven development workflow.

What is OpenSpec?

OpenSpec is a lightweight spec framework for AI coding assistants that emphasizes:

• Fluid, not rigid - Easy iteration
• Iterative, not waterfall - Continuous improvement
• Easy, not complex - Simple to use
• Brownfield focus - Works with existing codebases
• Scalable - From personal projects to enterprises

What You Can Do

📋 Spec-Driven Development

• Create lightweight specifications
• Generate proposals, specs, designs, and tasks
• Implement features with structured workflow
• Archive completed changes

🔄 Flexible Workflows

• Quick feature proposal creation
• Fast-forward planning documents
• Implementation with checklists
• Easy archiving and iteration

🤖 AI Assistant Integration

• Works with 20+ AI assistants
• Slash command support
• Claude Code compatible
• Context-aware development

Quick Start

Install OpenSpec

# Requires Node.js 20.19.0 or higher
npm install -g @fission-ai/openspec@latest

# Verify installation
openspec --version

Initialize in Project

cd your-project
openspec init

Available Slash Commands

After openspec init, these commands are available in Claude Code:

Core Commands

| Command | Description | |---------|-------------| | /opsx:new <feature> | Create new feature proposal | | /opsx:ff | Fast-forward - generate all planning docs | | /opsx:apply | Apply implementation | | /opsx:archive | Archive completed change |

Optional Commands

| Command | Description | |---------|-------------| | /opsx:update | Update OpenSpec and agent instructions | | /opsx:status | Check current status | | /opsx:help | Get help |

Workflow Example

1. Start New Feature

You: /opsx:new add-dark-mode
AI: Created openspec/changes/add-dark-mode/
     Ready to create: proposal

2. Generate Planning Documents

You: /opsx:ff
AI: ✓ proposal.md — why we're doing this
     ✓ specs/ — requirements and scenarios
     ✓ design.md — technical approach
     ✓ tasks.md — implementation checklist
     Ready for implementation!

3. Apply Implementation

You: /opsx:apply
AI: Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     All tasks complete!

4. Archive

You: /opsx:archive
AI: Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature!

Project Structure

After openspec init, your project looks like:

your-project/
├── openspec/
│   ├── changes/
│   │   ├── add-dark-mode/
│   │   │   ├── proposal.md
│   │   │   ├── specs/
│   │   │   │   └── ...
│   │   │   ├── design.md
│   │   │   └── tasks.md
│   │   └── archive/
│   │       └── 2025-01-23-add-dark-mode/
│   └── .opsx/              # Generated guidance
├── src/
└── ...

OpenSpec vs Spec-Kit

| Feature | OpenSpec | Spec-Kit | |---------|----------|-----------| | Weight | Lightweight | Heavyweight | | Flexibility | Fluid, iterative | Rigid phase gates | | Setup | Simple (npm) | Complex (Python) | | Brownfield | First-class | Limited | | Languages | Multi-language | Python-focused | | Speed | Fast-forward mode | Sequential |

Best Practices

1. Context Hygiene

• OpenSpec benefits from clean context
• Clear context before starting implementation
• Maintain context hygiene throughout

2. Model Selection

• Works best with high-reasoning models
• Recommended: Opus 4.5, GPT 5.2
• Works with Claude Code default models

3. Iterative Approach

• Don't over-spec initially
• Iterate as needed
• Update artifacts anytime

4. Documentation

• Each change gets its own folder
• Proposal, specs, design, tasks organized
• Easy to review and understand

Integration with Claude Code

This skill provides OpenSpec integration with OpenClaw:

# Check OpenSpec installation
openspec --version

# Initialize in project
openspec init

# Use in Claude Code
/opsx:new <your feature>
/opsx:ff
/opsx:apply
/opsx:archive

Troubleshooting

OpenSpec Not Found

# Check installation
npm list -g @fission-ai/openspec

# Reinstall if needed
npm install -g @fission-ai/openspec@latest

Node.js Version Issue

# Check version
node --version

# OpenSpec requires 20.19.0+
# Update Node.js if needed

Command Not Recognized

# Regenerate agent instructions
openspec update

Documentation Links

• Main Repo: https://github.com/Fission-AI/OpenSpec
• Getting Started: https://github.com/Fission-AI/OpenSpec/blob/main/docs/getting-started.md
• Workflows: https://github.com/Fission-AI/OpenSpec/blob/main/docs/workflows.md
• Commands: https://github.com/Fission-AI/OpenSpec/blob/main/docs/commands.md
• CLI Reference: https://github.com/Fission-AI/OpenSpec/blob/main/docs/cli.md
• Supported Tools: https://github.com/Fission-AI/OpenSpec/blob/main/docs/supported-tools.md

Tips for Success

1. Start Simple: Don't over-spec, iterate as needed
2. Use Fast-Forward: /opsx:ff generates all docs at once
3. Keep Context Clean: Clear context for better results
4. Archive Regularly: Use /opsx:archive to keep things organized
5. Update Often: Run openspec update to get latest features

See Also

• GitHub: https://github.com/Fission-AI/OpenSpec
• NPM: https://www.npmjs.com/package/@fission-ai/openspec
• Discord: https://discord.gg/YctCnvvshC
• X (Twitter): @0xTab