Multi-Agent
Development

# Create 3 sibling directories, each on its own branch
git worktree add ../stitchwand-agent-core   -b agent/core-engine
git worktree add ../stitchwand-agent-mcpcli -b agent/mcp-cli
git worktree add ../stitchwand-agent-web    -b agent/web-app

# Each needs its own node_modules
cd ../stitchwand-agent-core   && npm install && npx turbo build --filter=@stitchwand/core
cd ../stitchwand-agent-mcpcli && npm install && npx turbo build --filter=@stitchwand/core
cd ../stitchwand-agent-web    && npm install && npx turbo build --filter=@stitchwand/core

# List all worktrees
git worktree list

# Remove a worktree (after merging)
git worktree remove ../stitchwand-agent-core

# Delete the branch too
git branch -d agent/core-engine

# Agent 1 — Core Engine

## Scope
`packages/core/` only. Do not modify files outside this directory.

## Branch
`agent/core-engine` — forked from `main`.

## Responsibilities
- Parsers (DESIGN.md, design tokens)
- Validation engine, Diff engine, Convert pipeline
- Type definitions, Test coverage (target 80%+)

## Sprint Tasks
- P1-004: Extraction accuracy
- P2-002: Test coverage gaps

## Key Rules
1. Only additive exports — never rename/remove existing signatures
2. Strict TypeScript — no `any`
3. Use Result<T, E> error pattern
4. Run `npx vitest run` before every commit

<!-- BEGIN:nextjs-agent-rules -->
# This is NOT the Next.js you know
This version has breaking changes — APIs, conventions, and file
structure may all differ from your training data. Read the relevant
guide in `node_modules/next/dist/docs/` before writing any code.
<!-- END:nextjs-agent-rules -->

cd /Users/dilshaus/dev/stitchwand-agent-core && claude

cd /Users/dilshaus/dev/stitchwand-agent-mcpcli && claude

cd /Users/dilshaus/dev/stitchwand-agent-web && claude

# See all worktrees and their HEAD commits
git worktree list

# See what each agent has committed
git log --oneline agent/core-engine..HEAD    # core agent commits
git log --oneline agent/mcp-cli..HEAD        # mcp+cli agent commits
git log --oneline agent/web-app..HEAD        # web agent commits

# See changed files per agent branch
git diff --stat main..agent/core-engine
git diff --stat main..agent/mcp-cli
git diff --stat main..agent/web-app

# Watch commits in real-time (run in a 4th terminal)
watch -n 5 'echo "=== CORE ===" && git log --oneline -3 agent/core-engine && echo "\n=== MCP+CLI ===" && git log --oneline -3 agent/mcp-cli && echo "\n=== WEB ===" && git log --oneline -3 agent/web-app'

# In the MCP+CLI worktree
cd /Users/dilshaus/dev/stitchwand-agent-mcpcli
git cherry-pick <commit-hash-from-core>
npx turbo build --filter=@stitchwand/core

# Pre-fork: set up Auth0 + Neon on main first
npm install @auth0/nextjs-auth0 drizzle-orm @neondatabase/serverless
git commit -m "Add auth + DB dependencies"

# Then fork worktrees
git worktree add ../stitchwand-agent-core   -b agent/p3-core
git worktree add ../stitchwand-agent-mcpcli -b agent/p3-mcp-cli
git worktree add ../stitchwand-agent-web    -b agent/p3-web
git worktree add ../stitchwand-agent-infra  -b agent/p3-infra

---
name: core-engine
description: Works on packages/core exclusively. Parsers, validation, diff, types.
isolation: worktree
tools: Read, Glob, Grep, Bash, Edit, Write
model: opus
maxTurns: 50
---

You are the Core Engine agent for stitchwand.
Only modify files in packages/core/.
Run `npx vitest run` after every change.
Never rename or remove existing exports.

# Add to .claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}