wegho-agentes 4.0.1

package/.agents/AI_COMPATIBILITY.md

@@ -0,0 +1,332 @@
+# Guia de Compatibilidade com IAs - Sistema de Agentes
+
+## 🎯 Objetivo
+
+Este documento garante que **TODAS as IAs** (Gemini, Claude, GPT) entendam e trabalhem corretamente com o sistema de agentes.
+
+---
+
+## 🤖 IAs Suportadas
+
+Este sistema é **100% compatível** com:
+
+1. ✅ **Google Gemini** (Gemini 1.5 Pro, Gemini 2.0, etc)
+2. ✅ **Anthropic Claude** (Claude 3.5 Sonnet, Claude 3 Opus, etc)
+3. ✅ **OpenAI GPT** (GPT-4, GPT-4 Turbo, GPT-3.5, etc)
+
+---
+
+## 📋 Instruções para TODAS as IAs
+
+### Quando Trabalhar com Este Sistema
+
+**SEMPRE siga estas regras:**
+
+1. **Identifique-se como agente ativo**
+   ```
+   ============================================================
+   🤖 AGENTE ATIVO: FRONTEND-AGENT
+   ============================================================
+   📋 Tarefa: Validar componente de login
+   ⏰ Início: 23:27:00
+   ```
+
+2. **Consulte memória ANTES de executar**
+   - Buscar casos similares
+   - Obter recomendações
+   - Consultar repositórios de referência
+
+3. **Mostre progresso durante execução**
+   ```
+   ⚙️  [frontend-agent] Executando tarefa...
+   ```
+
+4. **Indique conclusão claramente**
+   ```
+   ✅ SUCESSO [frontend-agent] Tarefa concluída
+   ⏰ Término: 23:27:45
+   ============================================================
+   ```
+
+5. **Registre resultado na memória**
+   - Salvar em `successes.json` ou `failures.json`
+   - Incluir contexto completo
+
+---
+
+## 🔄 Fluxo Obrigatório para Todas as IAs
+
+### 1. Inicialização
+
+```typescript
+// Gemini, Claude ou GPT executando:
+const agent = new FrontEndAgent('.agents/memory');
+// Cria estrutura de memória automaticamente
+```
+
+### 2. Antes de Executar
+
+```typescript
+// TODAS as IAs DEVEM:
+console.log(`\n${'='.repeat(60)}`);
+console.log(`🤖 AGENTE ATIVO: ${agentName.toUpperCase()}`);
+console.log(`${'='.repeat(60)}`);
+console.log(`📋 Tarefa: ${taskDescription}`);
+console.log(`⏰ Início: ${new Date().toLocaleTimeString('pt-BR')}\n`);
+
+// Consultar memória
+const similarCases = this.memory.getSimilarCases(...);
+const recommendations = this.memory.getRecommendations(...);
+```
+
+### 3. Durante Execução
+
+```typescript
+// Mostrar progresso
+console.log(`\n⚙️  [${agentName}] Executando tarefa...\n`);
+
+// Executar validações
+const result = await this.executeTask(...);
+```
+
+### 4. Após Execução
+
+```typescript
+// Mostrar resultado
+const status = result.success ? '✅ SUCESSO' : '❌ FALHA';
+console.log(`\n${status} [${agentName}] Tarefa concluída`);
+console.log(`⏰ Término: ${new Date().toLocaleTimeString('pt-BR')}`);
+console.log(`${'='.repeat(60)}\n`);
+
+// Registrar na memória
+this.recordOutcome(...);
+```
+
+---
+
+## 📝 Formato de Mensagens
+
+### Para Gemini
+
+```
+Você é o [NOME-DO-AGENTE]. 
+
+Sua tarefa: [DESCRIÇÃO]
+
+SEMPRE:
+1. Anuncie que você é o agente ativo
+2. Consulte memória antes de executar
+3. Mostre progresso durante execução
+4. Registre resultado na memória
+```
+
+### Para Claude
+
+```
+You are the [AGENT-NAME].
+
+Your task: [DESCRIPTION]
+
+ALWAYS:
+1. Announce yourself as the active agent
+2. Consult memory before executing
+3. Show progress during execution
+4. Record result in memory
+```
+
+### Para GPT
+
+```
+You are the [AGENT-NAME].
+
+Task: [DESCRIPTION]
+
+Required steps:
+1. Announce yourself as active agent
+2. Check memory for similar cases
+3. Execute with progress updates
+4. Save result to memory
+```
+
+---
+
+## 🎨 Padrão Visual Obrigatório
+
+Todas as IAs DEVEM usar este formato:
+
+```
+============================================================
+🤖 AGENTE ATIVO: [NOME-DO-AGENTE]
+============================================================
+📋 Tarefa: [descrição da tarefa]
+⏰ Início: [HH:MM:SS]
+
+💭 [agente] Encontrei X caso(s) similar(es):
+  1. ✅ [descrição]
+  2. ❌ [descrição]
+
+💡 [agente] Recomendações baseadas em aprendizados:
+  1. [recomendação]
+  2. [recomendação]
+
+⚙️  [agente] Executando tarefa...
+
+[... output da execução ...]
+
+✅ SUCESSO [agente] Tarefa concluída
+⏰ Término: [HH:MM:SS]
+============================================================
+```
+
+---
+
+## 🔍 Identificação de Agentes
+
+Cada IA deve saber qual agente está executando:
+
+| Agente | Identificador | Emoji |
+|--------|---------------|-------|
+| Frontend | `frontend-agent` | 🎨 |
+| Security | `security-agent` | 🔒 |
+| Architecture | `architecture-agent` | 🏗️ |
+| Quality | `quality-agent` | ✅ |
+| Documentation | `documentation-agent` | 📚 |
+| Pentesting | `pentesting-agent` | 🐍 |
+| CMS | `cms-agent` | 📰 |
+| SEO | `seo-agent` | 🔍 |
+| Production Control | `production-control-agent` | 🏭 |
+| Route | `route-agent` | 🚚 |
+| Orchestrator | `orchestrator` | 🎯 |
+
+---
+
+## 📂 Estrutura de Memória (Todas as IAs)
+
+Todas as IAs trabalham com a mesma estrutura:
+
+```
+.agents/memory/
+├── [agente-name]/
+│   ├── specialty.md          # Leia para entender especialidade
+│   ├── successes.json        # Consulte antes de executar
+│   ├── failures.json         # Aprenda com erros passados
+│   └── learnings.json        # Aplique recomendações
+└── reference-repositories.json  # 27 recursos públicos
+```
+
+---
+
+## 🌐 Repositórios de Referência
+
+Todas as IAs DEVEM consultar quando relevante:
+
+```typescript
+// Carregar repositórios
+const repos = JSON.parse(
+    fs.readFileSync('.agents/memory/reference-repositories.json', 'utf-8')
+);
+
+// Gemini consultando React
+const reactDocs = repos.repositories.react.docs;
+
+// Claude consultando OWASP
+const owaspTop10 = repos.security_resources.owasp_top_10.url;
+
+// GPT consultando TypeScript
+const tsDocs = repos.repositories.typescript.docs;
+```
+
+---
+
+## ✅ Checklist para Todas as IAs
+
+Antes de executar qualquer tarefa:
+
+- [ ] Anunciar qual agente está ativo
+- [ ] Mostrar timestamp de início
+- [ ] Consultar memória (successes, failures, learnings)
+- [ ] Consultar repositórios de referência
+- [ ] Mostrar casos similares encontrados
+- [ ] Mostrar recomendações baseadas em aprendizados
+
+Durante execução:
+
+- [ ] Mostrar progresso (`⚙️  [agente] Executando...`)
+- [ ] Aplicar aprendizados com alta confiança (>0.7)
+
+Após execução:
+
+- [ ] Mostrar status (✅ SUCESSO ou ❌ FALHA)
+- [ ] Mostrar timestamp de término
+- [ ] Registrar resultado na memória
+- [ ] Incluir contexto completo (files, areas, complexity)
+
+---
+
+## 🎯 Exemplo Completo (Qualquer IA)
+
+```typescript
+// Gemini, Claude ou GPT executando:
+
+console.log(`\n${'='.repeat(60)}`);
+console.log(`🤖 AGENTE ATIVO: FRONTEND-AGENT`);
+console.log(`${'='.repeat(60)}`);
+console.log(`📋 Tarefa: Validar componente de login`);
+console.log(`⏰ Início: 23:27:00\n`);
+
+// Consultar memória
+const similar = memory.getSimilarCases('frontend-agent', 'login', 5);
+console.log(`💭 [frontend-agent] Encontrei ${similar.length} caso(s) similar(es):`);
+
+// Executar
+console.log(`\n⚙️  [frontend-agent] Executando tarefa...\n`);
+const result = await agent.executeTask(...);
+
+// Concluir
+console.log(`\n✅ SUCESSO [frontend-agent] Tarefa concluída`);
+console.log(`⏰ Término: 23:27:45`);
+console.log(`${'='.repeat(60)}\n`);
+
+// Registrar
+memory.recordSuccess(...);
+```
+
+---
+
+## 🚨 Regras Críticas
+
+**TODAS as IAs DEVEM:**
+
+1. ✅ Sempre identificar qual agente está trabalhando
+2. ✅ Sempre consultar memória antes de executar
+3. ✅ Sempre mostrar progresso durante execução
+4. ✅ Sempre registrar resultado na memória
+5. ✅ Sempre usar formato visual padronizado
+
+**NUNCA:**
+
+❌ Executar sem anunciar qual agente está ativo  
+❌ Ignorar memória de casos similares  
+❌ Executar sem mostrar progresso  
+❌ Esquecer de registrar resultado  
+❌ Usar formato diferente do padrão  
+
+---
+
+## 📊 Compatibilidade Testada
+
+| IA | Versão | Status | Notas |
+|----|--------|--------|-------|
+| Gemini | 1.5 Pro | ✅ | Totalmente compatível |
+| Gemini | 2.0 | ✅ | Totalmente compatível |
+| Claude | 3.5 Sonnet | ✅ | Totalmente compatível |
+| Claude | 3 Opus | ✅ | Totalmente compatível |
+| GPT | 4 Turbo | ✅ | Totalmente compatível |
+| GPT | 4 | ✅ | Totalmente compatível |
+| GPT | 3.5 | ✅ | Totalmente compatível |
+
+---
+
+**Versão**: 1.0  
+**Última Atualização**: 2026-01-22  
+**Compatível com**: Gemini, Claude, GPT

