RAPIDS - Ship Fast, Make Money

Migration Guide

Add RAPIDS framework to existing projects without breaking your code. 100% non-destructive migration.

🚀 Quick Migration

cd your-existing-project
rapids-migrate
rapids-clean

Zero-risk migration. Your code is never modified. Only RAPIDS configuration files are added.

🔍 What Migration Does

1. Analyzes Your Project

• Detects tech stack (Next.js, FastAPI, Flutter)
• Identifies project structure (monorepo, multi-folder, single)
• Finds package manager (npm, yarn, pnpm)
• Locates existing folders (web, backend, mobile)

2. Creates Configuration

• Adds .claude/ configuration folder
• Creates CLAUDE.md with project-specific instructions
• Sets up .claudeignore if missing
• Generates settings.local.json with detected structure

3. Initializes Documentation System

• Creates .agent/ folder structure (task, system, sop)
• Copies templates from global installation
• Generates initial architecture overview

4. Preserves Your Code

• No files moved
• No code modified
• Existing structure untouched
• Backup created if .claude/ exists

📁 Supported Project Structures

Monorepo

your-project/
├── web/           # Next.js app
├── backend/       # FastAPI
├── mobile/        # Flutter
└── package.json   # Workspaces

Multi-folder

your-project/
├── frontend/      # or client/
├── server/        # or api/
└── ...

Single Stack

your-project/
├── app/           # Next.js or React
├── pages/
├── components/
└── package.json

✅ Post-Migration Steps

1. Document Your Architecture

/update-doc system

Creates architecture-overview.md, database-schema.md, api-endpoints.md, critical-paths.md

2. Create Feature Plans

/update-doc plan user-authentication

Generates structured plan in .agent/task/

3. Start Using Agents

/feature "Add user profile page"
/bug "Fix login redirect issue"
/refactor "Extract auth logic to hooks"

💰 Token Optimization Benefits

Before RAPIDS

You: "Add user authentication"
Claude: *reads entire codebase* (50K tokens)

After RAPIDS

You: "Add user authentication"
Claude: *reads .agent/system/architecture-overview.md* (2K tokens)
Claude: *reads .agent/system/database-schema.md* (1K tokens)

Savings: 94%

🔄 Rollback (If Needed)

If you want to undo migration and restore your original setup:

# Remove RAPIDS configuration
rm -rf .claude/ .agent/ CLAUDE.md .claudeignore

# Restore backup if needed
mv .claude.backup .claude

📚 Next Steps

→ Read Token Optimization Guide

→ Explore AI Agent Capabilities

→ Use rapids-clean to Remove Legacy Files

→ Set Up Deployment