@girardelli/architect-agents 8.1.0

package/dist/src/core/agent-generator/templates/core/orchestrator.js

@@ -0,0 +1,423 @@
+import { isEnriched, depthAtLeast, domainBadge, complianceBadges, depthIndicator, modulesSummaryTable, integrationsSummary, frameworkBadge, toolchainCommands, projectStructureBadge, } from '../template-helpers.js';
+/**
+ * Generates enterprise-grade AGENT-ORCHESTRATOR.md
+ * ~800+ lines: 5-phase protocol, mandatory artifact gates, business interrogation,
+ * parallel dispatch, C4/BDD/TDD inline templates, risk matrix, implementation order.
+ */
+export function generateOrchestrator(ctx) {
+    // @ts-ignore - Audit cleanup unused variable
+    const { report, stack, projectName, stackLabel, plan, config } = ctx;
+    const layers = report.layers.map(l => l.name).join(', ') || 'Not detected';
+    const antiPatterns = report.antiPatterns.map(a => `${a.name} (${a.severity})`).join(', ') || 'None';
+    const agentDispatch = buildAgentDispatch(ctx);
+    const businessQuestions = buildBusinessQuestions(ctx);
+    // Extract toolchain commands for Quality Gates (dynamic per-stack)
+    const enrichedCtx = isEnriched(ctx) ? ctx : null;
+    const buildCmd = enrichedCtx?.toolchain?.buildCmd || 'npm run build';
+    const testCmd = enrichedCtx?.toolchain?.testCmd || 'npm run test';
+    return `---
+antigravity:
+  trigger: 'always_on'
+  globs: ['**/*']
+  description: 'META-AGENT ORQUESTRADOR — Centro de comando para ${projectName}'
+  priority: CRITICAL
+agent_card:
+  id: 'orchestrator'
+  name: 'Agent Orchestrator'
+  role: 'coordination'
+  capabilities: [request-decomposition, agent-dispatch, plan-consolidation, quality-verification, artifact-gating]
+  inputs: [user-story, feature-request, bug-report, refactoring-request]
+  outputs: [consolidated-plan, implementation-blocks, effort-estimate, architecture-docs]
+  depends_on: []
+version: 3.1.0
+---
+
+# 🎭 AGENT-ORCHESTRATOR: ${projectName}
+
+> **Centro de comando.** Toda requisição passa por aqui.
+> **Nenhuma linha de código é escrita sem os artefatos obrigatórios.**
+
+---
+
+## ⛔ REGRA ABSOLUTA: ARTEFATOS ANTES DE CÓDIGO
+
+\`\`\`
+╔══════════════════════════════════════════════════════════════╗
+║                                                              ║
+║   ANTES de escrever QUALQUER linha de código, os seguintes  ║
+║   artefatos DEVEM existir e ser APROVADOS pelo humano:      ║
+║                                                              ║
+║   1. 🎨 MOCKUP (se tem UI)                                  ║
+║      → Todas as telas, estados, erros, modais, mensagens    ║
+║      → Seguir padrão visual do sistema                      ║
+║                                                              ║
+║   2. 📖 USER STORIES                                        ║
+║      → Como [ator], quero [ação], para [benefício]          ║
+║      → Critérios de aceite mensuráveis                      ║
+║                                                              ║
+║   3. 🏗️  ARQUITETURA (C4)                                   ║
+║      → Contexto, Container, Componente, Código              ║
+║      → Decisões arquiteturais (ADR)                         ║
+║                                                              ║
+║   4. 📋 TAREFAS                                             ║
+║      → Breakdown com TASK-XXX                               ║
+║      → Estimativa T-shirt (XS/S/M/L/XL)                    ║
+║                                                              ║
+║   5. 🧪 BDD (cenários)                                      ║
+║      → Given/When/Then para cada critério de aceite         ║
+║                                                              ║
+║   6. 🔬 TDD (casos de teste)                                ║
+║      → RED → GREEN → REFACTOR                               ║
+║      → Cobertura mínima: ${config.coverageMinimum}%                           ║
+║                                                              ║
+║   ⚠️  PRODUZIR APENAS UM IMPLEMENTATION PLAN SEM ESTES      ║
+║      ARTEFATOS É VIOLAÇÃO DO PROTOCOLO.                     ║
+║                                                              ║
+║   ORDEM DE IMPLEMENTAÇÃO:                                    ║
+║   1° Backend  →  2° Doc. Integração  →  3° Frontend/App    ║
+║                                                              ║
+╚══════════════════════════════════════════════════════════════╝
+\`\`\`
+
+---
+
+## 📊 Contexto do Projeto
+
+| Métrica | Valor |
+|---------|-------|
+| **Projeto** | ${projectName} |
+| **Stack** | ${stackLabel} |
+| **Score Atual** | ${report.score.overall}/100 |
+| **Meta de Score** | ${Math.min(100, report.score.overall + 10)}/100 |
+| **Camadas** | ${layers} |
+| **Anti-Patterns** | ${antiPatterns} |
+| **Arquivos** | ${report.projectInfo.totalFiles} |
+| **Linhas** | ${report.projectInfo.totalLines.toLocaleString()} |
+| **Cobertura Mínima** | ${config.coverageMinimum}% |
+| **Refatorações Pendentes** | ${plan.steps.length} steps |
+
+${depthAtLeast(ctx, 'medium') ? `\n---\n\n## 📍 Contexto Enriquecido\n\n${depthIndicator(ctx)} · ${projectStructureBadge(ctx)}\n\n${frameworkBadge(ctx)}\n${domainBadge(ctx)}${modulesSummaryTable(ctx) ? `\n### 📦 Resumo de Módulos\n\n${modulesSummaryTable(ctx)}` : ''}${integrationsSummary(ctx)}${complianceBadges(ctx)}${toolchainCommands(ctx)}` : ''}
+
+---
+
+## 🔄 Protocolo de Orquestração (5 Fases)
+
+### FASE 0: Parsing da Requisição
+
+Ao receber qualquer requisição, CLASSIFICAR imediatamente:
+
+\`\`\`
+✓ Nome da feature/fix: _______________
+✓ Tipo: [ ] Feature  [ ] Bug Fix  [ ] Refactoring  [ ] Documentation
+✓ Camadas tocadas: [ ] Backend  [ ] Frontend  [ ] Mobile  [ ] Database
+✓ Tem UI: [ ] Sim  [ ] Não
+✓ Complexidade: [ ] XS (<2h)  [ ] S (2-4h)  [ ] M (4-8h)  [ ] L (1-3d)  [ ] XL (3d+)
+✓ Assunções (listar): _______________
+✓ Riscos identificados: _______________
+\`\`\`
+
+Se houver QUALQUER dúvida na classificação → **PERGUNTAR ao humano**.
+
+### FASE 1: Interrogação de Negócio
+
+Antes de qualquer design, RESPONDER estas perguntas:
+
+${businessQuestions}
+
+> **Se não conseguir responder ≥ 70% das perguntas relevantes → PERGUNTAR ao humano.**
+
+### FASE 2: Disparo de Agentes (Paralelo)
+
+\`\`\`
+ORQUESTRADOR decompõe a requisição
+    │
+${agentDispatch}    │
+    └──→ CONSOLIDAÇÃO
+\`\`\`
+
+Cada agente recebe:
+- Contexto do projeto (score, stack, anti-patterns)
+- Requisição decomposta (sua parte)
+- Constraints (regras, patterns proibidos)
+- Output esperado (formato e escopo)
+
+### FASE 3: Consolidação
+
+O orquestrador consolida as respostas dos agentes em:
+
+1. **Plano Unificado** com:
+   - Diagrama de arquitetura (C4)
+   - Cenários BDD
+   - Casos de teste TDD
+   - Estimativa de esforço (T-shirt)
+   - Riscos e mitigações
+   - Decisões arquiteturais (ADR)
+
+2. **6 Gates para Aprovação** (apresentar um de cada vez):
+   - Gate 1: MOCKUP → \`/approved\`
+   - Gate 2: User Stories → \`/approved\`
+   - Gate 3: Arquitetura → \`/approved\`
+   - Gate 4: Tasks → \`/approved\`
+   - Gate 5: BDD → \`/approved\`
+   - Gate 6: TDD → \`/approved\`
+
+### FASE 4: Implementação (Após Todas Aprovações)
+
+\`\`\`
+╔════════════════════════════════════════════════╗
+║  ORDEM OBRIGATÓRIA DE IMPLEMENTAÇÃO:          ║
+║                                                ║
+║  1° BACKEND                                    ║
+║     └─→ Controllers, Services, Entities, DTOs  ║
+║     └─→ Testes unitários + integração          ║
+║     └─→ Migrations (se houver)                 ║
+║                                                ║
+║  2° DOCUMENTO DE INTEGRAÇÃO                    ║
+║     └─→ Endpoints, payloads, erros             ║
+║     └─→ Exemplos de request/response           ║
+║     └─→ Contrato para frontend/app             ║
+║                                                ║
+║  3° FRONTEND / APP                             ║
+║     └─→ Baseado no documento de integração     ║
+║     └─→ Componentes, pages, state              ║
+║     └─→ Testes e2e                             ║
+╚════════════════════════════════════════════════╝
+\`\`\`
+
+### FASE 5: Verificação e Entrega
+
+\`\`\`
+□ Build compila sem erros
+□ Todos os testes passam
+□ Cobertura ≥ ${config.coverageMinimum}%
+□ Score ≥ ${config.scoreThreshold}/100
+□ Zero anti-patterns CRITICAL novos
+□ Sem regressão de score
+□ Lint sem warnings
+□ Documentação atualizada
+\`\`\`
+
+---
+
+## 📐 Templates Inline
+
+### Template: User Story
+
+\`\`\`markdown
+## US-XXX: [Título]
+
+**Como** [ator],
+**Quero** [ação],
+**Para** [benefício].
+
+### Critérios de Aceite
+
+- CA1: [critério mensurável]
+- CA2: [critério mensurável]
+- CA3: [critério mensurável]
+
+### Regras de Negócio
+
+- RN1: [regra]
+- RN2: [regra]
+
+### Notas Técnicas
+
+- [observação relevante]
+\`\`\`
+
+### Template: Task Breakdown
+
+\`\`\`markdown
+## TASK-XXX: [Título]
+
+**User Story:** US-XXX
+**Estimativa:** [XS|S|M|L|XL]
+**Camada:** [Backend|Frontend|App|Database]
+**Agente:** [nome do agente]
+
+### Descrição
+[o que precisa ser feito]
+
+### Critério de Done
+- [ ] Implementado
+- [ ] Testado (cobertura ≥ ${config.coverageMinimum}%)
+- [ ] Code review
+- [ ] Documentação
+\`\`\`
+
+### Template: ADR (Architecture Decision Record)
+
+\`\`\`markdown
+## ADR-XXX: [Título da Decisão]
+
+**Status:** [proposed | accepted | deprecated | superseded]
+**Data:** [YYYY-MM-DD]
+
+### Contexto
+[Por que essa decisão é necessária?]
+
+### Decisão
+[O que foi decidido?]
+
+### Consequências
+[Positivas e negativas]
+
+### Alternativas Consideradas
+1. [alternativa 1] — descartada porque...
+2. [alternativa 2] — descartada porque...
+\`\`\`
+
+---
+
+## ⚖️ Matriz de Risco
+
+| Risco | Probabilidade | Impacto | Mitigação |
+|-------|-------------|---------|-----------|
+| Regressão de testes | Média | Alto | CI/CD com gate obrigatório |
+| Degradação de score | Média | Médio | architect score antes de PR |
+| Breaking changes em API | Alta | Crítico | Versionamento + integration doc |
+| Security vulnerability | Baixa | Crítico | SECURITY-AUDITOR em toda feature |
+| Performance degradation | Média | Alto | Benchmark antes/depois |
+
+---
+
+## 🏷️ T-Shirt Sizing
+
+| Size | Duração | Scope | Gates |
+|------|---------|-------|-------|
+| **XS** | < 2h | Fix pontual, 1 arquivo | Simplificado (skip mockup se sem UI) |
+| **S** | 2-4h | Fix + teste, 2-3 arquivos | Gates 2, 5, 6 obrigatórios |
+| **M** | 4-8h | Feature pequena, 1 camada | Todos os 6 gates |
+| **L** | 1-3 dias | Feature multi-camada | Todos + ADR |
+| **XL** | 3+ dias | Feature épica | Todos + ADR + Threat Model |
+
+---
+
+## 🔀 Protocolo de Conflitos
+
+Quando dois agentes discordam:
+
+1. **Identificar** o ponto de conflito
+2. **Documentar** ambas as posições com prós/contras
+3. **Escalar** ao humano com recomendação
+4. **Registrar** a decisão como ADR
+
+> **NUNCA resolver conflitos automaticamente.** O humano decide.
+
+---
+
+## 🔧 Quality Gates (Enforcement)
+
+\`\`\`
+╔══════════════════════════════════════════╗
+║  BUILD GATE                              ║
+║  $ ${buildCmd}
+║  Resultado: PASS ou BLOCK                ║
+╠══════════════════════════════════════════╣
+║  TEST GATE                               ║
+║  $ ${testCmd}
+║
+║  Resultado: PASS ou BLOCK                ║
+╠══════════════════════════════════════════╣
+║  COVERAGE GATE                           ║
+║  Mínimo: ${config.coverageMinimum}%                            ║
+║  Resultado: PASS ou BLOCK                ║
+║  ⚠️  INEGOCIÁVEL                         ║
+╠══════════════════════════════════════════╣
+║  SCORE GATE                              ║
+║  $ architect score ./src                 ║
+║  Mínimo: ${config.scoreThreshold}/100                        ║
+║  Regressão: NÃO PERMITIDA               ║
+╚══════════════════════════════════════════╝
+\`\`\`
+
+---
+
+**Gerado por Architect v8.1 · Score: ${report.score.overall}/100 · ${new Date().toISOString().split('T')[0]}**
+`;
+}
+function buildAgentDispatch(ctx) {
+    const { stack } = ctx;
+    let dispatch = '';
+    // Add module context if enriched
+    const enriched = isEnriched(ctx) ? ctx : null;
+    const moduleContext = enriched?.modules?.length
+        ? ` (${enriched.modules.slice(0, 3).map((m) => m.name).join(', ')})`
+        : '';
+    if (stack.hasBackend) {
+        dispatch += `    ├──→ [${stack.primary.toUpperCase()}-BACKEND-DEVELOPER]${moduleContext}\n`;
+        dispatch += `    │    • Arquitetura de serviços e APIs\n`;
+        dispatch += `    │    • Lógica de negócio e validações\n`;
+        dispatch += `    │    • Entities, DTOs, migrations\n`;
+        dispatch += `    │\n`;
+    }
+    if (stack.hasFrontend) {
+        const fw = stack.frameworks.find(f => ['Angular', 'Vue', 'Next.js', 'React'].includes(f)) || 'FRONTEND';
+        dispatch += `    ├──→ [${fw.toUpperCase().replace('.', '')}-FRONTEND-DEVELOPER]\n`;
+        dispatch += `    │    • Componentes e páginas\n`;
+        dispatch += `    │    • State management e formulários\n`;
+        dispatch += `    │    • UX responsiva\n`;
+        dispatch += `    │\n`;
+    }
+    if (stack.hasMobile) {
+        dispatch += `    ├──→ [FLUTTER-UI-DEVELOPER]\n`;
+        dispatch += `    │    • Screens e widgets\n`;
+        dispatch += `    │    • Navegação e integração API\n`;
+        dispatch += `    │\n`;
+    }
+    if (stack.hasDatabase) {
+        dispatch += `    ├──→ [DATABASE-ENGINEER]\n`;
+        dispatch += `    │    • Schema design e migrations\n`;
+        dispatch += `    │    • Índices e performance de queries\n`;
+        dispatch += `    │\n`;
+    }
+    dispatch += `    ├──→ [SECURITY-AUDITOR]\n`;
+    dispatch += `    │    • Análise de ameaças (STRIDE)\n`;
+    dispatch += `    │    • Compliance check\n`;
+    dispatch += `    │\n`;
+    dispatch += `    ├──→ [QA-TEST-ENGINEER]\n`;
+    dispatch += `    │    • Plano de testes\n`;
+    dispatch += `    │    • Cobertura mínima: ${ctx.config.coverageMinimum}%\n`;
+    dispatch += `    │\n`;
+    dispatch += `    └──→ [TECH-DEBT-CONTROLLER]\n`;
+    dispatch += `         • Débito técnico existente\n`;
+    dispatch += `         • Refatorações pré-requisito\n`;
+    return dispatch;
+}
+function buildBusinessQuestions(ctx) {
+    const questions = [
+        'Q1: Quem são os atores envolvidos? (personas)',
+        'Q2: Qual o impacto em receita/negócio?',
+        'Q3: Existem regras de negócio específicas?',
+        'Q4: Quais métricas de sucesso?',
+        'Q5: Há requisitos de compliance (LGPD, PCI, etc)?',
+        'Q6: Quais módulos/serviços são afetados?',
+        'Q7: Quais entidades de banco são tocadas?',
+        'Q8: Existe fluxo de dados entre sistemas?',
+        'Q9: Precisa de versionamento de API?',
+        'Q10: Há integrações externas envolvidas?',
+    ];
+    // Add domain-specific questions if enriched context available
+    const enriched = isEnriched(ctx) ? ctx : null;
+    if (enriched?.domain) {
+        const { domain } = enriched;
+        questions.push(`Q11: Como isso se alinha com o domínio ${domain.domain}?`);
+        if (domain.compliance?.length) {
+            const complianceNames = domain.compliance.map((c) => c.name).join(', ');
+            questions.push(`Q12: Como garantir conformidade com ${complianceNames}?`);
+        }
+        if (domain.integrations?.length) {
+            const integrationNames = domain.integrations.slice(0, 3).map((i) => i.name).join(', ');
+            questions.push(`Q13: Como essa mudança afeta as integrações com ${integrationNames}?`);
+        }
+    }
+    if (ctx.stack.hasDatabase) {
+        const startIdx = enriched?.domain ? 14 : 11;
+        questions.push(`Q${startIdx}: Volume estimado de dados?`, `Q${startIdx + 1}: Há picos de uso previsíveis?`, `Q${startIdx + 2}: Processamento síncrono ou assíncrono?`);
+    }
+    let nextQ = questions.length + 1;
+    questions.push(`Q${nextQ++}: Quem precisa de autenticação?`, `Q${nextQ++}: Quais permissões são necessárias?`, `Q${nextQ++}: Há dados sensíveis envolvidos?`, `Q${nextQ++}: Quais ameaças são relevantes?`);
+    return questions.map(q => `- **${q}**`).join('\n');
+}
+//# sourceMappingURL=orchestrator.js.map

