@girardelli/architect 2.2.0 → 4.0.0

package/dist/agent-generator/templates/core/index-md.js

@@ -0,0 +1,246 @@
+/**
+ * Generates enterprise-grade INDEX.md — master navigation guide for the agent framework.
+ * ~350+ lines with: mandatory reads, situational guide, agent catalog, templates, flow diagram.
+ */
+export function generateIndexMd(ctx) {
+    const { report, stack, projectName, stackLabel, plan, config } = ctx;
+    const agents = buildAgentCatalog(ctx);
+    const situationalGuide = buildSituationalGuide(ctx);
+    const templates = buildTemplatesCatalog();
+    return `# ${projectName} — Agent Framework
+
+> **Auto-generated by [Architect v3.1](https://github.com/camilooscargbaptista/architect)**
+> Stack: **${stackLabel}** | Score: **${report.score.overall}/100** | Files: **${report.projectInfo.totalFiles}** | Lines: **${report.projectInfo.totalLines.toLocaleString()}**
+
+---
+
+## ⛔ PARE AQUI — LEITURA OBRIGATÓRIA
+
+> **Antes de qualquer ação, leia estes documentos NA ORDEM.**
+> Pular esta etapa é violação do protocolo.
+
+| # | Arquivo | O que contém | Quando ler |
+|---|---------|-------------|-----------|
+| 1 | [00-general.md](./rules/00-general.md) | Regras de Ouro, convenções, identidade do projeto | **SEMPRE** |
+| 2 | [PREFLIGHT.md](./guards/PREFLIGHT.md) | Checklist pré-ação por camada | **SEMPRE** |
+| 3 | [QUALITY-GATES.md](./guards/QUALITY-GATES.md) | Métricas mínimas, blockers, processo de verificação | **SEMPRE** |
+| 4 | [CODE-REVIEW-CHECKLIST.md](./guards/CODE-REVIEW-CHECKLIST.md) | Pontos obrigatórios de revisão | Antes de PR |
+
+---
+
+## 🗺️ Guia Situacional
+
+> **"O que vou fazer?"** → Siga a coluna correspondente.
+
+${situationalGuide}
+
+---
+
+## 🤖 Agentes Disponíveis
+
+${agents}
+
+---
+
+## 📋 Templates Disponíveis
+
+${templates}
+
+---
+
+## 📁 Estrutura do Framework
+
+\`\`\`
+.agent/
+├── INDEX.md              ← VOCÊ ESTÁ AQUI
+├── agents/               → Agentes especializados
+│   ├── AGENT-ORCHESTRATOR.md
+${stack.hasBackend ? `│   ├── ${stack.primary.toUpperCase()}-BACKEND-DEVELOPER.md\n` : ''}${stack.hasFrontend ? `│   ├── FRONTEND-DEVELOPER.md\n` : ''}${stack.hasMobile ? `│   ├── FLUTTER-UI-DEVELOPER.md\n` : ''}${stack.hasDatabase ? `│   ├── DATABASE-ENGINEER.md\n` : ''}│   ├── SECURITY-AUDITOR.md
+│   ├── QA-TEST-ENGINEER.md
+│   └── TECH-DEBT-CONTROLLER.md
+├── rules/                → Regras de codificação
+│   ├── 00-general.md
+│   ├── 01-architecture.md
+│   └── 02-security.md
+├── guards/               → Checklists e quality gates
+│   ├── PREFLIGHT.md
+│   ├── QUALITY-GATES.md
+│   └── CODE-REVIEW-CHECKLIST.md
+├── workflows/            → Fluxos de trabalho
+│   ├── new-feature.md
+│   ├── fix-bug.md
+│   └── review.md
+├── templates/            → Templates reutilizáveis
+│   ├── C4.md
+│   ├── BDD.md
+│   ├── TDD.md
+│   ├── ADR.md
+│   └── THREAT-MODEL.md
+└── skills/               → Padrões e referências
+\`\`\`
+
+---
+
+## 🔄 Fluxo Completo de Desenvolvimento
+
+\`\`\`
+REQUISIÇÃO RECEBIDA
+       │
+       ▼
+┌──────────────────┐
+│  PREFLIGHT.md    │ ← Ler OBRIGATÓRIO
+│  (diagnóstico)   │
+└────────┬─────────┘
+         │
+         ▼
+┌──────────────────┐
+│  ORCHESTRATOR    │ ← Decompõe a requisição
+│  (classificar)   │
+└────────┬─────────┘
+         │
+         ▼
+┌──────────────────────────────────────┐
+│         6 GATES OBRIGATÓRIOS         │
+│                                      │
+│  1. MOCKUP (se tem UI)               │
+│  2. User Stories                     │
+│  3. Arquitetura (C4)                 │
+│  4. Tarefas (breakdown)              │
+│  5. BDD (cenários)                   │
+│  6. TDD (casos de teste)            │
+│                                      │
+│  ⚠️  /approved após cada gate        │
+└────────┬─────────────────────────────┘
+         │
+         ▼
+┌──────────────────────────────────────┐
+│      IMPLEMENTAÇÃO (ordenada)        │
+│                                      │
+│  1° Backend (se houver)              │
+│  2° Documento de Integração          │
+│  3° Frontend / App (se houver)       │
+└────────┬─────────────────────────────┘
+         │
+         ▼
+┌──────────────────┐
+│  QUALITY-GATES   │ ← Build + Coverage ≥ ${config.coverageMinimum}%
+│  (verificação)   │
+└────────┬─────────┘
+         │
+         ▼
+┌──────────────────┐
+│  CODE REVIEW     │ ← Checklist obrigatório
+│  (PR)            │
+└────────┬─────────┘
+         │
+         ▼
+      ✅ DONE
+\`\`\`
+
+---
+
+## ⚡ Atalhos Rápidos
+
+| Situação | Comando / Workflow |
+|----------|-------------------|
+| Nova feature | \`/new-feature\` → [workflow](./workflows/new-feature.md) |
+| Corrigir bug | \`/fix-bug\` → [workflow](./workflows/fix-bug.md) |
+| Code review | \`/review\` → [workflow](./workflows/review.md) |
+| Verificar qualidade | \`architect score ./src\` |
+| Analisar arquitetura | \`architect analyze ./src\` |
+
+---
+
+## 🔌 Plugin Recomendado
+
+Para análise contínua de arquitetura e manutenção do score:
+
+\`\`\`
+┌─────────────────────────────────────────────┐
+│  📦 @girardelli/architect                   │
+│  Plugin para Claude Code                    │
+│                                             │
+│  npm install -g @girardelli/architect       │
+│                                             │
+│  Comandos:                                  │
+│  • architect analyze ./src                  │
+│  • architect score ./src                    │
+│  • architect agents ./src                   │
+│  • architect refactor ./src                 │
+│                                             │
+│  Score atual: ${String(report.score.overall).padEnd(2)}/100                        │
+│  Meta: ${String(Math.min(100, report.score.overall + 10)).padEnd(3)}/100                       │
+└─────────────────────────────────────────────┘
+\`\`\`
+
+---
+
+## ⚠️ REGRA DE OURO
+
+> **Na dúvida, PARA e PERGUNTA ao humano.**
+> Nunca assuma. Nunca decida sozinho. Sempre valide.
+
+---
+
+**Gerado por Architect v3.1 · Score: ${report.score.overall}/100 · ${new Date().toISOString().split('T')[0]}**
+`;
+}
+function buildAgentCatalog(ctx) {
+    const { stack } = ctx;
+    const rows = [];
+    rows.push('| Agente | Role | Capabilities |');
+    rows.push('|--------|------|-------------|');
+    rows.push('| [AGENT-ORCHESTRATOR](./agents/AGENT-ORCHESTRATOR.md) | coordination | Decomposição, dispatch, consolidação, quality gate |');
+    if (stack.hasBackend) {
+        rows.push(`| [${stack.primary.toUpperCase()}-BACKEND-DEVELOPER](./agents/${stack.primary.toUpperCase()}-BACKEND-DEVELOPER.md) | development | APIs, serviços, lógica de negócio, migrations |`);
+    }
+    if (stack.hasFrontend) {
+        const fw = stack.frameworks.find(f => ['Angular', 'Vue', 'Next.js', 'React'].includes(f)) || 'FRONTEND';
+        rows.push(`| [${fw.toUpperCase().replace('.', '')}-FRONTEND-DEVELOPER](./agents/${fw.toUpperCase().replace('.', '')}-FRONTEND-DEVELOPER.md) | development | Componentes, state management, UX responsiva |`);
+    }
+    if (stack.hasMobile) {
+        rows.push('| [FLUTTER-UI-DEVELOPER](./agents/FLUTTER-UI-DEVELOPER.md) | development | Screens, widgets, navegação, integração API |');
+    }
+    if (stack.hasDatabase) {
+        rows.push('| [DATABASE-ENGINEER](./agents/DATABASE-ENGINEER.md) | development | Schema, migrations, indexação, performance |');
+    }
+    rows.push('| [SECURITY-AUDITOR](./agents/SECURITY-AUDITOR.md) | quality | Ameaças STRIDE, OWASP, LGPD, vulnerabilidades |');
+    rows.push('| [QA-TEST-ENGINEER](./agents/QA-TEST-ENGINEER.md) | quality | Planos de teste, BDD/TDD, cobertura, regressão |');
+    rows.push('| [TECH-DEBT-CONTROLLER](./agents/TECH-DEBT-CONTROLLER.md) | governance | Débito técnico, refatorações, metas de score |');
+    return rows.join('\n');
+}
+function buildSituationalGuide(ctx) {
+    const { stack } = ctx;
+    const rows = [];
+    rows.push('| Ação | Leia antes | Workflow | Agente principal |');
+    rows.push('|------|-----------|---------|-----------------|');
+    rows.push('| Nova feature | 00-general + PREFLIGHT | [new-feature](./workflows/new-feature.md) | ORCHESTRATOR |');
+    rows.push('| Corrigir bug | 00-general + PREFLIGHT | [fix-bug](./workflows/fix-bug.md) | ORCHESTRATOR |');
+    if (stack.hasBackend) {
+        rows.push(`| Mexer em backend | 00-general + 01-architecture | new-feature ou fix-bug | ${stack.primary.toUpperCase()}-BACKEND |`);
+    }
+    if (stack.hasFrontend) {
+        rows.push('| Mexer em frontend | 00-general + 01-architecture | new-feature ou fix-bug | FRONTEND |');
+    }
+    if (stack.hasMobile) {
+        rows.push('| Mexer no app | 00-general | new-feature ou fix-bug | FLUTTER-UI |');
+    }
+    if (stack.hasDatabase) {
+        rows.push('| Mexer em banco | 00-general + 01-architecture | new-feature | DATABASE-ENGINEER |');
+    }
+    rows.push('| Segurança | 02-security | — | SECURITY-AUDITOR |');
+    rows.push('| Testes | 00-general | — | QA-TEST-ENGINEER |');
+    rows.push('| Refatoração | QUALITY-GATES | — | TECH-DEBT-CONTROLLER |');
+    rows.push('| Code review | CODE-REVIEW-CHECKLIST | [review](./workflows/review.md) | QA-TEST-ENGINEER |');
+    return rows.join('\n');
+}
+function buildTemplatesCatalog() {
+    return `| Template | Arquivo | Quando usar |
+|----------|---------|-----------|
+| C4 Architecture | [C4.md](./templates/C4.md) | Documentar arquitetura de qualquer feature |
+| BDD Scenarios | [BDD.md](./templates/BDD.md) | Antes de implementar — cenários de aceite |
+| TDD Cases | [TDD.md](./templates/TDD.md) | Antes de implementar — casos de teste |
+| ADR | [ADR.md](./templates/ADR.md) | Decisões arquiteturais significativas |
+| Threat Model | [THREAT-MODEL.md](./templates/THREAT-MODEL.md) | Features que lidam com dados sensíveis |`;
+}
+//# sourceMappingURL=index-md.js.map

package/dist/agent-generator/templates/core/index-md.js.map

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

package/dist/agent-generator/templates/core/orchestrator.d.ts

@@ -0,0 +1,8 @@
+import { TemplateContext, EnrichedTemplateContext } from '../../types.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 declare function generateOrchestrator(ctx: TemplateContext | EnrichedTemplateContext): string;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/agent-generator/templates/core/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/agent-generator/templates/core/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAgB1E;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG,uBAAuB,GAAG,MAAM,CA6U3F"}

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

@@ -0,0 +1,422 @@
+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) {
+    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 v3.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