TL;DR:
- Install prerequisites: Opencode CLI, Astral UV, Git.
- Initialize a new Spec Kit project.
- Verify Opencode configuration.
- Use Spec Kit commands in Opencode CLI for spec-driven development.
Step-by-Step Integration Guide
Step 1: Initialize Spec Project
Create a new project directory with GitHub Spec Kit configured for Opencode CLI.
Option A: New Project Directory
uvx --from git+https://github.com/aemr3/spec-kit.git specify init --ai opencode <PROJECT_NAME>
cd <PROJECT_NAME>
Replace <PROJECT_NAME> with your desired project name.
Option B: Current Directory
Initialize Spec Kit in your current directory.
uvx --from git+https://github.com/aemr3/spec-kit.git specify init --ai opencode --here
Step 2: Verify Configuration
After initialization, verify the setup.
ls -la
opencode config list
ls -la AGENTS.md
Step 3: Test Integration
Launch Opencode CLI and test Spec Kit commands.
opencode
/specify Create a simple web application with user authentication
/plan Use React for frontend, Node.js for backend, PostgreSQL for database
/tasks
Usage Examples
Basic Spec Creation
Create a simple spec and generate a plan.
/specify Build a REST API for user management with authentication
/plan Use FastAPI for backend, PostgreSQL for data, JWT for auth
/tasks
Advanced Research Integration
Research technologies first, then plan a complex system.
/specify Create a microservices architecture for an e-commerce platform
/plan Research Kubernetes deployment, service mesh, API gateway
Constitution Compliance
Check if your spec follows simplicity rules.
/specify Build a monolithic application with 6 services
The system warns about complexity and suggests fewer services.
