Convert.prompt

---
description: "Add the AI Context Starter Kit to an existing project without disrupting current setup"
agent: "agent"
---

# Convert: Add Starter Kit to Existing Project

Add the AI Context Starter Kit to a project that already has some configuration.

### Step 1: Audit Existing Setup
Check what exists: `context/`, `.claude/`, `.beads/`, `.github/`, `CLAUDE.md`, `AGENTS.md`, `agents/`

### Step 2: Categorize Files
- **ADD**: Files that don't exist yet
- **DIFFER**: Files that exist but differ from templates
- **MATCH**: Files identical to templates

### Step 3: Handle Existing Files Carefully
For differing files, ask the user:
1. Keep existing
2. Replace with template
3. Show diff

### Step 4: Merge Permissions Intelligently
If `.claude/settings.local.json` exists, keep existing permissions and add new ones.

### Step 5: Add New Files
Copy missing files to appropriate locations.

### Step 6: Initialize Beads (If Needed)
If `.beads/` doesn't exist, offer `bd quickstart`

### Step 7: Fill Placeholders
Walk through new template files and fill placeholders using existing project info.

### Key Principles
1. Never silently overwrite
2. Preserve user customizations
3. Merge, don't replace
4. Be transparent
5. Minimize disruption