AI-native specification framework for deep requirements analysis
š 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
Tools (2)
initInitialize a new project with AI-guided requirements analysis.generateGenerate project specification kits including architecture and planning documents.Configuration
{"mcpServers": {"gigaspec": {"command": "npx", "args": ["-y", "gigaspec", "mcp"]}}}