.

global/workflows/plano.md

@@ -1,19 +1,21 @@
 ---
 type: workflow
 name: plano
-description: Workflow oficial de Gestão, Criação e Execução de Planos Técnicos (fila PLANOS/pendente/ e PLANOS/executado/)
+description: Workflow oficial de Gestão, Criação (/plano) e Execução (/plano.executar) de Planos Técnicos com postura /goal e multiagentes
 scope: global
 updatedAt: "2026-09-28"
 ---
 
-# Workflow: /plano (Gestão de Planos Técnicos Tester ➔ Dev)
+# Workflow: /plano e /plano.executar (Gestão e Execução de Planos Técnicos)
 
-Workflow oficial para captura estruturada de demandas pelo **Tester / QA** durante homologações e execução determinística pelo **Desenvolvedor** no ecossistema Azteca.
+Workflow oficial para captura estruturada de demandas pelo **Tester / QA** durante homologações e execução determinística pelo time de desenvolvimento com postura obstinada **/goal** e orquestração de **multiagentes especialistas** no ecossistema Azteca.
 
 > 💡 **Comandos Rápidos:**
-> - `/plano <instrução>` $\rightarrow$ Diagnostica a demanda e gera um plano em `PLANOS/pendente/YYYY-MM-DD-<slug>.md`.
+> - `/plano <instrução>` $\rightarrow$ Diagnostica a demanda sem mexer em código e gera um plano técnico em `PLANOS/pendente/YYYY-MM-DD-<slug>.md`.
 > - `/plano listar` $\rightarrow$ Exibe o panorama da fila de planos pendentes e executados.
-> - `/plano executar <slug>` $\rightarrow$ Carrega o plano pendente, implementa o código, valida e arquiva em `PLANOS/executado/`.
+> - `/plano.executar` $\rightarrow$ Executa o último plano da conversa (ou pendente mais recente) sob a postura autônoma `/goal`.
+> - `/plano.executar <slug>` $\rightarrow$ Executa plano específico coordenando a equipe de especialistas (`@back`, `@front`, `@ux`, `@refatorar`, `@testes`, `@documentacao`).
+> - `/plano.executar todos` $\rightarrow$ Executa sequencialmente todos os planos pendentes em lote serial (com circuit breaker).
 > - `/plano arquivar <slug>` $\rightarrow$ Move manualmente um plano para `PLANOS/executado/`.
 
 ---
@@ -22,26 +24,26 @@ Workflow oficial para captura estruturada de demandas pelo **Tester / QA** duran
 
 Durante a navegação, testes manuais ou homologação de telas e rotas, o tester frequentemente encontra inconsistências, comportamentos inesperados, melhorias visuais ou lacunas de negócio.
 
-- **Problema anterior:** O tester precisava parar os testes para tentar implementar na hora, ou anotava observações soltas no chat que se perdiam ao final da conversa.
-- **Solução com `/plano`:** O tester invoca `/plano <instrução>`. A IA analisa tecnicamente o código e materializa a demanda em um arquivo padronizado em `PLANOS/pendente/`. O tester pode criar múltiplos planos em sequência na mesma sessão de review. Mais tarde, o desenvolvedor implementa cada um deles com foco total.
+- **Fase de Homologação com `/plano`:** O tester invoca `/plano <instrução>`. A IA analisa tecnicamente o código e materializa a demanda em um arquivo padronizado em `PLANOS/pendente/`. O tester pode criar múltiplos planos em sequência na mesma sessão de review sem parar os testes.
+- **Fase de Execução com `/plano.executar`:** O desenvolvedor aciona `/plano.executar`. O agente assume o papel de **Orquestrador Líder sob postura `/goal`**, acionando subagentes especialistas (`@back`, `@front`, `@ux`, `@refatorar`, `@testes`, `@documentacao`) para implementar as demandas de forma autônoma e completa.
 
 ---
 
 ## 🔄 Fluxo de Operação em 4 Fases
 
 ```
-┌───────────────────────────┐      ┌───────────────────────────┐
-│     1. FASE DE REVIEW     │      │     2. FILA DE TRABALHO   │
-│   (Tester / Homologação)  │ ───▶ │    (./PLANOS/pendente/)   │
-│   /plano <instrução>      │      │                           │
-└───────────────────────────┘      └─────────────┬─────────────┘
-                                                 │
-                                                 ▼
-┌───────────────────────────┐      ┌───────────────────────────┐
-│     4. ARQUIVAMENTO       │      │   3. IMPLEMENTAÇÃO DEV    │
-│   (./PLANOS/executado/)   │ ◀─── │   (Desenvolvedor / IA)    │
-│   Metadados & Histórico   │      │   /plano executar <slug>  │
-└───────────────────────────┘      └───────────────────────────┘
+┌─────────────────────────────────┐      ┌─────────────────────────────┐
+│        1. FASE DE REVIEW        │      │     2. FILA DE TRABALHO     │
+│      (Tester / Homologação)     │ ───▶ │     (./PLANOS/pendente/)    │
+│      /plano <instrução>         │      │                             │
+└─────────────────────────────────┘      └──────────────┬──────────────┘
+                                                        │
+                                                        ▼
+┌─────────────────────────────────┐      ┌─────────────────────────────┐
+│         4. ARQUIVAMENTO         │      │ 3. ORQUESTRADOR DEV /goal   │
+│      (./PLANOS/executado/)      │ ◀─── │   Multiagentes Especialistas│
+│      Metadados & Histórico      │      │     /plano.executar [...]   │
+└─────────────────────────────────┘      └─────────────────────────────┘
 ```
 
 ---
