---
name: multi-agent-setup
description: Quick setup for multi-agent collaboration using the consolidated framework
---

# Quick Multi-Agent Setup

You are setting up multi-agent collaboration using the consolidated MULTI_AGENT_FRAMEWORK.md template.

## Your Task

Perform a rapid setup with minimal questions:

### Step 1: Quick Assessment

Check the project structure:
```bash
ls -la
ls src/ 2>/dev/null || ls lib/ 2>/dev/null || echo "No src directory"
```

### Step 2: Ask ONE Question

Use AskUserQuestion to ask:

```
Which agents will participate in this project?
- Claude + Gemini + Codex (Full team)
- Claude + Codex (Dev focused)
- Claude + Gemini (Research focused)
- Claude only (Solo with guidelines)
```

### Step 3: Create Files

Based on the answer, create these files:

**Always create:**
```
.agent-state/tasks.yaml
.agent-state/locks.yaml
MULTI_AGENT_FRAMEWORK.md    ← Use template from skill
tools/check-ownership.py
```

**If Gemini included:**
```
GEMINI.md
```

**If Codex included:**
```
CODEX.md
```

### Step 4: Customize Framework

In MULTI_AGENT_FRAMEWORK.md:
1. Replace `{{PROJECT_NAME}}` with actual project name
2. Replace `{{DATE}}` with current date
3. Adjust ownership matrix based on project structure

### Step 5: Summary

Output a concise summary:

```markdown
## Multi-Agent Framework Installed

**Files Created:**
- `.agent-state/tasks.yaml`
- `.agent-state/locks.yaml`
- `MULTI_AGENT_FRAMEWORK.md`
- `tools/check-ownership.py`
- [Additional agent files if created]

**Next Steps:**
1. Set agent identity: `export AGENT_AUTHOR=claude`
2. Review ownership matrix in `MULTI_AGENT_FRAMEWORK.md`
3. Start using `[Agent] type(scope): message` commit format

**Commands:**
- Check ownership: `python tools/check-ownership.py <file>`
- View tasks: `cat .agent-state/tasks.yaml`
- View locks: `cat .agent-state/locks.yaml`
```

## Template Location

Use the consolidated framework template from:
`${SKILL_DIR}/templates/multi-agent-framework.md`

## Key Principle

**Speed over completeness** - Get the framework running quickly. Users can customize later.