---
name: kairos:otimizar
description: Iteração autônoma para otimizar métricas técnicas do projeto. Inspirado no AutoResearch de Karpathy. Use quando o usuário disser "kairos otimizar", "melhorar cobertura", "reduzir bundle", "otimizar performance", "reduzir latência", "eliminar any", "melhorar acessibilidade", ou qualquer tarefa com métrica mensurável que possa ser melhorada iterativamente.
disable-model-invocation: true
---

# KairOS-AI — Otimizar (AutoResearch Técnico)

Loop autônomo de melhoria: Modificar → Verificar → Manter/Descartar → Repetir.
Baseado no AutoResearch de Karpathy, adaptado para o contexto da fábrica de software KairOS.

## Princípio

Restrição + métrica mecânica + iteração autônoma = ganhos compostos.

## Como Usar

```
/kairos:otimizar
Meta: Aumentar cobertura de testes de 72% para 90%
Escopo: src/**/*.test.ts, src/**/*.ts
Métrica: cobertura % (maior é melhor)
Verificar: npm test -- --coverage | grep "All files"
```

## Comportamento

### Fase de Setup (uma vez)

1. Ler todos os arquivos no escopo definido
2. Extrair ou confirmar a métrica mecânica (deve ser um número)
3. Definir escopo de arquivos modificáveis vs somente-leitura
4. Criar arquivo de resultados `kairos/otimizacao/<nome>-resultados.tsv`
5. Rodar verificação no estado atual = baseline (iteração #0)
6. Mostrar setup e iniciar o loop

### Loop Autônomo (repete indefinidamente)

```
LOOP:
  0. CIRCUIT BREAKER — Atualizar .kairos/estado/loop-state.json
     Chamar: bash ${CLAUDE_PLUGIN_ROOT}/scripts/circuit-breaker.sh
     Se retornar PARAR → interromper com mensagem. Para retomar: --retomar
     Se retornar OK → prosseguir
  1. REVISAR — Ler estado atual + git log + resultados anteriores
  2. ANALISAR FALHAS — O que não melhorou? Por quê? Padrões?
  3. HIPOTETIZAR — Formular UMA hipótese de melhoria
  4. MODIFICAR — Fazer UMA mudança atômica (explicável em 1 frase)
  5. COMMITAR — Git commit ANTES da verificação (rollback limpo)
  6. VERIFICAR — Rodar comando de verificação mecânica
  7. DECIDIR:
     - Melhorou → MANTER (keep)
     - Piorou → REVERTER (git revert)
     - Quebrou → CORRIGIR ou PULAR
  8. REGISTRAR — Append resultado no TSV + registrar no Radar
  9. REPETIR — Voltar ao passo 1. NUNCA PARAR. NUNCA PERGUNTAR.
```

### Regras Duras

- **UMA mudança por iteração.** Se mudar 5 coisas e melhorou, não sabe qual causou.
- **NUNCA perguntar "devo continuar?"** — continuar até atingir a meta ou ser interrompido.
- **Após 3 iterações sem melhoria**, tentar mudança estrutural (não só ajuste de wording).
- **Registrar TUDO no Radar** — cada iteração vira entrada no audit log.

### Formato do TSV de Resultados

```
iteracao	commit	metrica	delta	status	descricao
0	a1b2c3d	72.0	0.0	baseline	estado inicial — cobertura 72%
1	b2c3d4e	74.5	+2.5	manter	testes para middleware de auth
2	-	73.8	-0.7	descartar	refatorar test helpers (quebrou 2 testes)
3	c3d4e5f	76.2	+1.7	manter	testes de error handling nas rotas
```

### Resumo a cada 10 iterações

```
=== KairOS Otimização — Progresso (iteração 20) ===
Baseline: 72.0% → Melhor atual: 88.3% (+16.3%)
Mantidas: 8 | Descartadas: 10 | Quebradas: 2
Últimas 5: manter, descartar, descartar, manter, manter
```

### Agente Responsável

Da fábrica de software, acionar o agente mais adequado:
- **Cobertura de testes** → Ricardo (QA) + Patrícia (QA Lead)
- **Bundle size** → Marina (Frontend) + Vinícius (Performance)
- **Latência de API** → Lucas (Backend) + Vinícius (Performance)
- **Violações de segurança** → Helena (Security)
- **Acessibilidade** → Aline (Accessibility)
- **Tipos TypeScript** → Marina ou Lucas
- **Tamanho de imagem Docker** → Marcos (DevOps)
- **Queries SQL lentas** → Carlos (DBA)

### Integração com Agent Teams

Para otimizações que afetam múltiplas áreas, usar `/kairos:mobilizar` para criar um Agent Team onde cada teammate otimiza uma fatia do escopo em paralelo.

### Integração com Radar

Cada iteração gera uma entrada no audit log:

```yaml
- timestamp: "..."
  tipo: otimizacao_iteracao
  meta: "cobertura de testes"
  iteracao: 15
  metrica_antes: 85.2
  metrica_depois: 86.8
  delta: +1.6
  status: manter
  descricao: "testes para validação de CNAE"
  custo_tokens: 3200
```

Tudo em Português do Brasil.