Gigaspec MCP Server

1

Add it to Claude Code

Run this in a terminal.

Run in terminal
claude mcp add gigaspec -- npx -y gigaspec mcp
README.md

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 gigaspec commands 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

claude_desktop_config.json
{"mcpServers": {"gigaspec": {"command": "npx", "args": ["-y", "gigaspec", "mcp"]}}}

Try it

→Initialize a new project named 'CollaborativeApp' and help me analyze the requirements for a real-time collaborative platform.
→Generate a v5.0 specification kit for a Node.js/Express project named 'BackendService'.
→Create a project roadmap and architecture specification for a new AI-native application.
→Help me define the project standards and constraints for my new software project.

Frequently Asked Questions

What are the key features of Gigaspec?

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.

What can I use Gigaspec for?

Standardizing project documentation across AI-assisted development environments. Enforcing strict coding standards and system rules that AI cannot override. Automating the creation of project roadmaps and architecture specifications. Guiding developers through AI-driven project initialization and stack selection.

How do I install Gigaspec?

Install Gigaspec by running: npx gigaspec init

What MCP clients work with Gigaspec?

Gigaspec works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Turn this server into reusable context

Keep Gigaspec docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Need the old visual installer? Open Conare IDE.
Open Conare