---
name: kairos:contratar
description: >
  Contrata (recruta) um novo agente especialista para compor o squad.
  Agentes de nível 5+ (Especialista) podem sugerir contratações.
  Use quando o usuário disser "kairos contratar", "recrutar agente",
  "contratar especialista", "adicionar agente ao time", "precisamos de
  um especialista em X".
argument-hint: "[descrição do especialista necessário]"
user-invocable: true
disable-model-invocation: false
---

# KairOS — Contratação de Agentes

O time identificou uma necessidade: **$ARGUMENTS**

## Etapa 1: Análise da Necessidade

1. Leia os squads atuais em `.kairos/squads/` e `scripts/squad-fabrica.yaml`
2. Identifique o **GAP** — qual especialidade está faltando?
3. Identifique qual **squad existente** o novo agente deveria integrar
4. Verifique se já existe um agente com papel similar (evitar duplicação)

## Etapa 2: Identificar o Recrutador

Verifique nos logs (`.kairos/logs/`) e tasks (`.kairos/tasks/concluido/`) qual agente do squad tem mais experiência (mais tasks concluídas + mais log entries). Este agente será o **mentor** do novo recruta.

Se nenhum agente qualificado for encontrado, o Tech Lead assume como mentor padrão.

## Etapa 3: Propor Novo Agente

Projete o novo agente seguindo o padrão KairOS:

```yaml
- id: <id-kebab-case>
  nome: "<Nome> [<Papel>]"
  icone: "<emoji>"
  papel: "<Papel>"
  especialidade: |
    <Descrição detalhada da expertise>
  comportamento: |
    <Como o agente se comporta e interage>
  instrucoes: |
    <Instruções específicas de atuação>
```

**Regras de naming:**
- Nome brasileiro em português
- Formato `Nome [Papel]` com emoji icone
- ID em kebab-case (ex: `ana-acessibilidade`)
- Papel curto e descritivo

## Etapa 4: Confirmação

Apresente a proposta ao usuário:

```
══════════════════════════════════════════
  KairOS Contratar — Nova Proposta
══════════════════════════════════════════

  Necessidade:   {descrição do gap}
  Squad destino: {squad.nome}
  Mentor:        {mentor.icone} {mentor.nome}

  Novo Agente Proposto:
    {icone} {nome}
    Papel:          {papel}
    Especialidade:  {especialidade}
    Nível inicial:  1 (Estagiário)

  Confirmar contratação? (s/n)
══════════════════════════════════════════
```

## Etapa 5: Registro

Se confirmado:

1. Adicione o novo agente ao arquivo YAML do squad correspondente
   - Se squad fábrica: editar `scripts/squad-fabrica.yaml` (seção `agentes` e `times` se aplicável)
   - Se squad negocial: editar `dominios/<dominio>/squad-negocial.yaml`
   - Se squad customizado: editar `.kairos/squads/<squad>.yaml`

2. Registre a contratação no audit log:
   ```jsonl
   {"timestamp": "<ISO>", "tipo": "contratacao", "agente": "<mentor-id>", "detalhes": {"novo_agente": "<id>", "squad": "<squad-id>", "mentor": "<mentor-id>"}}
   ```

3. Exiba confirmação:
   ```
   ══════════════════════════════════════════
     KairOS — Agente Contratado! 🤝
   ══════════════════════════════════════════

     {icone} {nome}
     Squad:    {squad.nome}
     Mentor:   {mentor.icone} {mentor.nome}
     Nível:    1 (Estagiário)

     O novo agente está pronto para receber
     tarefas. Use /kairos:rodar para ativá-lo.
   ══════════════════════════════════════════
   ```

## Regras

- O novo agente SEMPRE começa no **Nível 1 (Estagiário)** com 0 XP
- O mentor é o agente com mais experiência no squad destino
- NÃO crie agentes duplicados (verifique por papel similar)
- NÃO crie agentes fora do escopo do squad/domínio
- Squads de apoio (`tipo: apoio`) NÃO implementam código — agentes de apoio produzem apenas artefatos textuais
- Respeite o formato `Nome [Papel]` com emoji icone

## Sistema de Níveis (Referência)

| Nível | XP    | Título       |
|-------|-------|--------------|
| 1     | 0     | Estagiário   |
| 2     | 100   | Júnior       |
| 3     | 350   | Pleno        |
| 4     | 800   | Sênior       |
| 5     | 1800  | Especialista |
| 6     | 4000  | Mestre       |
| 7     | 8000  | Lenda        |

Agentes ganham XP por: tasks concluídas (+50), commits (+10), análises (+8), evolução de prompts (+100), padrões aprendidos (+30×uso), debates (+25), persuasão (+40).

## Idioma

TODAS as mensagens em Português do Brasil.
