# Visão de Produto — Execução Paralela de Agent Teams no TUI

> Origem: input do usuário (2026-06-06)
> Etapa: 1 — Ideia
> Próximo artefato: `02-prd.md`

---

## problema

Nas etapas de Execution e Review do fluxo SDLC, as tasks são executadas sequencialmente por subagents — uma de cada vez. Isso desperdiça tempo quando as tasks são independentes entre si. Além disso, o TUI não oferece visibilidade do que acontece durante essas etapas: o usuário não sabe quantos agentes estão ativos, quais tasks estão em andamento, quais concluíram ou falharam. Isso gera incerteza e dificulta a identificação de gargalos.

---

## objetivo

Introduzir no TUI a capacidade de despachar múltiplos agent teams simultaneamente nas etapas de Execution e Review, exibindo o progresso individual de cada agente em tempo real, e só avançar para a geração dos artefatos finais quando todos os agentes tiverem concluído.

---

## usuários

Engenheiros e tech leads que usam o sdd-layer como harness de orquestração SDLC. São usuários técnicos, confortáveis com CLI/TUI, que valorizam eficiência, rastreabilidade e controle sobre o fluxo de desenvolvimento.

---

## critérios de sucesso

- O TUI exibe quantos agentes foram despachados e o status individual de cada um (aguardando / em execução / concluído / erro).
- A interface permanece responsiva durante a execução paralela dos agentes (não-bloqueante).
- Os artefatos finais são gerados somente após todos os agentes concluírem.
- Todas as tasks aprovadas recebem um agente atribuído — nenhuma task fica sem execução.
- Falhas em agentes individuais são destacadas sem interromper os demais agentes em execução.

---

## escopo MVP

- Despacho paralelo de agent teams em Execution e Review com base nas tasks da etapa anterior.
- Painel no TUI: lista de agentes ativos, status individual, contador global de progresso (ex.: "4 de 6 agentes concluídos").
- Atualização assíncrona do painel sem bloquear o loop de renderização do TUI.
- Barreira de sincronização antes da geração dos artefatos.
- Exibição de erro por agente de forma isolada.

---

## riscos iniciais

- Concorrência no TUI: múltiplos agentes atualizando estado simultaneamente pode introduzir race conditions na camada de renderização.
- Determinismo dos artefatos: sem lógica de merge clara, agentes paralelos podem produzir saídas conflitantes.
- Rate limits: sem throttle no MVP, muitos agentes simultâneos podem saturar limites dos providers de LLM.

---

## Rastreabilidade

- Slug da orquestração: `tui-team-agents-execution-review`
- Caminho local: `docs/tui-team-agents-execution-review/01-idea.md`
