- Add 91-multi-agent-guide skill for setting up multi-agent collaboration with templates for AGENTS.md, Claude, Gemini, Codex configs, and CI/CD - Add USER-GUIDE.md for reference-curator documentation - Update default paths in reference-curator configs to use ~/Documents/05_AI Agent/10_Reference Library/ - Update settings-audit-report.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
68 lines
1.5 KiB
Markdown
68 lines
1.5 KiB
Markdown
# 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
|
|
```
|