.

skills/plano/SKILL.md

@@ -2,7 +2,7 @@
 name: plano
 description: Criar e gerenciar planos técnicos de implementação em ./PLANOS/pendente/ gerados por testers e executados por devs
 scope: global
-updatedAt: "2026-09-28"
+updatedAt: "2026-09-30"
 ---
 
 # Skill: /plano (Criação e Gestão de Planos Técnicos)
@@ -23,7 +23,7 @@ Esta skill capacita o agente a atuar como ponte técnica entre o **Tester / QA**
 # 3. Execução pelo Desenvolvedor (Comando Canônico Dedicado)
 /plano.executar             # Executa o último plano da conversa ou mais recente
 /plano.executar <slug>      # Executa plano específico por slug/ID
-/plano.executar todos       # Executa todos os pendentes em lote serial
+/plano.executar todos       # Executa todos os pendentes em lote serial (ordem de chegada - FIFO)
 
 # 4. Arquivamento manual de um plano já concluído
 /plano arquivar <slug-ou-nome-do-arquivo>
@@ -37,10 +37,11 @@ Esta skill capacita o agente a atuar como ponte técnica entre o **Tester / QA**
 
 Quando invocado com uma instrução (ex.: `/plano corrigir validação do número do processo no formulário de denúncia`):
 
-### 1. Obter Data e Gerar Slug
-- Obtenha a data local atual no formato `YYYY-MM-DD`.
+### 1. Obter Data, Hora e Gerar Slug
+- Obtenha a data e hora locais atuais da máquina no formato `AAAA-MM-DD-HH-mm` (ano com 4 dígitos, mês, dia, hora 24h e minuto com 2 dígitos, ex.: `2026-09-30-10-35`).
 - Converta o tema principal da instrução em um slug sucinto em kebab-case (letras minúsculas e hífens, sem acentos ou caracteres especiais).
-- Caminho alvo: `./PLANOS/pendente/YYYY-MM-DD-<slug>.md`.
+- Caminho alvo: `./PLANOS/pendente/AAAA-MM-DD-HH-mm-<slug>.md`.
+- **Propósito da Nomenclatura:** A inclusão de hora (`HH`) e minuto (`mm`) no prefixo temporal viabiliza a ordenação lexicográfica determinística da fila (FIFO — First In, First Out), permitindo que `/plano.executar todos` processe os planos estritamente na ordem em que foram criados.
 
 ### 2. Diagnóstico Técnico Pré-Implementação (Sem alterar código)
 - **NÃO altere arquivos de código de produção nesta etapa.**
@@ -55,10 +56,10 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
   - **Frontmatter YAML:**
     ```yaml
     ---
-    id: YYYY-MM-DD-<slug>
+    id: AAAA-MM-DD-HH-mm-<slug>
     titulo: "<Título claro e direto>"
     origem: "Revisão Tester / QA"
-    data-criacao: "YYYY-MM-DD"
+    data-criacao: "AAAA-MM-DD HH:mm"
     data-execucao: null
     status: "pendente"
     prioridade: "media" # ou critica/alta/baixa
@@ -75,7 +76,7 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
   - **4. Especificação Técnica & Passos de Implementação:** Roteiro prático para o desenvolvedor (schemas, backend, frontend, código sugerido).
   - **5. Plano de Verificação & Testes:** Testes automatizados (`typecheck`, `biome`) e roteiro manual/E2E com `agent-browser`.
   - **6. Histórico de Execução:** Cabeçalho reservado para preenchimento na conclusão pelo executor.
-- Salve o arquivo em `./PLANOS/pendente/YYYY-MM-DD-<slug>.md` usando `write_to_file`.
+- Salve o arquivo em `./PLANOS/pendente/AAAA-MM-DD-HH-mm-<slug>.md` usando `write_to_file`.
 
 ### 4. Resposta ao Usuário
 - Informe o link do arquivo criado em `./PLANOS/pendente/`.
@@ -89,7 +90,7 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
 1. Liste os arquivos existentes em `./PLANOS/pendente/` e `./PLANOS/executado/`.
 2. Para cada arquivo, extraia título, data e prioridade do frontmatter.
 3. Exiba uma tabela Markdown organizada:
-   - **Planos Pendentes (Aguardando Dev):** ID, Título, Prioridade, Data de Criação.
+   - **Planos Pendentes (Aguardando Dev — Fila FIFO):** ID, Título, Prioridade, Data de Criação. Listados em ordem cronológica de chegada (mais antigo primeiro).
    - **Planos Executados (Concluídos):** ID, Título, Data de Execução, Executor.
 4. Lembre o operador dos atalhos de execução: `/plano.executar` ou `/plano.executar todos`.
 
@@ -102,14 +103,14 @@ Para implementar qualquer plano da fila, a operação canônica é delegada para
 👉 **[`skills/plano.executar/SKILL.md`](../plano.executar/SKILL.md)**:
 - `/plano.executar` (sem argumentos: último plano criado na conversa ou pendente mais recente)
 - `/plano.executar <slug>` (plano específico)
-- `/plano.executar todos` (processamento serial com circuit breaker)
+- `/plano.executar todos` (processamento serial em ordem de chegada FIFO com circuit breaker)
 
 ---
 
-## 🛠️ Procedimento Operacional: Arquivamento Manual (`/plano arquivar <slug>`)
+## 🛠️ Procedimento Operacional: Arquivamento Manual (`/plano arquivar <slug-ou-id>`)
 
 Quando um plano foi implementado externamente ou não requer alteração de código:
-1. Localize o arquivo em `./PLANOS/pendente/`.
-2. Atualize o frontmatter para `status: "executado"`, registrando `data-execucao` e executor.
-3. Mova o arquivo para `./PLANOS/executado/`.
+1. Localize o arquivo em `./PLANOS/pendente/` (aceita slug puro, ID completo ou nome de arquivo).
+2. Atualize o frontmatter para `status: "executado"`, registrando `data-execucao: "AAAA-MM-DD HH:mm"` e executor.
+3. Mova o arquivo para `./PLANOS/executado/` preservando o nome original do arquivo.
 4. Notifique o usuário da conclusão do arquivamento.