@@ -70,7 +72,7 @@ Quando o comando for executado:
      - Plano de Verificação & Testes.
 
 4. **Feedback Imediato ao Tester:**
-   - Informa o caminho do plano gerado e confirma que o review pode prosseguir.
+   - Informa o caminho do plano gerado e confirma que o review pode prosseguir com novos testes ou acionar a execução via `/plano.executar`.
 
 ---
 
@@ -82,28 +84,27 @@ Para visualizar o status atual de todos os planos:
 
 ---
 
-## 💻 Fase 3: Execução pelo Desenvolvedor (`/plano executar <slug>`)
+## 💻 Fase 3: Execução com /goal e Multiagentes (`/plano.executar`)
 
-Quando o desenvolvedor (ou operador) ordenar a implementação de um plano:
+A execução é conduzida pela skill canônica [`/plano.executar`](../skills/plano.executar/SKILL.md) atuando como **Orquestrador Líder**:
 
-1. **Carregamento do Plano:**
-   - A IA lê o arquivo correspondente em `PLANOS/pendente/<nome-do-arquivo>.md`.
-   - Se o usuário passou apenas parte do nome (ex.: `filtro-denuncia`), localiza o arquivo correspondente.
+### 1. Postura Operacional /goal
+- **Autonomia Contínua:** Não interrompe o fluxo para perguntas triviais; executa de ponta a ponta.
+- **Loop de Auto-Correção:** Caso linter ou typecheck apresente falhas, diagnostica a causa raiz, refatora e retesta iterativamente até atingir validação 100% verde.
 
-2. **Planejamento & Execução Cirúrgica:**
-   - Respeita as regras fundamentais:
-     - `rules/diagnostico-antes-correcao.md`
-     - `rules/literatura-tecnica-e-usabilidade.md`
-     - `workflows/codigo-limpo.md` (limite de 250 linhas, Dispatch Tables)
-     - `rules/feedback-visivel.md` (visibilidade de erros)
-     - `rules/fronteiras-monorepo.md` (respeitar fronteiras dos pacotes)
-   - Executa as alterações passo a passo nos pacotes afetados (`*-comuns`, `*-back`, `*-front`, etc.).
+### 2. Ativação da Equipe de Especialistas
+O Orquestrador divide as tarefas entre os especialistas:
+- **`@back`**: Implementa endpoints, queries Knex e schemas Zod em `*-comuns`.
+- **`@front`**: Implementa telas Vue 3, composables e formulários consumindo `*-comuns`.
+- **`@ux`**: Aplica as Heurísticas de Nielsen (visibilidade de loading/erro, feedback imediato).
+- **`@refatorar`**: Governança de Código Limpo (limite estrito de 250 linhas, Dispatch Tables).
+- **`@testes`**: Roda `typecheck`, `biome check` e validação visual via `agent-browser --headed`.
+- **`@documentacao`**: Documenta a memória da sessão (Pilar 6) e regras de negócio.
 
-3. **Verificação & Testes:**
-   - Roda checagem de tipos (`tsc --noEmit` / `bun run typecheck`).
-   - Roda formatação (`biome check --write <arquivos>`).
-   - Roda governança de linhas (`sh .agent/verificar-linhas.sh`).
-   - Valida os critérios de aceite definidos na seção 3 do plano.
+### 3. Modos de Invocação
+- **Modo 1: Sem parâmetros (`/plano.executar` ou `ultimo`)** $\rightarrow$ Localiza o último plano gerado no contexto da sessão ou mais recente na pasta.
+- **Modo 2: Por identificador (`/plano.executar <slug-ou-id>`)** $\rightarrow$ Localiza por slug, ID ou nome de arquivo.
+- **Modo 3: Fila serial (`/plano.executar todos`)** $\rightarrow$ Processa todos os pendentes sequencialmente, um a um, com circuit breaker caso ocorra erro irrecuperável.
 
 ---
 
@@ -115,7 +116,7 @@ Ao confirmar que a implementação está verde e validada:
    - Atualiza o frontmatter do arquivo:
      - `status: executado`
      - `data-execucao: "YYYY-MM-DD HH:mm"`
-     - `executor: "<nome-do-dev-ou-agente>"`
+     - `executor: "Orquestrador /goal + Multiagentes (@back, @front, @ux, @refatorar, @testes, @documentacao)"`
    - Preenche a Seção 6 (`Histórico de Execução`) com o resumo das modificações feitas e evidências de validação.
 
 2. **Movimentação do Arquivo:**
@@ -124,7 +125,7 @@ Ao confirmar que a implementação está verde e validada:
      para:
      `PLANOS/executado/YYYY-MM-DD-<slug>.md`
 
-3. **Registro na Memória do Projeto (Pilar 6):**
+3. **Registro na Memória do Projeto (Pilar 6 - @documentacao):**
    - Cria o registro de sessão em `memorias-ia/sessao-YYYY-MM-DD-<slug>.md`.
    - Indexa no `memorias-ia/historico-acoes.md`.
-   - Sugere o comando de commit staged para a aplicação (lembrando que commit automatizado na aplicação é proibido por `rules/proibido-commit-ia.md`).
+   - Executa `git add` nos arquivos alterados e sugere o comando de commit semântico ao operador (seguindo `rules/proibido-commit-ia.md`).