Installation#

Get CafeKit Spec installed and start using spec-driven development in your projects.

Prerequisites#

Before installing, ensure you have:

• Node.js 18+ - Required for running the CLI
• AI coding assistant - CafeKit Spec works with Claude Code or Antigravity
• Reasoning Model - Required to use Claude Opus 4.5 (Thinking Mode) to ensure best logic for planning skills (spec-*).
• Git - For version control and updates
• repomix - Required for the /docs init command to compact codebase into XML for AI analysis:

  npm install -g repomix
  # or: pnpm install -g repomix
  # or: yarn global add repomix
  

Platform Compatibility#

CafeKit Spec supports multiple AI coding assistant platforms:

The installation process automatically detects your platform and installs the appropriate command format.

Install CafeKit Spec#

Run the install command in your project root:

npx @haposoft/cafekit-spec

The installer will prompt you to select your platform:

? Select your AI coding assistant platform:
  ❯ Claude Code
    Antigravity

This command will:

• Detect your project structure
• Install the core command set (/spec-init, /spec-requirements, /spec-design, /spec-tasks, /spec-status, /code, /test, /review)
• Configure your workspace for spec-driven development

What Gets Installed#

After running the install command, you'll have the CafeKit framework installed in your project:

Claude Code#

.claude/
├── commands/
│   ├── spec-init.md
│   ├── spec-requirements.md
│   ├── spec-design.md
│   ├── spec-tasks.md
│   ├── spec-status.md
│   ├── code.md
│   ├── test.md
│   ├── review.md
│   └── docs.md
├── agents/
│   ├── tester.md
│   ├── code-reviewer.md
│   ├── fullstack-developer.md
│   └── debugger.md
├── skills/
│   └── specs/
└── ROUTING.md

Antigravity#

.agent/
├── workflows/
│   ├── spec-init.md
│   ├── spec-requirements.md
│   ├── spec-design.md
│   ├── spec-tasks.md
│   ├── spec-status.md
│   ├── code.md
│   ├── test.md
│   ├── review.md
│   ├── docs-init.md
│   └── docs-update.md
├── agents/
│   ├── frontend-specialist.md
│   ├── test-engineer.md
│   └── code-archaeologist.md
├── skills/
│   └── specs/
└── rules/
    └── GEMINI.md

Documentation Setup (Claude Code only)#

Prerequisite: Ensure you have repomix installed globally:

npm install -g repomix

After installation, use the /docs command to generate project documentation:

# Initialize project docs baseline
/docs init

# Or update existing docs
/docs update

What repomix does: It compacts your codebase into repomix-output.xml so AI can analyze your project structure and generate accurate documentation.

This will create:

• Platform context file (CLAUDE.md or .agent/rules/AGENTS.md)
• docs/ folder with:
  • codebase-summary.md
  • project-overview-pdr.md
  • code-standards.md
  • system-architecture.md
  • design-guidelines.md
  • deployment-guide.md
  • project-roadmap.md

Note: /docs is exposed as /docs init and /docs update commands. These rely on your AI environment capabilities and project context files.

Verify Installation#

Open your AI coding assistant and type the init command for your platform:

Claude Code#

/spec-init

Antigravity#

/spec-init
# or
@spec-init

You should see the spec initialization workflow start.

Troubleshooting#

Command not found#

If the spec commands don't work:

1. Check file locations - Ensure files are in the correct folder:
   • Claude Code: .claude/commands/
   • Antigravity: .agent/workflows/
2. Restart your AI assistant - Some tools require a restart to detect new commands
3. Verify file format - Commands must be .md files with proper frontmatter
4. Check platform selection - Re-run installer and verify correct platform was selected

Wrong directory#

If CafeKit installs to the wrong directory, you can manually move files:

# For Claude Code - ensure .claude/commands/ exists
mkdir -p .claude/commands/

# For Antigravity - ensure .agent/workflows/ exists
mkdir -p .agent/workflows/

# Re-run installer
npx @haposoft/cafekit-spec

Next Steps#

Now that CafeKit Spec is installed:

• Quickstart Guide - Create your first spec in 5 minutes
• Spec Workflow Guide - Learn the full spec command chain

Need help? Open an issue on GitHub or contact support.