package/.agents/CLI.md

@@ -0,0 +1,222 @@
+# 🤖 CLI - Comandos do Sistema de Agentes
+
+Interface de linha de comando para facilitar o uso dos agentes.
+
+---
+
+## 📋 Comandos Disponíveis
+
+### 1. !comandos
+**Mostra lista de todos os comandos**
+
+```bash
+node .agents/cli.js "!comandos"
+```
+
+---
+
+### 2. !iniciar contexto
+**Carrega contexto completo do projeto**
+
+- Detecta se projeto é novo ou existente
+- Se existente: executa auditoria automática de código
+- Faz perguntas sobre domínio, stack, features
+- Salva perfil em `docs/PROJECT_PROFILE.json`
+
+```bash
+node .agents/cli.js "!iniciar contexto"
+```
+
+**Equivalente a**:
+```bash
+node .agents/test-init-context.js
+```
+
+---
+
+### 3. !rever codigo
+**Executa auditoria completa do código**
+
+- Escaneia todos arquivos `.ts`, `.tsx`, `.js`, `.jsx`
+- Detecta 9 tipos de violações (P0/P1/P2)
+- Gera relatório em `docs/AUDIT_REPORT.md`
+
+```bash
+node .agents/cli.js "!rever codigo"
+```
+
+**Saída**:
+```
+📊 RELATÓRIO DE AUDITORIA
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📁 Arquivos analisados: 47
+⚠️  Total de violações: 23
+
+💀 P0 (CRÍTICO): 3
+⚠️  P1 (IMPORTANTE): 12
+💡 P2 (MELHORIA): 8
+
+✅ Relatório salvo em: docs/AUDIT_REPORT.md
+```
+
+---
+
+### 4. !rever plano
+**Revisa plano de implementação**
+
+- Mostra `docs/IMPLEMENTATION_PLAN.md`
+- Exibe perfil do projeto (`PROJECT_PROFILE.json`)
+- Lista próximos passos
+
+```bash
+node .agents/cli.js "!rever plano"
+```
+
+---
+
+### 5. !voltar versao
+**Reverte para versão anterior (Git)**
+
+- Lista últimos 10 commits
+- Mostra comandos para reverter
+- Opções: `git revert` (seguro) ou `git reset` (perigoso)
+
+```bash
+node .agents/cli.js "!voltar versao"
+```
+
+**Saída**:
+```
+📜 Últimos commits:
+
+abc1234 feat: adicionar login
+def5678 fix: corrigir validação
+...
+
+⚠️  Para reverter, execute manualmente:
+
+   git revert <commit-hash>   # Criar commit de reversão
+   ou
+   git reset --hard <commit-hash>   # Voltar diretamente (CUIDADO!)
+```
+
+---
+
+### 6. !criar backup
+**Cria backup completo do estado atual**
+
+- Salva em `.backups/backup-YYYYMMDD-HHmmss/`
+- Inclui: código, docs, configs
+- Exclui: node_modules, .next, dist
+- Cria `backup-info.json` com metadados
+
+```bash
+node .agents/cli.js "!criar backup"
+```
+
+**Saída**:
+```
+💾 Criando backup em: .backups/backup-2026-01-20T10-40-00
+
+  ✅ app/
+  ✅ components/
+  ✅ hooks/
+  ✅ docs/
+  ✅ .agents/
+  ✅ package.json
+
+✅ Backup criado com sucesso!
+📂 Localização: .backups/backup-2026-01-20T10-40-00
+📊 6 itens salvos
+
+💡 Para restaurar:
+   cp -r .backups/backup-2026-01-20T10-40-00/* .
+```
+
+---
+
+## 🚀 Uso Rápido via NPM
+
+Adicione ao `package.json`:
+
+```json
+{
+  "scripts": {
+    "agent": "node .agents/cli.js"
+  }
+}
+```
+
+Depois use:
+
+```bash
+npm run agent "!comandos"
+npm run agent "!iniciar contexto"
+npm run agent "!rever codigo"
+npm run agent "!rever plano"
+npm run agent "!voltar versao"
+npm run agent "!criar backup"
+```
+
+---
+
+## 💡 Exemplos de Uso
+
+### Workflow Completo
+
+```bash
+# 1. Iniciar contexto (primeira vez)
+npm run agent "!iniciar contexto"
+
+# 2. Antes de começar implementação
+npm run agent "!criar backup"
+
+# 3. Após implementar código
+npm run agent "!rever codigo"
+
+# 4. Se houver problemas, voltar
+npm run agent "!voltar versao"
+
+# 5. Revisar plano antes de deploy
+npm run agent "!rever plano"
+```
+
+### Auditoria Rápida
+
+```bash
+# Auditar código atual
+npm run agent "!rever codigo"
+
+# Se P0 > 0: corrigir e auditar novamente
+# ... (fazer correções)
+npm run agent "!rever codigo"
+```
+
+### Backup Antes de Deploy
+
+```bash
+# Criar backup
+npm run agent "!criar backup"
+
+# Deploy
+npm run build
+# ... (deploy)
+
+# Se algo der errado, restaurar:
+cp -r .backups/backup-2026-01-20T10-40-00/* .
+```
+
+---
+
+## 📌 Notas
+
+- **Todos os comandos** podem ser executados diretamente: `node .agents/cli.js "!comando"`
+- **Scripts NPM** são apenas atalhos convenientes
+- **Backups** não incluem `node_modules`, `.next`, `dist` (reduz tamanho)
+- **Git necessário** para `!voltar versao`
+
+---
+
+**Versão**: 1.0.0  
+**Última atualização**: 2026-01-20