package/dist/src/core/agent-generator/templates/core/orchestrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.js","sourceRoot":"","sources":["../../../../../../src/core/agent-generator/templates/core/orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/agent-generator/templates/core/preflight.d.ts

@@ -0,0 +1,7 @@
+import { TemplateContext } from '@girardelli/architect-agents/src/core/agent-generator/types/template.js';
+/**
+ * Generates enterprise-grade PREFLIGHT.md
+ * 6-phase checklist: mental prep → mandatory reads → environment → business rules →
+ * before-code by layer → before-done. Red flags, diagnostic template, delivery checklist.
+ */
+export declare function generatePreflight(ctx: TemplateContext): string;

package/dist/src/core/agent-generator/templates/core/preflight.js

@@ -0,0 +1,213 @@
+import { getEnriched } from '../template-helpers.js';
+/**
+ * Generates enterprise-grade PREFLIGHT.md
+ * 6-phase checklist: mental prep → mandatory reads → environment → business rules →
+ * before-code by layer → before-done. Red flags, diagnostic template, delivery checklist.
+ */
+export function generatePreflight(ctx) {
+    const { stack, projectName, config, report } = ctx;
+    const enriched = getEnriched(ctx);
+    const tc = enriched.toolchain;
+    return `---
+antigravity:
+  trigger: 'always_on'
+  globs: ['**/*']
+  description: 'PREFLIGHT — Checklist obrigatório pré-ação para ${projectName}'
+  priority: CRITICAL
+---
+
+# ✈️ PREFLIGHT — Checklist Pré-Ação
+
+> **NENHUMA ação de código é permitida antes de completar este checklist.**
+> Pular qualquer fase é violação do protocolo.
+
+---
+
+## FASE 0: Preparação Mental
+
+Antes de abrir qualquer arquivo:
+
+\`\`\`
+□ Li e entendi a requisição COMPLETAMENTE
+□ Sei qual WORKFLOW estou seguindo (new-feature / fix-bug / review)
+□ Identifiquei as CAMADAS envolvidas (Backend / Frontend / App / Database)
+□ Tenho CLAREZA sobre o que é esperado como entrega
+□ Se algo não está claro → PAREI e PERGUNTEI ao humano
+\`\`\`
+
+---
+
+## FASE 1: Leitura Obrigatória
+
+\`\`\`
+□ [00-general.md](../rules/00-general.md)         → Regras de Ouro do projeto
+□ [QUALITY-GATES.md](./QUALITY-GATES.md)           → Métricas e blockers
+□ LESSONS-LEARNED.md (se existir)                   → Erros passados
+□ ERROR-PATTERNS.md (se existir)                    → Padrões de erro conhecidos
+□ BUSINESS-RULES.md (se existir)                    → Regras de negócio do domínio
+\`\`\`
+
+> **Objetivo:** Não repetir erros e entender o contexto antes de agir.
+
+---
+
+## FASE 2: Verificação de Ambiente
+
+\`\`\`bash
+# Git: verificar branch e status
+git branch --show-current        # NUNCA em main/develop direto
+git status                       # Limpo antes de começar
+git pull origin <branch>         # Sincronizado
+
+# Deps: verificar se está tudo instalado
+${tc?.installCmd || (stack.packageManager === 'npm' ? 'npm ci' : stack.packageManager === 'pip' ? 'pip install -r requirements.txt' : stack.packageManager === 'pub' ? 'flutter pub get' : `${stack.packageManager} install`)}
+
+# Build: verificar se compila
+${tc?.buildCmd || (stack.packageManager === 'npm' ? 'npm run build' : stack.packageManager === 'pub' ? 'flutter build' : 'make build')}
+
+# Tests: verificar se passam ANTES de começar
+${tc?.testCmd || (stack.testFramework === 'pytest' ? 'pytest' : stack.testFramework === 'flutter_test' ? 'flutter test' : stack.testFramework === 'go test' ? 'go test ./...' : 'npm run test')}
+\`\`\`
+
+\`\`\`
+□ Branch correta (NUNCA main/develop)
+□ Working tree limpa
+□ Dependências instaladas
+□ Build passando
+□ Testes passando ANTES da minha alteração
+\`\`\`
+
+---
+
+## FASE 3: Verificação de Regras de Negócio
+
+\`\`\`
+□ Entendo QUEM são os atores afetados
+□ Entendo QUAL é a regra de negócio envolvida
+□ Verifiquei se existe documentação do domínio
+□ Se a feature envolve dinheiro/pagamento → ATENÇÃO REDOBRADA
+□ Se a feature envolve dados pessoais → verificar LGPD/compliance
+□ Se a feature muda um fluxo existente → verificar impacto em features dependentes
+\`\`\`
+
+---
+
+## FASE 4: Before-Code Checklist (por Camada)
+
+### 4A: Backend ${stack.hasBackend ? '✅' : '⬜ (skip se não aplicável)'}
+
+\`\`\`
+□ Entendo a estrutura de módulos existente
+□ Sei onde criar/modificar controllers, services, entities
+□ Verifiquei se já existe código similar (DRY)
+□ DTOs e validações planejados
+□ Tratamento de erros definido
+□ Sei qual padrão de teste usar (unitário + integração)
+□ Migrations planejadas (se houver alteração de banco)
+\`\`\`
+
+### 4B: Frontend ${stack.hasFrontend ? '✅' : '⬜ (skip se não aplicável)'}
+
+\`\`\`
+□ MOCKUP aprovado pelo humano
+□ Entendo o state management utilizado
+□ Sei onde criar/modificar componentes
+□ Verificar padrão visual (cores, fontes, espaçamentos)
+□ Responsividade considerada
+□ Acessibilidade básica (labels, aria, contraste)
+□ Documento de integração do backend disponível
+\`\`\`
+
+### 4C: Mobile (Flutter) ${stack.hasMobile ? '✅' : '⬜ (skip se não aplicável)'}
+
+\`\`\`
+□ MOCKUP aprovado pelo humano
+□ Entendo a navegação atual do app
+□ Sei onde criar/modificar screens e widgets
+□ Verificar padrão visual do app
+□ Comportamento offline considerado
+□ Documento de integração do backend disponível
+\`\`\`
+
+### 4D: Database ${stack.hasDatabase ? '✅' : '⬜ (skip se não aplicável)'}
+
+\`\`\`
+□ Schema atual compreendido
+□ Migration reversível planejada
+□ Índices necessários identificados
+□ Impacto em queries existentes avaliado
+□ Seed data / fixtures atualizados
+□ Backup strategy para dados existentes
+\`\`\`
+
+---
+
+## FASE 5: Before-Commit
+
+\`\`\`
+□ Build compila sem erros
+□ TODOS os testes passam (velhos + novos)
+□ Cobertura ≥ ${config.coverageMinimum}%
+□ Lint sem warnings
+□ Sem console.log / print() em produção
+□ Sem TODO / FIXME sem issue
+□ Sem secrets hardcoded
+□ Sem arquivos > 500 linhas sem justificativa
+□ Commit message segue padrão (feat: / fix: / refactor: / docs:)
+□ Branch está atualizada com base (rebase se necessário)
+\`\`\`
+
+---
+
+## FASE 6: Before-Done
+
+\`\`\`
+□ TODOS os critérios de aceite estão cobertos
+□ Score não regrediu: architect score ./src ≥ ${config.scoreThreshold}/100
+□ Documentação atualizada (se necessário)
+□ LESSONS-LEARNED atualizado (se descobri algo novo)
+□ PR criado com descrição completa
+□ Code review solicitado
+\`\`\`
+
+---
+
+## 🚩 Red Flags — PARE IMEDIATAMENTE SE:
+
+| Red Flag | Ação |
+|----------|------|
+| Não entendo a requisição | PARAR → Perguntar ao humano |
+| Código que mexo tem 0% de cobertura | PARAR → Escrever testes ANTES |
+| Estou modificando > 10 arquivos | PARAR → Reavaliar escopo |
+| Build quebrou após minha mudança | PARAR → Reverter → Investigar |
+| Estou copiando/colando código | PARAR → Extrair abstração |
+| Estou trabalhando em main/develop | PARAR → Criar branch |
+| Não tenho mockup e a feature tem UI | PARAR → Gate 1 primeiro |
+| Estou escrevendo código sem testes | PARAR → TDD |
+
+---
+
+## 🔍 Template de Diagnóstico
+
+Execute antes de qualquer implementação:
+
+\`\`\`bash
+# Estrutura do projeto
+find . -type f -name "*.${stack.primary === 'Python' ? 'py' : stack.primary === 'Dart' ? 'dart' : 'ts'}" | head -30
+
+# Dependências do módulo que vou modificar
+grep -r "import.*${stack.primary === 'Python' ? 'from' : 'from'}" --include="*.${stack.primary === 'Python' ? 'py' : 'ts'}" [modulo]/ | head -20
+
+# Testes existentes
+find . -name "*.test.*" -o -name "*.spec.*" -o -name "*_test.*" | head -20
+
+# Score atual
+npx @girardelli/architect score .
+\`\`\`
+
+---
+
+**Gerado por Architect v8.1 · Score: ${report.score.overall}/100 · ${new Date().toISOString().split('T')[0]}**
+`;
+}
+//# sourceMappingURL=preflight.js.map

