CafeKit Spec
Docs
Reference
File Structure

File Structure#

Overview of all files and directories created by CafeKit Spec.

Claude Code Structure#

project-root/
├── .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
├── .specs/
│   └── [feature-name]/
│       ├── spec.json
│       ├── requirements.md
│       ├── design.md
│       └── tasks.md
└── docs/
    ├── codebase-summary.md
    ├── project-overview-pdr.md
    ├── code-standards.md
    ├── system-architecture.md
    ├── design-guidelines.md
    ├── deployment-guide.md
    ├── project-roadmap.md
    └── .backups/
        └── [timestamp]/

Antigravity Structure#

project-root/
├── .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
├── .specs/
│   └── [feature-name]/
│       ├── spec.json
│       ├── requirements.md
│       ├── design.md
│       └── tasks.md
└── docs/
    ├── codebase-summary.md
    ├── project-overview-pdr.md
    ├── code-standards.md
    ├── system-architecture.md
    ├── design-guidelines.md
    ├── deployment-guide.md
    ├── project-roadmap.md
    └── .backups/
        └── [timestamp]/

File Details#

AI Config Files#

FileClaudeAntigravityPurpose
ROUTING.md✅❌Claude command routing rules
rules/GEMINI.md❌✅Antigravity workspace behavior rules

Spec Files#

FileDescriptionCreated by
spec.jsonPhase and approval status/spec-init
requirements.mdEARS requirements/spec-requirements
design.mdTechnical design/spec-design
tasks.mdTask breakdown/spec-tasks

Documentation Files#

FileDescriptionUpdated by
codebase-summary.mdTech stack, structure/docs init, /docs update
project-overview-pdr.mdProduct requirements/docs init, /docs update
code-standards.mdCoding conventions/docs init, /docs update
system-architecture.mdArchitecture docs/docs init, /docs update
design-guidelines.mdUI/UX guidelines/docs init, /docs update
deployment-guide.mdDeployment guide/docs init, /docs update
project-roadmap.mdProject roadmap/docs init, /docs update

Platform Comparison#

┌─────────────────────────────────────────────────────────────┐
│                        PROJECT ROOT                         │
├─────────────────────────────────────────────────────────────┤
│  CLAUDE CODE                    │  ANTIGRAVITY              │
│  .claude/                       │  .agent/                  │
│  ├── commands/                  │  ├── workflows/           │
│  │   ├── spec-init.md           │  │   ├── spec-init.md     │
│  │   ├── spec-requirements.md   │  │   ├── spec-design.md   │
│  │   ├── spec-design.md         │  │   ├── spec-tasks.md    │
│  │   ├── spec-tasks.md          │  │   ├── code.md          │
│  │   ├── spec-status.md         │  │   ├── test.md          │
│  │   ├── code.md                │  │   ├── review.md        │
│  │   ├── test.md                │  │   └── spec-status.md   │
│  │   └── review.md              │  ├── agents/              │
│  ├── agents/                    │  ├── skills/specs/        │
│  ├── skills/specs/              │  └── rules/GEMINI.md      │
│  └── ROUTING.md                 │                           │
├─────────────────────────────────────────────────────────────┤
│  COMMON (both platforms)                                    │
│  .specs/                       docs/                        │
│  └── [feature]/                ├── codebase-summary.md      │
│      ├── spec.json             ├── project-overview-pdr.md  │
│      ├── requirements.md       ├── code-standards.md        │
│      ├── design.md             ├── system-architecture.md   │
│      └── tasks.md              ├── design-guidelines.md     │
│                                ├── deployment-guide.md      │
│                                ├── project-roadmap.md       │
│                                └── .backups/                │
└─────────────────────────────────────────────────────────────┘

Permissions and Git#

Should commit#

  • .specs/ (all spec files)
  • .claude/ or .agent/ workflow config
  • docs/ (documentation)

Should not commit#

  • .backups/ (auto-generated, can be large)
  • repomix-output.xml (can be regenerated)

Sample Gitignore#

# CafeKit Spec backups
docs/.backups/
repomix-output.xml

Migrating Between Platforms#

From Claude Code to Antigravity#

# Backup specs and docs
cp -r .specs .specs-backup
cp -r docs docs-backup

# Install Antigravity
npx @haposoft/cafekit-spec
# Select Antigravity

# Restore specs and docs
cp -r .specs-backup/* .specs/
cp -r docs-backup/* docs/

From Antigravity to Claude Code#

# Backup specs and docs
cp -r .specs .specs-backup
cp -r docs docs-backup

# Install Claude Code
npx @haposoft/cafekit-spec
# Select Claude Code

# Restore specs and docs
cp -r .specs-backup/* .specs/
cp -r docs-backup/* docs/

Specs and docs are platform-agnostic, just transfer and they work immediately.

Previous
Reference
Next
FAQ