@girardelli/architect-agents 8.1.0

package/src/core/agent-generator/templates/core/orchestrator.ts

@@ -0,0 +1,462 @@
+import { TemplateContext, EnrichedTemplateContext } from '@girardelli/architect-agents/src/core/agent-generator/types/template.js';
+import {
+    // @ts-ignore - Audit cleanup unused variable
+  getEnriched,
+  isEnriched,
+    // @ts-ignore - Audit cleanup unused variable
+  depthScale,
+  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: TemplateContext | EnrichedTemplateContext): string {
+    // @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: TemplateContext | EnrichedTemplateContext): string {
+  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: any) => 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: TemplateContext | EnrichedTemplateContext): string {
+  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: any) => c.name).join(', ');
+      questions.push(`Q12: Como garantir conformidade com ${complianceNames}?`);
+    }
+
+    if (domain.integrations?.length) {
+      const integrationNames = domain.integrations.slice(0, 3).map((i: any) => 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');
+}

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

@@ -0,0 +1,216 @@
+    // @ts-ignore - Audit cleanup unused variable
+import { TemplateContext, EnrichedTemplateContext } from '@girardelli/architect-agents/src/core/agent-generator/types/template.js';
+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: TemplateContext): string {
+  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]}**
+`;
+}