Add it to Claude Code
claude mcp add gigaspec -- npx -y gigaspec mcpMake your agent remember this setup
gigaspec's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Intelligent Q&A workflows for deep requirements analysis
- Generation of living documentation like STATE.md and ARCHITECTURE.md
- Forced AI compliance with immutable CLAUDE.md rules
- Multi-tool support for Claude Code, Cursor, and Kimi
- Model-agnostic architecture compatible with any LLM
Tools 2
initInitialize a new project with AI-guided requirements analysis.generateGenerate project specification kits including architecture and planning documents.Try it
Original README from oleksiitrembach/gigaspec
🚀 Gigaspec
**AI-Native Specification Framework**
The AI does the thinking. We provide the structure.
Installation • Quick Start • Documentation • GitHub
🎯 What is Gigaspec?
Gigaspec is an AI-native collaboration framework that transforms how software projects are planned and built. Instead of static templates or keyword-based recommendations, Gigaspec enables deep AI analysis of your requirements with intelligent Q&A workflows.
The Problem with Traditional Tools
User: "I want to build a real-time collaborative app"
Traditional Tool: "Use Elixir!" ← No questions, no reasoning
The Gigaspec Way
User: "I want to build a real-time collaborative app"
AI: "Tell me more! What's your expected user count? Do you need
offline support? What's your team's expertise?"
→ Analyzes deeply
→ Explains reasoning
→ Recommends tailored stack
✨ Features
| Feature | Description |
|---|---|
| 🚀 Gigaspec v5.0 | Ultimate spec kit with forced AI compliance |
| 🔒 Immutable Rules | CLAUDE.md enforces standards that AI cannot override |
| ✅ Automated Verification | Every code change validated before completion |
| 🛠️ Universal Tool Support | Claude Code, Cursor, Kimi adapters |
| 🌍 Model-Agnostic | Works with Claude, GPT, Gemini, Llama |
| 🤖 AI-Native Workflow | Designed for AI assistants to drive development |
| 💬 Intelligent Q&A | AI asks clarifying questions, not keyword matching |
| 📋 Living Documentation | STATE.md tracks progress, AGENT.md guides AI coding |
| 🎯 Stack Recommendations | Deep analysis with transparent reasoning |
| 🔧 MCP Server | Native integration with AI IDEs |
| 📦 Zero Config | Works out of the box with sensible defaults |
🚀 Quick Start
Installation
# Global installation
npm install -g gigaspec
# Or use without installing
npx gigaspec init --name "MyApp"
Create Your First Project
# Interactive AI-guided wizard
gigaspec init
# Or specify your stack directly
gigaspec init --name "MyApp" --stack "Node.js/Next.js"
# Non-interactive with defaults
gigaspec init --name "MyApp" --yes
# Generate v5.0 Ultimate Spec Kit (RECOMMENDED)
gigaspec generate --name "MyApp" --stack "Node.js/Express" --v5
🚀 Gigaspec v5.0 (Ultimate Spec Kit)
The specification framework that forces AI compliance.
# Generate v5.0 spec kit with immutable rules
gigaspec generate --name "MyApp" --stack "Node.js/Express" --v5
What makes v5.0 different:
- CLAUDE.md - Immutable system rules that AI cannot override
- Automated Verification - Every code change validated
- Multi-Tool Adapters - Claude Code, Cursor, Kimi support
- Model-Agnostic - Works with any LLM
Generated v5.0 Structure:
my-project/
├── CLAUDE.md ← IMMUTABLE system rules (AI cannot override)
├── AGENT.md ← Project-specific standards
├── STATE.md ← Living project status
├── ARCHITECTURE.md ← System design
├── PLAN.md ← Development roadmap
├── RULES/ ← Modular rule modules
│ ├── security.md
│ └── testing.md
├── .claude/ ← Claude Code adapter
│ ├── CLAUDE.md
│ ├── skills/
│ └── agents/
├── .cursorrules ← Cursor IDE adapter
├── .cursor/
│ └── agents/
└── .kimi/ ← Kimi CLI adapter
└── AGENT.md
What Gets Created (v4.x)
my-project/
├── AGENT.md ← AI coding standards & constraints
├── ARCHITECTURE.md ← System design & decisions
├── PLAN.md ← Development roadmap
├── STATE.md ← Project status (living document)
├── WORKFLOW.md ← AI development protocols
├── SETUP.md ← Local development guide
├── DEPLOYMENT.md ← Production deployment
├── ENVIRONMENT.md ← Secrets & configuration
├── CLAUDE.md ← Claude Code integration guide
├── .cursorrules ← Cursor IDE rules
├── .github/workflows/ ← CI/CD automation
├── .hooks/ ← Git hooks
├── scripts/ ← Utility scripts
└── prompts/ ← AI prompt templates
🤖 For AI Assistants
Gigaspec works both as a CLI tool (for humans) and an MCP server (for AI IDEs). Use whichever fits your workflow:
- CLI: Run
gigaspeccommands directly in terminal - MCP: AI assistan