Claude Code#
Complete guide for using CafeKit Spec with Claude Code.
Installation#
npx @haposoft/cafekit-spec
Select Claude Code in the installer menu.
File Structure#
After installation, CafeKit Spec adds workflow files to .claude/:
.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
Command Set#
Spec workflow#
| Command | Description |
|---|---|
/spec-init | Initialize a new spec |
/spec-requirements | Gather and generate requirements |
/spec-design | Generate technical design |
/spec-tasks | Generate implementation tasks |
/code | Implement next approved task |
/test | Run tests and summarize failures |
/review | Review code correctness and security |
/spec-status | Show current spec status |
Documentation workflow#
| Command | Description |
|---|---|
/docs init | Initialize project docs |
/docs update | Update docs after changes |
Usage Examples#
Start a feature#
> /spec-init payment-gateway
Implement from tasks#
> /code payment-gateway
> /test
> /review
Manage project docs#
> /docs init
> /docs update
Differences from Antigravity#
| Claude Code | Antigravity | |
|---|---|---|
| Workflow directory | .claude/commands/ | .agent/workflows/ |
| Agent directory | .claude/agents/ | .agent/agents/ |
| Routing file | .claude/ROUTING.md | .agent/rules/GEMINI.md |
| Command trigger | /... | /... or @... |
Troubleshooting#
Commands not showing#
ls -la .claude/commands/
Command execution issues#
- Restart Claude Code
- Verify command files use
.mdwith valid frontmatter - Re-run installer:
npx @haposoft/cafekit-spec