First Commit

rules/00_POLITICA_MEMORIAS_CORE.md

@@ -0,0 +1,222 @@
+# 🧠 Política de Memórias Core
+
+Este documento define a política de uso das memórias core da IA coder no projeto SysCMS.
+
+---
+
+## 📋 Objetivo
+
+As memórias core são **atalhos rápidos** para informações que a IA precisa acessar frequentemente, sem precisar realizar buscas demoras na codebase. Elas **NÃO DEVEM** substituir a documentação formal.
+
+---
+
+## ⚠️ Regra Fundamental
+
+### Fonte da Verdade
+
+**OS ARQUIVOS DE REGRAS SÃO A FONTE DA VERDADE.**
+
+Em caso de conflito entre uma memória core e um arquivo de regras:
+- ❌ **Nunca** confie na memória core
+- ✅ **Sempre** consulte o arquivo de regras correspondente
+
+### Prioridade de Consulta
+
+1. **Primeiro**: Consulte RULES.md, CONTEXT.md, DECISIONS.md
+2. **Segundo**: Consulte arquivos específicos em /rules/
+3. **Terceiro**: Use memórias core como atalhos para informações estáticas
+
+---
+
+## 📊 O que Pode Estar nas Memórias Core
+
+### ✅ Permitido (Informações Estáticas)
+
+| Tipo | Exemplo | Justificativa |
+|------|---------|---------------|
+| **Credenciais** | Banco de dados (user=root, pass=root) | Informação que não muda com frequência e usada em muitas operações |
+| **URLs de API** | Endpoints de API REST | Atalho rápido para chamadas de API frequentes |
+| **Comandos CLI** | `php syscli migrate` | Padrões de comandos usados frequentemente |
+| **Paths Fixos** | `storage/uploads/{modulo}` | Caminhos que não mudam no projeto |
+| **Configs Estáticas** | Timeout de sessão, limites de upload | Configurações que são constantes |
+
+### ❌ Proibido (Informações Dinâmicas ou de Regras)
+
+| Tipo | Exemplo | Motivo |
+|------|---------|--------|
+| **Regras de desenvolvimento** | "Use DataTables para tabelas" | Duplicação de RULES.md |
+| **Padrões de código** | "Classes em PascalCase" | Duplicação de 05_PADROES_CODIGO.md |
+| **Estrutura de módulos** | "module.json deve ter X campos" | Duplicação de 03_MODULOS.md |
+| **Frontend patterns** | "Usar Bootstrap Icons" | Duplicação de 04_TECNOLOGIAS.md |
+| **Compatibilidade ERP Legado** | "Precedência do legado" | Duplicação de CONTEXT.md |
+| **Padrões de uploads** | "Usar storage/uploads" | Duplicação de 51_UPLOADS_STORAGE.md |
+| **Padrões de layouts** | "Usar layouts/dashboard.twig" | Duplicação de 50_LAYOUTS_CORRETOS.md |
+| **Padrões de UX** | "Evitar confirm() nativo" | Duplicação de RULES.md |
+
+---
+
+## 🔍 Quando Criar uma Nova Memória Core
+
+### Critérios de Aceitação
+
+Crie uma nova memória core **APENAS** se atender a **TODOS** estes critérios:
+
+1. ✅ A informação é **estática** (não muda com frequência)
+2. ✅ A informação é **usada frequentemente** (3+ vezes em tarefas diferentes)
+3. ✅ A informação **não está documentada formalmente** em /rules/
+4. ✅ A informação **economiza tempo significativo** (evita 3+ tool calls)
+
+### Exemplos de Memórias Apropriadas
+
+**Credenciais de Banco de Dados:**
+```
+Banco de Dados (dev): user=root, pass=root, db=syscms, host=dockersyscms.
+Execução direta via `docker exec dockersyscms mysql -u root -proot -D syscms -e 'QUERY'`
+```
+✅ Aceito: Informação estática, usada frequentemente, não está em /rules/
+
+**URLs de API de GlobalLists:**
+```
+API Routes: `/api/globallists/states/{countryId}` e `/api/globallists/cities/{stateId}`.
+Response JSON: `[{ "id": 1, "name": "..." }]`.
+```
+✅ Aceito: Informação estática, usada frequentemente, economiza tool calls
+
+---
+
+## 🚫 Quando NÃO Criar Memórias Core
+
+### Exemplos de Memórias Inapropriadas
+
+**Regras de DataTables:**
+```
+DataTables Obrigatório: Todas as tabelas de listagem DEVEM usar DataTables.
+```
+❌ Rejeitado: Duplicação de RULES.md - usar arquivos de regras
+
+**Padrão de Uploads:**
+```
+Uploads no SysCMS: Arquivos em 'storage/uploads'. BD armazena caminho relativo.
+```
+❌ Rejeitado: Duplicação de 51_UPLOADS_STORAGE.md - usar arquivos de regras
+
+**Layouts Twig:**
+```
+Layouts Twig: O layout principal é `layouts/dashboard.twig`. NUNCA usar `layout.twig`.
+```
+❌ Rejeitado: Duplicação de 50_LAYOUTS_CORRETOS.md - usar arquivos de regras
+
+---
+
+## 🧹 Manutenção de Memórias Core
+
+### Limpeza Automática
+
+Remova imediatamente memórias core que:
+1. ❌ Duplicam informações dos arquivos de regras
+2. ❌ Se tornaram obsoletas
+3. ❌ Não são mais usadas (não acessadas em 10+ tarefas)
+4. ❌ Contêm informações dinâmicas que mudam com frequência
+
+### Validação Periódica
+
+A cada 20 tarefas, a IA deve:
+1. Listar todas as memórias core
+2. Verificar se ainda há redundância com /rules/
+3. Remover memórias desnecessárias
+4. Documentar quais memórias foram removidas no contexto
+
+---
+
+## 📚 Documentação Formal vs Memórias Core
+
+### Quando Usar Cada Fonte
+
+| Situação | Fonte | Motivo |
+|----------|-------|--------|
+| Preciso de uma regra de desenvolvimento | RULES.md, /rules/ | Fonte da verdade, detalhada |
+| Preciso entender a arquitetura | CONTEXT.md, 02_ARQUITETURA.md | Documentação oficial |
+| Preciso de um padrão de código | 05_PADROES_CODIGO.md | Documentação oficial |
+| Preciso de credenciais do BD | Memória Core | Atalho rápido para informação estática |
+| Preciso de URLs de API | Memória Core | Atalho rápido para endpoints estáticos |
+| Preciso entender módulos | 03_MODULOS.md | Documentação oficial |
+| Preciso implementar um padrão específico | Arquivo específico em /rules/ | Documentação detalhada |
+
+---
+
+## 🎯 Checklist para IA Coder
+
+### Antes de Consultar Memória Core
+
+- [ ] A informação é estática?
+- [ ] A informação não está em RULES.md?
+- [ ] A informação não está em /rules/?
+- [ ] A informação é usada frequentemente?
+
+### Após Criar Memória Core
+
+- [ ] Verifiquei que não duplica /rules/?
+- [ ] A informação é realmente estática?
+- [ ] A informação será usada frequentemente?
+
+### Antes de Seguir Memória Core
+
+- [ ] Verifiquei se há conflito com RULES.md?
+- [ ] Verifiquei se há conflito com /rules/?
+- [ ] Consultei a documentação oficial?
+
+---
+
+## 📖 Exemplos Práticos
+
+### Caso 1: Implementar Tabela de Listagem
+
+**❌ INCORRETO:**
+```
+Memória: "Use DataTables para tabelas de listagem"
+→ Seguir memória sem consultar RULES.md
+```
+
+**✅ CORRETO:**
+```
+Consultar RULES.md → Encontrar seção sobre DataTables
+→ Implementar seguindo documentação oficial
+```
+
+### Caso 2: Conectar ao Banco de Dados
+
+**✅ CORRETO:**
+```
+Memória: "Banco de Dados (dev): user=root, pass=root"
+→ Usar credenciais da memória (informação estática)
+```
+
+### Caso 3: Implementar Upload de Arquivo
+
+**❌ INCORRETO:**
+```
+Memória: "Usar storage/uploads para uploads"
+→ Seguir memória sem consultar 51_UPLOADS_STORAGE.md
+```
+
+**✅ CORRETO:**
+```
+Consultar 51_UPLOADS_STORAGE.md → Implementar seguindo documentação oficial
+→ Usar memória apenas para paths específicos se existirem
+```
+
+---
+
+## 📌 Resumo
+
+1. **Arquivos de regras são a fonte da verdade**
+2. **Memórias core são apenas atalhos rápidos**
+3. **Nunca duplicar informações de /rules/ nas memórias**
+4. **Em conflito: arquivos de regras sempre prevalecem**
+5. **Memórias devem ser usadas para informações estáticas frequentes**
+6. **Limpar memórias obsoletas ou redundantes regularmente**
+
+---
+
+**Última Atualização**: 2025-01-19
+**Versão**: 1.0.0