implementado graphify.sh

skills/plano.executar/SKILL.md

@@ -123,6 +123,7 @@ Em implementações integradas, o Orquestrador segue a ordem canônica de handof
 ### 1. Leitura e Decomposição
 - Lê o plano integralmente com `view_file`.
 - Mapeia os critérios de aceite (Definition of Done) na Seção 3 e especificações na Seção 4.
+- Caso novos arquivos precisem ser inspecionados além dos previstos no plano, consulta o Grafo de Conhecimento via `bash .agent/scripts/graphify.sh explain "<simbolo-ou-arquivo>"` ou `bash .agent/scripts/graphify.sh impact <arquivos>`.
 - Orquestrador define os especialistas necessários.
 
 ### 2. Implementação Especializada
@@ -151,14 +152,16 @@ Ao atingir 100% de conformidade com todos os critérios do plano:
    - Seção 6 (*Histórico de Execução*): arquivos modificados, resumo da solução e evidências de validação.
 2. **Mover o Plano:**
    - Salvar em `./PLANOS/executado/<nome-original>.md` e remover de `./PLANOS/pendente/<nome-original>.md` (preservando o nome original do arquivo).
-3. **Memória do Projeto (Pilar 6 - @documentacao):**
+3. **Atualizar Grafo de Conhecimento (Graphify):**
+   - Executar `bash .agent/scripts/graphify.sh update` para atualizar o grafo de código com os novos símbolos, arquivos e relações implementados (garantindo automaticamente a instalação via Bun se ausente e as regras no `.gitignore`).
+4. **Memória do Projeto (Pilar 6 - @documentacao):**
    - Criar `memorias-ia/sessao-AAAA-MM-DD-<slug>.md`.
    - Indexar no `memorias-ia/historico-acoes.md`.
-4. **Staging e Commit Semântico:**
+5. **Staging e Commit Semântico:**
    - Executar `git add <arquivos>` e `git status`.
    - Inspecionar a branch atual com `git branch --show-current`: se estiver em `master` (ou `main`), criar e alternar para uma nova branch semântica (`git checkout -b <tipo>/<slug-plano>`) — **NUNCA comitar diretamente em `master`** (ver `rules/proibido-commit-ia.md`).
    - Executar o `git commit` semântico na branch de trabalho (`git commit -m "<tipo>(<escopo>): <descrição>"`).
-5. **Notificação no Sistema Operacional (Linux & macOS):**
+6. **Notificação no Sistema Operacional (Linux & macOS):**
    - Disparar notificação sonora e visual no SO via script `.agent/notificar.sh`:
      `sh .agent/notificar.sh "Plano Concluído" "<Nome ou Título do Plano>" sucesso`
    - O utilitário detecta automaticamente se o host é Linux (KDE `kdialog`, `notify-send`, `gdbus`, PipeWire/PulseAudio) ou macOS (`osascript` banner nativo + `afplay` áudio Glass + terminal bell `\a`), emitindo o alerta em background no ambiente do operador mesmo quando rodando via CLI.

skills/plano/SKILL.md

@@ -43,10 +43,22 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
 - 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)
+### 2. Diagnóstico Técnico Pré-Implementação com Graphify (Sem alterar código)
 - **NÃO altere arquivos de código de produção nesta etapa.**
-- Mapeie os pacotes afetados (`*-comuns`, `*-back`, `*-front`, `*-migracao`).
-- Inspecione rapidamente arquivos relevantes com `view_file` ou `grep_search` para identificar a causa raiz, props, schemas Zod, rotas ou componentes envolvidos.
+- **Consultar o Grafo de Conhecimento (`graphify.sh`):**
+  - O utilitário `.agent/scripts/graphify.sh` verifica e instala automaticamente o `@sentropic/graphify` via Bun caso não esteja instalado na máquina, atualiza de forma idempotente o `.gitignore` do projeto (`.graphify/`, `.engram/`, `graphify-out/`) e inicializa o grafo sob demanda (`ensure`) caso ainda não exista:
+    ```bash
+    # 1. Localizar nós, rotas, tabelas ou componentes relacionados à demanda
+    bash .agent/scripts/graphify.sh query "<termo-chave-da-demanda>"
+    bash .agent/scripts/graphify.sh explain "<simbolo-ou-arquivo>"
+    ```
+- Inspecione rapidamente os arquivos candidatos com `view_file` ou `grep_search` para identificar a causa raiz, props, schemas Zod, rotas ou componentes envolvidos.
+- **Mapear Raio de Impacto em Cascata (*Blast Radius*):**
+  - Com os arquivos candidatos identificados, execute a análise de impacto no grafo:
+    ```bash
+    bash .agent/scripts/graphify.sh impact <caminho/arquivo1> <caminho/arquivo2>
+    ```
+  - Utilize a saída (`Impacted files`, `High-risk dependency chains`, `Likely test gaps`) para determinar com precisão todos os pacotes em `modulos-impactados` (`*-comuns`, `*-back`, `*-front`, `*-migracao`) e mapear efeitos colaterais entre módulos.
 - Identifique o comportamento atual vs comportamento esperado.
 
 ### 3. Redigir e Persistir o Arquivo de Plano
@@ -71,7 +83,7 @@ Quando invocado com uma instrução (ex.: `/plano corrigir validação do númer
     ---
     ```
   - **1. Objetivo & Contexto:** Descrição concisa da demanda e impacto de negócio.
-  - **2. Diagnóstico Técnico & Evidências:** Comportamento observado vs esperado, repro steps e arquivos mapeados com links `[arquivo](file://...)`.
+  - **2. Diagnóstico Técnico & Evidências:** Comportamento observado vs esperado, repro steps, arquivos mapeados com links `[arquivo](file://...)` e subseção **Raio de Impacto & Dependências (Graphify)** extraída via `bash .agent/scripts/graphify.sh impact`.
   - **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 --session <modulo>_<contexto?> --headed`.