# Migration Guide: OpenClaw → Claude Code Projects

## What You Keep
- ✅ Claude Code (CLI) — runs on your machine, reads/writes files, runs commands
- ✅ Project instructions — custom system prompt per project
- ✅ File attachments — attach reference docs to projects
- ✅ Conversation threads — separate chats within a project
- ✅ Web search, code execution, file editing

## What You Lose
- ❌ Multi-agent orchestration (no sub-agents, no team delegation)
- ❌ Discord integration (no channel posting, no heartbeats)
- ❌ Cron/heartbeats (no automatic check-ins)
- ❌ Memory architecture (no auto-loaded daily logs, QMD)
- ❌ Google Workspace CLI (gws — calendar, email, drive, sheets)
- ❌ Server-side tools (Vercel deploy, git push, Notion API)
- ❌ Always-on availability (Claude Code runs when you run it)

## Recommended Project Structure

### Project 1: "Kitt — CE Operations"
**Instructions:** Use `claude-code-project-instructions.md` as custom instructions
**Attached files:**
- MEMORY.md (critical facts)
- LEARNINGS.md (rules from mistakes)
- Active project briefs as needed

**Use for:** Day-to-day CE work, project coordination, strategic thinking

### Project 2: "Mission Mode"
**Instructions:** Product context, visual brief, card format spec
**Attached files:**
- Brand research, style references, deck structure
- Landing page copy

### Project 3: "Olevia Brand Book"
**Instructions:** Brand system context, design direction decisions
**Attached files:**
- Brand assets info, component patterns, reference brands

## Setup Steps

1. **Open Claude.ai** → Projects (left sidebar)
2. **Create "Kitt — CE Operations"**
3. **Paste** `claude-code-project-instructions.md` content into Custom Instructions
4. **Attach** MEMORY.md and LEARNINGS.md as project knowledge
5. **Start a conversation** — Kitt is now active in that project

## Workflow Changes

| Before (OpenClaw) | After (Claude Code) |
|---|---|
| Discord message → Kitt responds | Open project → start chat |
| Sub-agent spawns team | You describe the work, Claude does it directly |
| Heartbeats check email/calendar | You ask when you need it |
| Auto-deploy via git push | You run `git push` yourself or ask Claude Code CLI |
| Memory persists across sessions | Attach key docs, reference in chat |

## If You Want Both

You can keep OpenClaw running on API credits for infrastructure tasks (deploys, Discord, email monitoring) while using Claude Code projects for the creative/strategic work. $15 API credits = ~2-3 hours of Opus.
