Verificando acesso...

MÓDULO 4.5

🚧 Limitações conhecidas

A feature é experimental — saiba o que ainda não funciona.

6
Tópicos
30
Minutos
Intermediário
Nível
Reference
Tipo
1

🔁 /resume não restaura teammates

Após /resume, o lead pode tentar mensageriar teammates que não existem mais. Mande respawnar.

📌 Workaround

Spawnando novos.

  • •Spawne novos teammates
  • •Informe o lead da troca
  • •Aceite o 'reset parcial'
  • •Salve estado em arquivo antes de /resume
2

⏳ Status pode atrasar

Teammate às vezes esquece de marcar task como completed e bloqueia dependentes. Sintoma: time parece parado.

📌 Como destravar

Quando aplicar cada um.

  • •Marque manualmente se task está realmente pronta
  • •Cutuque o teammate via mensagem
  • •Audit antes de cleanup
  • •Considere TaskCompleted hook automático
3

🐌 Shutdown pode ser lento

Teammate termina request/tool atual antes de sair — shutdown demora minutos se uma build estiver rodando.

💡 Espere

Não force kill se der tempo. Espera é mais limpa que arquivos órfãos.

📌 Tools típicas longas

Quem causa o delay.

  • •Build (npm run build, bundler)
  • •Test suite completa
  • •Migration de DB
  • •Upload grande
4

1️⃣ 1 team por sessão

Um lead gerencia apenas um team por vez. Cleanup antes de spawnar outro. Não há 'mudança de time' no meio.

📌 Estratégia

Sessões separadas para teams independentes.

  • •Cleanup → novo spawn na mesma sessão
  • •Sessões diferentes para teams paralelos
  • •Plan-spawn-execute-cleanup como ciclo padrão
  • •Não tente 'reaproveitar' o lead
5

🪆 Sem nested teams

Apenas o lead pode criar/gerenciar team. Teammates não criam sub-teams nem outros teammates. Modelagem hierárquica não funciona.

💡 Workaround para 'ajudante'

Subagent dentro do teammate é OK. Use subagent para o ajudante de quem é teammate.

📌 Pense flat

Lead = único orquestrador.

  • •Sem nesting de teams
  • •Subagents dentro de teammates: OK
  • •Lead = único orquestrador
  • •Pode promover via re-spawn em nova sessão
6

🪟 Split-pane requer terminal certo

VS Code Terminal, Windows Terminal e Ghostty NÃO suportam split. Use in-process ou outro terminal.

📊 Compatibilidade

  • ✓ Linux + tmux
  • ✓ macOS + tmux
  • ✓ macOS + iTerm2 + it2
  • ✗ VS Code integrated
  • ✗ Windows Terminal
  • ✗ Ghostty

📌 Resumo do Módulo

✓
/resume não restaura teammates — In-process não persiste
✓
Status pode atrasar — Tasks sem completar
✓
Shutdown pode ser lento — Aguarda turn ou tool
✓
1 team por sessão — Cleanup antes de criar outro
✓
Sem nested teams — Teammate não spawna time
✓
Split-pane requer terminal certo — Tmux ou iTerm2

Próximo módulo:

5.1 — Codex CLI Subagents

← Voltar para Trilha Próximo Módulo →