# Memória Operacional - tui-team-agents-execution-review

## Estado final
- Memória operacional gerada de forma determinística a partir dos artefatos locais existentes.
- O índice de intelligence deve ser reconstruído após alterações nos artefatos canônicos.

## Funcionalidades implementadas
- Idea: Visão de Produto — Execução Paralela de Agent Teams no TUI (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- PRD: PRD — Execução Paralela de Agent Teams no TUI (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- Tech Spec: Tech Spec — Execução e Review em Agent Teams Paralelos no TUI (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Tasks: Backlog Técnico — Execução e Review em Agent Teams Paralelos no TUI (fonte: `docs/tui-team-agents-execution-review/04-tasks.md`)
- Execution: Execution — Agent Teams Paralelos no TUI (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)

## Arquitetura atual
- Determinismo dos artefatos: sem lógica de merge clara, agentes paralelos podem produzir saídas conflitantes. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- RF-12: Identificação determinística de tasks independentes por ausência de dependência declarada (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- RNF-06: Artefato determinístico em relação ao conjunto de resultados (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- RN-08: Independência de tasks é determinística (baseada em declaração explícita) (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- Esta Tech Spec específica o despacho de múltiplos agent teams em paralelo nas etapas `Execution` e `Review` do TUI, com painel de progresso em tempo real (`ParallelRunning`), atualização assíncrona via `mpsc` sem bloquear a renderização, ba
...(truncado)
 (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- A feature estende o modelo single-receiver atual (`App.pending: Option<Receiver<StageEvent>>`) para um modelo multi-receiver (`Vec<AgentHandle>`), preservando o **reducer pattern** e o **event loop não-bloqueante** existentes. Sem `tokio`,
...(truncado)
 (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- **Decisão técnica central: Opção A — `Vec<AgentHandle>`, um `Receiver<StageEvent>` por agente.** (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Motivo: encaixa diretamente no `try_recv` loop atual; cada worker possui seu `Sender` exclusivo (sem locks); `StageEvent` não precisa de tagging; `spawn_stage` é reaproveitado por slot sem reescrita. (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)

## Decisões
- RN-04: Aceitar resultado parcial é decisão exclusiva do usuário (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- `Barrier`: Todos em estado terminal; aguardando decisão/composição (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- `PartialError`: Barreira atingida com erros; aguarda decisão do usuário (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- Quando o usuário escolhe "Aceitar resultado parcial" (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- **Decisão técnica central: Opção A — `Vec<AgentHandle>`, um `Receiver<StageEvent>` por agente.** (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- BARRIER -- sim, com erros --> DECISION[Screen::ParallelDecision] (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- DECISION -- Retentar --> RESPAWN[respawn slots em Erro] (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- DECISION -- Aceitar parcial --> COMPOSE (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- DECISION -- Cancelar --> BOARD[StageBoard] (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- ParallelRunning --> ParallelDecision: barreira fecha, ≥1 erro (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- ParallelDecision --> ParallelRunning: Retentar - respawn dos slots em Erro (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- ParallelDecision --> Composing: Aceitar parcial (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)

## Falhas recorrentes
- 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 aco
...(truncado)
 (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- --- (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- O TUI exibe quantos agentes foram despachados e o status individual de cada um (aguardando / em execução / concluído / erro). (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- A interface permanece responsiva durante a execução paralela dos agentes (não-bloqueante). (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- Falhas em agentes individuais são destacadas sem interromper os demais agentes em execução. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- Atualização assíncrona do painel sem bloquear o loop de renderização do TUI. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- Exibição de erro por agente de forma isolada. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- Concorrência no TUI: múltiplos agentes atualizando estado simultaneamente pode introduzir race conditions na camada de renderização. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- Determinismo dos artefatos: sem lógica de merge clara, agentes paralelos podem produzir saídas conflitantes. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- Rate limits: sem throttle no MVP, muitos agentes simultâneos podem saturar limites dos providers de LLM. (fonte: `docs/tui-team-agents-execution-review/01-idea.md`)
- O SDD-layer executa tasks das etapas Execution e Review de forma estritamente sequencial. Isso desperdiça tempo quando tasks são independentes entre si — o caso mais comum nessas duas etapas — e o TUI não oferece visibilidade de progresso d
...(truncado)
 (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)
- **O-2**: Exibir painel de acompanhamento (lista de agentes, status individual, contador global) sem bloquear o loop de renderização. (fonte: `docs/tui-team-agents-execution-review/02-prd.md`)

## Comandos confiáveis
- Código compila sem erros nem warnings (`cargo build --release`). (fonte: `docs/tui-team-agents-execution-review/04-tasks.md`)
- Todos os testes unitários passam (`cargo test`). (fonte: `docs/tui-team-agents-execution-review/04-tasks.md`)
- `rtk cargo fmt --check`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk cargo test`: 156 testes passaram. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk cargo clippy -- -D warnings`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk cargo build --release`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk git diff --check`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk cargo run -- validate-artifact tasks docs/tui-team-agents-execution-review/04-tasks.md`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk cargo run -- validate-artifact execution docs/tui-team-agents-execution-review/06-execution.md`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
- `rtk cargo run -- ci` falha no baseline do checkout porque `sdd doctor` exige assets em `.sdd/` que não estão instalados neste repositório-fonte; a falha foi reproduzida também em `rtk cargo run -- doctor`. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)

## Padrões úteis
- pub fn traceability_table(results: &[SlotResult]) -> String; (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- **Limite padrão recomendado**: `max_parallel_agents = 8` (configurável em `sdd.config.yaml`); acima disso o dispatcher enfileira e despacha em lotes. (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Tipo: Alvo: Estratégia (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Unitários (puro): `plan_parallel_slots`: Fixtures de `04-tasks.md` com 0, 1, N independentes; dependência declarada; IDs duplicados (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Unitários (puro): `compose_parallel_artifact`: Todos OK; parcial com erro; ordem determinística; seções obrigatórias presentes (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Unitários (puro): `traceability_table`: Formatos de status; todos concluídos; todos com erro (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Unitários (puro): `parallel_barrier_reached`: Estados mistos; todos Done; todos Erro; vazio (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Unitários (puro): `on_parallel_event`: Transições de status corretas; trace isolado por slot (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Integração: `spawn_parallel_agent`: Fixture com binário `true`/`false`; rx recebe `Finished`; `Disconnected` tratado como Erro (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Regressão UI: `renders_all_screens_no_panic`: Incluir `ParallelRunning` e `ParallelDecision` em larguras 80 e 120 (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- Regressão: Caminho single-agent: `start_stage` / `pending` inalterados para etapas != Execution/Review (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)
- --- (fonte: `docs/tui-team-agents-execution-review/03-techspec.md`)

## Testes e comandos
- Comandos confiáveis para começar a validação:
  - Código compila sem erros nem warnings (`cargo build --release`). (fonte: `docs/tui-team-agents-execution-review/04-tasks.md`)
  - Todos os testes unitários passam (`cargo test`). (fonte: `docs/tui-team-agents-execution-review/04-tasks.md`)
  - `rtk cargo fmt --check`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk cargo test`: 156 testes passaram. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk cargo clippy -- -D warnings`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk cargo build --release`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk git diff --check`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk cargo run -- validate-artifact tasks docs/tui-team-agents-execution-review/04-tasks.md`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk cargo run -- validate-artifact execution docs/tui-team-agents-execution-review/06-execution.md`: passou. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)
  - `rtk cargo run -- ci` falha no baseline do checkout porque `sdd doctor` exige assets em `.sdd/` que não estão instalados neste repositório-fonte; a falha foi reproduzida também em `rtk cargo run -- doctor`. (fonte: `docs/tui-team-agents-execution-review/06-execution.md`)

## Pendências
- Revisar esta memória em checkpoint humano quando houver decisões de produto ou arquitetura que não aparecem nos artefatos atuais.

## Próximos passos
- Rodar `sdd intelligence learn --all` após qualquer alteração relevante neste diretório de artefatos.

## Contexto para o próximo agente
- Orquestração: `tui-team-agents-execution-review`
- Slug: `tui-team-agents-execution-review`
- Gerado em: `2026-07-04T19:17:58Z`

## Rastreabilidade
- Origem local: `docs/tui-team-agents-execution-review/traceability-map.yaml`
- Artefatos lidos:
  - `docs/tui-team-agents-execution-review/01-idea.md` (idea)
  - `docs/tui-team-agents-execution-review/02-prd.md` (prd)
  - `docs/tui-team-agents-execution-review/03-techspec.md` (techspec)
  - `docs/tui-team-agents-execution-review/04-tasks.md` (tasks)
  - `docs/tui-team-agents-execution-review/06-execution.md` (execution)
- Artefatos esperados para fechamento da memória:
  - `docs/tui-team-agents-execution-review/06-adr.md`
  - `docs/tui-team-agents-execution-review/07-review.md`
