---
name: setup-agents
description: Initialize multi-agent collaboration framework for the current project
---

# Setup Multi-Agent Collaboration

You are initializing a multi-agent collaboration framework for this project.

## Your Task

Guide the user through setting up a complete multi-agent framework by:

1. **Assess the project**:
   - Identify the project type (Python, Node.js, monorepo, etc.)
   - Determine the source code structure
   - Check for existing configuration files

2. **Gather requirements** using AskUserQuestion:
   - Which agents will participate? (Claude, Gemini, Codex, custom)
   - What are the main ownership domains for each agent?
   - Do they want CI/CD integration? (GitHub Actions, GitLab CI)
   - Do they want pre-commit hooks?

3. **Create the framework files**:
   - `.agent-state/tasks.yaml` - Task registry
   - `.agent-state/locks.yaml` - Lock registry
   - `tools/check-ownership.py` - Ownership verification script
   - `AGENTS.md` - Shared collaboration rules
   - `GUARDRAILS.md` - Ownership and enforcement rules
   - `CLAUDE.md` - Lead agent directive
   - Agent-specific files (GEMINI.md, CODEX.md) if needed

4. **Configure tooling**:
   - Update or create `.pre-commit-config.yaml` if requested
   - Create `.github/workflows/ownership-check.yml` if GitHub Actions requested

5. **Customize ownership matrix**:
   - Update `OWNERSHIP_MATRIX` in check-ownership.py based on project structure
   - Configure shared and unrestricted files

## Templates

Use templates from the skill directory:
- `${CLAUDE_PLUGIN_ROOT}/skills/multi-agent-guide/templates/`

## After Setup

Remind the user to:
1. Set `SEO_AGENT_AUTHOR` environment variable
2. Install pre-commit hooks: `pre-commit install`
3. Verify setup: `python tools/check-ownership.py --verify-setup`

## Output

Provide a summary of created files and next steps.