package/.agents/README.md

@@ -0,0 +1,130 @@
+# Sistema de Agentes - README
+
+## 🎯 Visão Geral
+
+Sistema de agentes especializados para garantir qualidade, segurança e organização em projetos Next.js + Supabase.
+
+## 📁 Estrutura
+
+```
+.agents/
+├── core/                        # 5 Agentes Core
+│   ├── frontend-agent.ts        # UI/UX, acessibilidade, performance
+│   ├── security-agent.ts        # Vulnerabilidades, RLS, validações
+│   ├── documentation-agent.ts   # Docs automáticas
+│   ├── architecture-agent.ts    # Organização, separação de camadas
+│   └── quality-agent.ts         # Lint, build, tests, audit (GO/NO-GO)
+├── domains/                     # Agentes Especializados
+│   ├── news/                    # Site de Notícias
+│   ├── production/              # Produção/Expedição
+│   └── logistics/               # Logística
+├── config.ts                    # Configurações globais
+├── context-loader.ts            # Sistema "iniciar contexto"
+├── orchestrator.ts              # Coordenador dos 6 passos
+└── test-init-context.js         # Script de teste
+```
+
+## 🚀 Como Usar
+
+### 1. Iniciar Contexto
+
+Antes de qualquer implementação, execute:
+
+```bash
+node .agents/test-init-context.js
+```
+
+Ou adicione ao `package.json`:
+
+```json
+{
+  "scripts": {
+    "agents:init": "node .agents/test-init-context.js"
+  }
+}
+```
+
+Isso carregará:
+- ✅ DESIGN_SYSTEM.md  
+- ✅ SYMBOLS_TREE.md  
+- ✅ BUILD_HISTORY.md  
+- ✅ AGENT_RULES.md  
+- ✅ Build atual  
+- ✅ Regras do usuário (MEMORY)  
+- ✅ Domínio do projeto
+
+### 2. Processo de 6 Passos
+
+Todo código passa por:
+
+1. **Arquitetura** - Estrutura e organização
+2. **Front-End** - UI/UX, acessibilidade, performance
+3. **Segurança FE** - XSS, CSRF, validações
+4. **Tech Lead** - Integração e limpeza
+5. **Database Security** - RLS, policies, índices
+6. **Auditor Final** - GO/NO-GO (lint, build, tests)
+
+### 3. Salvamento Automático
+
+Ao finalizar build, o **Documentation Agent** atualiza:
+- `docs/builds/build-XXX.md` (detalhes)
+- `docs/BUILD_HISTORY.md` (resumo)
+- `docs/SYMBOLS_TREE.md` (símbolos)
+
+## 📋 Regras Absolutas
+
+1. ❌ **Máximo 500 linhas** por arquivo
+2. ❌ **Não alucinar** (APIs, tabelas, libs)
+3. ✅ **Priorizar libs existentes**
+4. ✅ **Fonte de verdade**: Código → Docs → Padrões
+5. ✅ **Mudanças mínimas**
+6. ❌ **Sem gambiarra**
+7. ✅ **Entregas obrigatórias** (arquivos + por quê + como validar)
+8. ✅ **Tipagem forte** (evitar `any`)
+
+## 📊 Domínios Suportados
+
+- **Generic** - Projeto padrão (apenas agentes core)
+- **News** - Site de Notícias (CMS, SEO, Content, Analytics)
+- **Production** - Produção/Expedição (Control, Quality, Shipping, Inventory)
+- **Logistics** - Logística (Route, Fleet, Warehouse, Tracking)
+
+## 🔧 Configuração
+
+Edite `.agents/config.ts` para personalizar:
+
+```typescript
+export const DEFAULT_CONFIG: AgentConfig = {
+  domain: 'production', // ou 'news', 'logistics', 'generic'
+  enabledAgents: ['frontend', 'security', 'documentation', 'architecture', 'quality'],
+  autoDocumentation: true,
+  buildTracking: true,
+  maxFileLines: 500,
+};
+```
+
+## 📚 Documentação Completa
+
+- [DESIGN_SYSTEM.md](../docs/DESIGN_SYSTEM.md) - Sistema de design
+- [SYMBOLS_TREE.md](../docs/SYMBOLS_TREE.md) - Árvore de símbolos
+- [BUILD_HISTORY.md](../docs/BUILD_HISTORY.md) - Histórico de builds
+- [AGENT_RULES.md](../docs/AGENT_RULES.md) - Regras completas
+
+## 🧪 Testar Sistema
+
+```bash
+# Teste 1: Iniciar contexto
+npm run agents:init
+
+# Teste 2: Validar arquivo
+node .agents/test-validate-file.js path/to/file.tsx
+
+# Teste 3: Full audit
+npm run lint && npm run build && npm test
+```
+
+---
+
+**Versão**: 1.0.0  
+**Última atualização**: 2026-01-20  
+**Gerado por**: Documentation Agent