.
This commit is contained in:
parent
e7adba8fd8
commit
1f79b0c403
10 changed files with 221 additions and 89 deletions
|
|
@ -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.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue