# Squad Examples

> **EN** | [PT](../../pt/guides/squad-examples/README.md) | [ES](../../es/guides/squad-examples/README.md)

---

This directory contains example Squad configurations to help you get started.

## Available Examples

### 1. Simple Agent (`simple-agent.yaml`)

A minimal agent example focused on documentation tasks. Great starting point for:
- Understanding agent structure
- Learning command definitions
- Basic system prompt patterns

### 2. Data Processor Squad (`data-processor-squad.yaml`)

A complete squad manifest showing:
- Multiple agents working together
- Task definitions with dependencies
- Workflow orchestration
- External npm dependencies
- Configuration options

## Using These Examples

### Copy and Customize

```bash
# Copy an example to start your squad
cp docs/guides/squad-examples/simple-agent.yaml my-squad/agents/my-agent.yaml

# Edit to match your needs
code my-squad/agents/my-agent.yaml
```

### Learn by Reading

Each example includes comments explaining:
- Why certain patterns are used
- Best practices being demonstrated
- Common customization points

## Creating Your Own

1. Start with the [Squad Template](../../../templates/squad/)
2. Reference these examples for patterns
3. Follow the [Squads Guide](../squads-guide.md)

## Contributing Examples

Have a useful squad pattern? We welcome contributions!

1. Create your example in this directory
2. Add clear comments explaining the pattern
3. Update this README with description
4. Submit a PR following [CONTRIBUTING.md](../../../CONTRIBUTING.md)

---

*AIOX Squads: Equipes de AI agents trabalhando com você* 🤖
