# Minimal Multi-Agent Setup Example

This example shows the minimum files needed for a 2-agent setup (Claude + Codex).

## Directory Structure

```
project/
├── .agent-state/
│   ├── tasks.yaml
│   └── locks.yaml
├── tools/
│   └── check-ownership.py
├── AGENTS.md
├── GUARDRAILS.md
└── CLAUDE.md
```

## Files Created

1. **AGENTS.md** - Basic agent hierarchy (Claude lead, Codex sub-agent)
2. **GUARDRAILS.md** - Simplified ownership matrix
3. **CLAUDE.md** - Lead agent directive
4. **.agent-state/** - Task and lock management
5. **tools/check-ownership.py** - Verification script

## Setup Steps

1. Create directories:
   ```bash
   mkdir -p .agent-state tools
   ```

2. Copy templates (customize as needed):
   ```bash
   # From skill templates
   cp templates/agents-md.md AGENTS.md
   cp templates/guardrails-md.md GUARDRAILS.md
   cp templates/claude-md.md CLAUDE.md
   cp templates/tasks-yaml.yaml .agent-state/tasks.yaml
   cp templates/locks-yaml.yaml .agent-state/locks.yaml
   cp scripts/check-ownership.py tools/check-ownership.py
   ```

3. Set environment variable:
   ```bash
   export SEO_AGENT_AUTHOR=claude
   ```

4. Verify setup:
   ```bash
   python tools/check-ownership.py --verify-setup
   ```

## Ownership Matrix (Minimal)

| Agent | Owns |
|-------|------|
| Claude | `src/`, `CLAUDE.md`, `AGENTS.md`, `GUARDRAILS.md` |
| Codex | `tests/`, `CODEX.md` |

## Commit Format

```
[Claude] type(scope): description
[Codex] type(scope): description
```
