melhorias no agent

DOCUMENTACAO/templates/historico-acoes.md.template

@@ -0,0 +1,21 @@
+# Histórico de Ações e Memórias da IA — <modulo-id>
+
+Índice central de registros de sessões e memórias de ações executadas pela Inteligência Artificial no módulo `<modulo-id>`. Cada sessão possui seu arquivo dedicado no padrão `sessao-AAAA-MM-DD-slug.md` com as respectivas citações no código-fonte, regras de negócio e validações técnicas.
+
+---
+
+## Registros de Sessões / Memórias Individuais
+
+| Data | Memória / Ação | Arquivo Memoria | Citações no Código-Fonte |
+| :--- | :--- | :--- | :--- |
+| **AAAA-MM-DD** | Breve descrição da ação / funcionalidade | [`sessao-AAAA-MM-DD-slug.md`](./sessao-AAAA-MM-DD-slug.md) | `caminho/arquivo1.ts`<br>`caminho/arquivo2.vue` |
+
+---
+
+## Resumo das Memórias
+
+### 1. [AAAA-MM-DD] Título da Ação / Memória
+- **Arquivo Completo:** [`sessao-AAAA-MM-DD-slug.md`](./sessao-AAAA-MM-DD-slug.md)
+- **Problema / Contexto:** Descrição objetiva da demanda ou diagnóstico.
+- **Solução Técnica:** O que foi projetado e implementado na sessão.
+- **Citações no Código:** `caminho/arquivo1.ts`, `caminho/arquivo2.vue`.

DOCUMENTACAO/templates/sessao-memoria.md.template

@@ -0,0 +1,56 @@
+---
+type: memory
+name: sessao-AAAA-MM-DD-slug
+description: Registro de sessão de IA cobrindo diagnóstico, ações, regras e citações no código
+session_date: "AAAA-MM-DD"
+updatedAt: "AAAA-MM-DD"
+tags: [modulo-id, contexto, acao]
+---
+
+# Registro de Sessão: [Título da Sessão / Ação]
+
+- **Data:** AAAA-MM-DD
+- **Módulo:** `<modulo-id>`
+- **Arquivo de Índice:** [`historico-acoes.md`](./historico-acoes.md)
+
+---
+
+## 1. Contexto e Diagnóstico
+
+- **Problema / Demanda:** [Descrição clara da necessidade operacional ou erro relatado]
+- **Causa Raiz:** [Identificação da causa do problema, se aplicável]
+- **Impacto no Sistema:** [Módulos, serviços ou fluxos impactados]
+
+---
+
+## 2. Solução Implementada
+
+- [Descrição detalhada da arquitetura e decisões de código]
+- [Regras de negócio observadas e documentadas]
+
+---
+
+## 3. Citações no Código-Fonte
+
+| Arquivo | Linhas / Trecho | Responsabilidade / Modificação |
+| :--- | :--- | :--- |
+| `caminho/arquivo1.ts` | Linhas ~X-Y | Descrição da alteração |
+| `caminho/arquivo2.vue` | Linhas ~W-Z | Descrição da alteração |
+
+---
+
+## 4. Documentação Sincronizada (DDD)
+
+- **Pilar 1 (Código):** JSDoc inserido em `caminho/arquivo1.ts`
+- **Pilar 2 (Ajuda UI):** `modalX.ajuda.md` (quando aplicável)
+- **Pilar 3 (Wiki Usuário):** `<base_projeto>/../wiki/<modulo-id>/...`
+- **Pilar 4 (Wiki Dev):** `<base_projeto>/../wiki/dev/<modulo-id>/...`
+- **Pilar 5 (Rota IA):** `/llm.md`
+- **Pilar 6 (Memória IA):** Registrado neste arquivo e indexado em `historico-acoes.md`
+
+---
+
+## 5. Validação e Testes
+
+- [Testes de tipagem, compilação ou execução realizados]
+- [Garantia de limite de 250 linhas (`verificar-linhas.sh`)]