.

skills/plano/SKILL.md

@@ -5,30 +5,32 @@ scope: global
 updatedAt: "2026-09-28"
 ---
 
-# Skill: /plano (Gestão e Execução de Planos Técnicos)
+# Skill: /plano (Criação e Gestão de Planos Técnicos)
 
-Esta skill capacita o agente a atuar como ponte técnica entre o **Tester / QA** e o **Desenvolvedor**, formalizando demandas de homologação em planos de implementação completos na pasta `./PLANOS/pendente/` e executando-os deterministamente para posterior arquivamento em `./PLANOS/executado/`.
+Esta skill capacita o agente a atuar como ponte técnica entre o **Tester / QA** e o **Desenvolvedor**, formalizando demandas de homologação em planos de implementação completos na pasta `./PLANOS/pendente/` sem interromper a rotina de testes. Para a fase de implementação e codificação, aciona-se a skill dedicada [`/plano.executar`](../plano.executar/SKILL.md).
 
 ---
 
 ## 🎯 Gatilhos e Comandos
 
-A skill é acionada por comandos iniciando com `/plano`:
-
 ```bash
 # 1. Criação de novo plano técnico (Fase de Tester / Review)
 /plano <instrução ou descrição da melhoria / bug>
 
-# 2. Listagem da fila de planos
+# 2. Listagem e panorama da fila de planos
 /plano listar
 
-# 3. Execução de um plano existente (Fase de Desenvolvimento)
-/plano executar <slug-ou-nome-do-arquivo>
+# 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
 
 # 4. Arquivamento manual de um plano já concluído
 /plano arquivar <slug-ou-nome-do-arquivo>
 ```
 
+> 💡 **Nota de Compatibilidade:** Caso o operador invoque a sintaxe `/plano executar <slug>`, o agente automaticamente acionará o procedimento canônico de [`/plano.executar`](../plano.executar/SKILL.md).
+
 ---
 
 ## 🛠️ Procedimento Operacional: Criação de Plano (`/plano <instrução>`)
@@ -72,13 +74,13 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
   - **3. Critérios de Aceite & Validação (DoD):** Checklist com caixas `- [ ]` contendo condições verificáveis de sucesso.
   - **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.
+  - **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`.
 
 ### 4. Resposta ao Usuário
 - Informe o link do arquivo criado em `./PLANOS/pendente/`.
 - Apresente um resumo sucinto dos módulos impactados e critérios de aceite.
-- Sinalize que o plano está na fila e que o tester pode continuar a homologação criando novos planos ou solicitar a execução via `/plano executar <slug>`.
+- Sinalize que o plano está na fila e que o tester pode continuar a homologação criando novos planos com `/plano` ou solicitar a implementação via `/plano.executar`.
 
 ---
 
@@ -87,47 +89,27 @@ 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)**
-   - **Planos Executados (Concluídos)**
+   - **Planos Pendentes (Aguardando Dev):** ID, Título, Prioridade, Data de Criação.
+   - **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`.
 
 ---
 
-## 🛠️ Procedimento Operacional: Execução (`/plano executar <slug>`)
+## 🛠️ Procedimento Operacional: Execução
 
-Quando invocado para implementar um plano existente:
+Para implementar qualquer plano da fila, a operação canônica é delegada para:
 
-### 1. Localização e Leitura
-- Localize o arquivo em `./PLANOS/pendente/` correspondente ao slug fornecido.
-- Leia o conteúdo integral com `view_file`.
-
-### 2. Implementação Rigorosa
-- Execute as mudanças solicitadas nos pacotes apropriados, seguindo:
-  - `rules/diagnostico-antes-correcao.md`
-  - `rules/literatura-tecnica-e-usabilidade.md`
-  - `workflows/codigo-limpo.md` (limite de 250 linhas por arquivo, Dispatch Tables)
-  - `rules/feedback-visivel.md` (feedback claro na UI e logs no backend)
-  - `rules/fronteiras-monorepo.md` (não vazar dependências entre back e front)
-
-### 3. Validação e Qualidade
-- Execute checagens de integridade:
-  - `biome check --write <arquivos-alterados>`
-  - `bun run typecheck` ou `tsc --noEmit` (se aplicável ao pacote)
-  - `sh .agent/verificar-linhas.sh`
-- Valide os critérios de aceite definidos na Seção 3 do plano.
-
-### 4. Transição para Executado
-- Atualize o conteúdo do plano:
-  - Frontmatter: `status: "executado"`, `data-execucao: "YYYY-MM-DD HH:mm"`, `executor: "<nome-ou-agente>"`.
-  - Seção 6 (`Histórico de Execução`): registre arquivos modificados, resumo da solução e evidências de validação.
-- Mova o arquivo de `./PLANOS/pendente/YYYY-MM-DD-<slug>.md` para `./PLANOS/executado/YYYY-MM-DD-<slug>.md` (usando `write_to_file` no destino e removendo da pasta pendente).
-- Registre a ação em `memorias-ia/sessao-YYYY-MM-DD-<slug>.md` e indexe em `memorias-ia/historico-acoes.md`.
-- Lembre-se: **nunca execute git commit na aplicação** (`rules/proibido-commit-ia.md`). Sugira a mensagem de commit para o usuário.
+👉 **[`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)
 
 ---
 
-## 🛠️ Procedimento Operacional: Arquivamento (`/plano arquivar <slug>`)
+## 🛠️ Procedimento Operacional: Arquivamento Manual (`/plano arquivar <slug>`)
 
+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"` e registre a data.
+2. Atualize o frontmatter para `status: "executado"`, registrando `data-execucao` e executor.
 3. Mova o arquivo para `./PLANOS/executado/`.
 4. Notifique o usuário da conclusão do arquivamento.