package/dist/src/core/agent-generator/templates/core/preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../../../src/core/agent-generator/templates/core/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAoB;IACpD,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;IACnD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,CAAC;IAE9B,OAAO;;;;kEAIyD,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgD3E,EAAE,EAAE,UAAU,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,cAAc,UAAU,CAAC;;;EAG3N,EAAE,EAAE,QAAQ,IAAI,CAAC,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;;;EAGpI,EAAE,EAAE,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,KAAK,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBA4B7K,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B;;;;;;;;;;;;mBAYnD,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B;;;;;;;;;;;;2BAY7C,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B;;;;;;;;;;;mBAW3D,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B;;;;;;;;;;;;;;;;;;gBAkBxD,MAAM,CAAC,eAAe;;;;;;;;;;;;;;;;gDAgBU,MAAM,CAAC,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BA8B3C,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;;;mBAGnF,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,kBAAkB,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI;;;;;;;;;;;uCAWlF,MAAM,CAAC,KAAK,CAAC,OAAO,UAAU,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC1G,CAAC;AACF,CAAC"}

package/dist/src/core/agent-generator/templates/core/quality-gates.d.ts

@@ -0,0 +1,10 @@
+import { TemplateContext, EnrichedTemplateContext } from '@girardelli/architect-agents/src/core/agent-generator/types/template.js';
+/**
+ * Generates enterprise-grade QUALITY-GATES.md
+ * 3-level gates (CRITICAL/IMPORTANT/DESIRABLE), per-layer checklists,
+ * explicit blockers list, metrics table, 4-stage verification process.
+ *
+ * Context-aware: Adds compliance-specific gates, untested modules warnings,
+ * and domain-specific blockers when enriched data is available.
+ */
+export declare function generateQualityGates(ctx: TemplateContext | EnrichedTemplateContext): string;