This commit is contained in:
Luiz Silva 2026-09-30 10:50:44 -03:00
parent e7adba8fd8
commit 1f79b0c403
10 changed files with 221 additions and 89 deletions

View file

@ -3,7 +3,7 @@ type: workflow
name: plano
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"
updatedAt: "2026-09-30"
---
# Workflow: /plano e /plano.executar (Gestão e Execução de Planos Técnicos)
@ -11,11 +11,11 @@ updatedAt: "2026-09-28"
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 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 <instrução>` $\rightarrow$ Diagnostica a demanda sem mexer em código e gera um plano técnico em `PLANOS/pendente/AAAA-MM-DD-HH-mm-<slug>.md`.
> - `/plano listar` $\rightarrow$ Exibe o panorama da fila de planos pendentes (FIFO) e executados.
> - `/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.executar todos` $\rightarrow$ Executa sequencialmente todos os planos pendentes em ordem de chegada (FIFO - com circuit breaker).
> - `/plano arquivar <slug>` $\rightarrow$ Move manualmente um plano para `PLANOS/executado/`.
---
@ -35,7 +35,7 @@ Durante a navegação, testes manuais ou homologação de telas e rotas, o teste
┌─────────────────────────────────┐ ┌─────────────────────────────┐
│ 1. FASE DE REVIEW │ │ 2. FILA DE TRABALHO │
│ (Tester / Homologação) │ ───▶ │ (./PLANOS/pendente/) │
│ /plano <instrução> │ │ │
│ /plano <instrução> │ │ Ordem de Chegada (FIFO) │
└─────────────────────────────────┘ └──────────────┬──────────────┘
│
▼
@ -58,13 +58,14 @@ Quando o comando for executado:
- Identifica a causa raiz ou o ponto exato de intervenção.
2. **Formatação do Nome do Arquivo:**
- Formato: `PLANOS/pendente/YYYY-MM-DD-<slug-em-kebab-case>.md`
- Onde `YYYY-MM-DD` é a data atual da máquina e `<slug>` reflete a essência do plano.
- Formato: `PLANOS/pendente/AAAA-MM-DD-HH-mm-<slug-em-kebab-case>.md`
- Onde `AAAA-MM-DD-HH-mm` é a data e hora locais atuais da máquina (com dois dígitos para dia, mês, hora 24h e minuto).
- **Propósito:** A inclusão de hora e minuto viabiliza que a ordenação alfabética/lexicográfica coincida nativamente com a ordem de chegada (FIFO), orientando a fila de execução serial do desenvolvedor.
3. **Escrita do Documento:**
- Utiliza a estrutura do template canônico `.agent/DOCUMENTACAO/templates/plano.md.template`.
- Preenche:
- Frontmatter com `status: pendente` e tags do domínio.
- Frontmatter com `id: AAAA-MM-DD-HH-mm-<slug>`, `data-criacao: "AAAA-MM-DD HH:mm"`, `status: pendente` e tags do domínio.
- Objetivo & Contexto (visão funcional).
- Diagnóstico Técnico & Evidências (repro steps e arquivos mapeados).
- Critérios de Aceite (Definition of Done).
@ -79,7 +80,7 @@ Quando o comando for executado:
## 📋 Fase 2: Gestão da Fila (`/plano listar`)
Para visualizar o status atual de todos os planos:
- Lista arquivos em `PLANOS/pendente/` (status, título, prioridade, data).
- Lista arquivos em `PLANOS/pendente/` ordenados por ordem de chegada FIFO (status, título, prioridade, data).
- Lista arquivos em `PLANOS/executado/` (data de execução, executor).
---
@ -103,8 +104,8 @@ O Orquestrador divide as tarefas entre os especialistas:
### 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.
- **Modo 2: Por identificador (`/plano.executar <slug-ou-id>`)** $\rightarrow$ Localiza por slug, ID ou nome de arquivo (suportando formatos novo e legado).
- **Modo 3: Fila serial em ordem de chegada (`/plano.executar todos`)** $\rightarrow$ Ordena os pendentes em estrita ordem cronológica de chegada (FIFO: o mais antigo criado é executado primeiro; arquivos com prefixo temporal `AAAA-MM-DD-HH-mm-` ordenam-se alfabeticamente; legados usam data de criação/mtime) e processa sequencialmente um a um com circuit breaker caso ocorra erro irrecuperável.
---
@ -115,17 +116,22 @@ Ao confirmar que a implementação está verde e validada:
1. **Atualização do Plano:**
- Atualiza o frontmatter do arquivo:
- `status: executado`
- `data-execucao: "YYYY-MM-DD HH:mm"`
- `data-execucao: "AAAA-MM-DD HH:mm"`
- `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:**
- Move o arquivo de:
`PLANOS/pendente/YYYY-MM-DD-<slug>.md`
- Move o arquivo preservando o nome original:
`PLANOS/pendente/<nome-original>.md`
para:
`PLANOS/executado/YYYY-MM-DD-<slug>.md`
`PLANOS/executado/<nome-original>.md`
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`.
- Cria o registro de sessão em `memorias-ia/sessao-AAAA-MM-DD-<slug>.md`.
- Indexa no `memorias-ia/historico-acoes.md`.
- Executa `git add` nos arquivos alterados e sugere o comando de commit semântico ao operador (seguindo `rules/proibido-commit-ia.md`).
4. **Notificação no Sistema Operacional (Linux & macOS):**
- Dispara alerta sonoro e notificação visual de desktop via `.agent/notificar.sh`:
`sh .agent/notificar.sh "Plano Concluído" "<Nome ou Título do Plano>" sucesso`
- Na conclusão de toda a fila serial de `/plano.executar todos`, emite a notificação consolidada de encerramento do lote para avisar o operador no CLI.