@maestro-ai/mcp-server 2.4.2 → 2.6.0

package/dist/tools/prd-writer.js

@@ -0,0 +1,377 @@
+/**
+ * Tool: PRD Writer
+ * Consolida brainstorm e discovery em um PRD estruturado e validado
+ */
+import { parsearEstado, serializarEstado } from "../state/storage.js";
+import { setCurrentDirectory } from "../state/context.js";
+import { resolveProjectPath } from "../utils/files.js";
+import { calcularQualidade } from "../gates/quality-scorer.js";
+/**
+ * Gera PRD estruturado a partir do brainstorm e discovery
+ */
+function gerarPRDConteudo(onboarding, nomeProjetoDiretorio) {
+    const linhas = [];
+    // Cabeçalho
+    linhas.push(`# PRD - ${onboarding.discoveryResponses.nome_projeto || 'Projeto'}`);
+    linhas.push(`\n**Data:** ${new Date().toLocaleDateString('pt-BR')}`);
+    linhas.push(`**Versão:** 1.0 (Draft)`);
+    linhas.push(`**Status:** Em Validação\n`);
+    // Sumário Executivo
+    linhas.push('---\n');
+    linhas.push('## 1. Sumário Executivo\n');
+    const problemaSecao = onboarding.brainstormSections.find((s) => s.id === 'problema-oportunidade');
+    if (problemaSecao?.response) {
+        linhas.push('### Problema e Oportunidade\n');
+        linhas.push(problemaSecao.response);
+        linhas.push('\n');
+    }
+    // Personas
+    linhas.push('---\n');
+    linhas.push('## 2. Personas e Jobs to Be Done\n');
+    const personasSecao = onboarding.brainstormSections.find((s) => s.id === 'personas-jtbd');
+    if (personasSecao?.response) {
+        linhas.push(personasSecao.response);
+        linhas.push('\n');
+    }
+    // MVP e Funcionalidades
+    linhas.push('---\n');
+    linhas.push('## 3. MVP e Funcionalidades Priorizadas\n');
+    const mvpSecao = onboarding.brainstormSections.find((s) => s.id === 'mvp-funcionalidades');
+    if (mvpSecao?.response) {
+        linhas.push(mvpSecao.response);
+        linhas.push('\n');
+    }
+    // Métricas
+    linhas.push('---\n');
+    linhas.push('## 4. Métricas de Sucesso\n');
+    const metricasSecao = onboarding.brainstormSections.find((s) => s.id === 'metricas-sucesso');
+    if (metricasSecao?.response) {
+        linhas.push(metricasSecao.response);
+        linhas.push('\n');
+    }
+    // Riscos
+    linhas.push('---\n');
+    linhas.push('## 5. Riscos e Planos de Mitigação\n');
+    const riscosSecao = onboarding.brainstormSections.find((s) => s.id === 'riscos-mitigacoes');
+    if (riscosSecao?.response) {
+        linhas.push(riscosSecao.response);
+        linhas.push('\n');
+    }
+    // Contexto Técnico
+    linhas.push('---\n');
+    linhas.push('## 6. Contexto Técnico\n');
+    linhas.push('### Stack Preferida\n');
+    linhas.push(`${onboarding.discoveryResponses.stack_preferida || 'A sugerir baseado em requisitos'}\n`);
+    linhas.push('### Plataformas\n');
+    const plataformas = Array.isArray(onboarding.discoveryResponses.plataformas)
+        ? onboarding.discoveryResponses.plataformas.join(', ')
+        : onboarding.discoveryResponses.plataformas || 'A definir';
+    linhas.push(`${plataformas}\n`);
+    if (onboarding.discoveryResponses.integracoes_externas) {
+        linhas.push('### Integrações Externas\n');
+        linhas.push(`${onboarding.discoveryResponses.integracoes_externas}\n`);
+    }
+    // Timeline
+    linhas.push('---\n');
+    linhas.push('## 7. Timeline e Recursos\n');
+    linhas.push(`### Cronograma Desejado\n`);
+    linhas.push(`${onboarding.discoveryResponses.cronograma || 'A definir'}\n`);
+    if (onboarding.discoveryResponses.tamanho_time) {
+        linhas.push(`### Tamanho do Time\n`);
+        linhas.push(`${onboarding.discoveryResponses.tamanho_time}\n`);
+    }
+    if (onboarding.discoveryResponses.experiencia_time) {
+        linhas.push(`### Experiência do Time\n`);
+        linhas.push(`${onboarding.discoveryResponses.experiencia_time}\n`);
+    }
+    // Requisitos Críticos
+    linhas.push('---\n');
+    linhas.push('## 8. Requisitos Críticos\n');
+    if (onboarding.discoveryResponses.performance_esperada) {
+        linhas.push(`### Performance\n`);
+        linhas.push(`${onboarding.discoveryResponses.performance_esperada}\n`);
+    }
+    if (onboarding.discoveryResponses.seguranca_compliance && onboarding.discoveryResponses.seguranca_compliance.length > 0) {
+        linhas.push(`### Compliance\n`);
+        const compliance = Array.isArray(onboarding.discoveryResponses.seguranca_compliance)
+            ? onboarding.discoveryResponses.seguranca_compliance.join(', ')
+            : onboarding.discoveryResponses.seguranca_compliance;
+        linhas.push(`${compliance}\n`);
+    }
+    if (onboarding.discoveryResponses.escalabilidade) {
+        linhas.push(`### Escalabilidade\n`);
+        linhas.push(`${onboarding.discoveryResponses.escalabilidade}\n`);
+    }
+    // Metadata
+    linhas.push('---\n');
+    linhas.push('## Metadata\n');
+    linhas.push(`- **Modo:** ${onboarding.mode.toUpperCase()}`);
+    linhas.push(`- **Criado em:** ${new Date().toISOString()}`);
+    linhas.push(`- **Total de interações:** ${onboarding.totalInteractions}`);
+    return linhas.join('\n');
+}
+/**
+ * Tool: prd_writer
+ * Gera, valida e consolida PRD
+ */
+export async function prdWriter(args) {
+    if (!args.estado_json) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Parâmetro `estado_json` é obrigatório.",
+                }],
+            isError: true,
+        };
+    }
+    if (!args.diretorio) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Parâmetro `diretorio` é obrigatório.",
+                }],
+            isError: true,
+        };
+    }
+    const estado = parsearEstado(args.estado_json);
+    if (!estado) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Não foi possível parsear o estado JSON.",
+                }],
+            isError: true,
+        };
+    }
+    const diretorio = resolveProjectPath(args.diretorio);
+    setCurrentDirectory(diretorio);
+    const acao = args.acao || 'gerar';
+    // Obter estado de onboarding
+    const onboarding = estado.onboarding;
+    if (!onboarding) {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Nenhum estado de onboarding encontrado.",
+                }],
+            isError: true,
+        };
+    }
+    if (acao === 'gerar') {
+        return handleGerarPRD(onboarding, estado, diretorio);
+    }
+    else if (acao === 'validar') {
+        return handleValidarPRD(onboarding, estado, diretorio);
+    }
+    else if (acao === 'status') {
+        return handleStatusPRD(onboarding);
+    }
+    return {
+        content: [{
+                type: "text",
+                text: `❌ **Erro**: Ação desconhecida: ${acao}`,
+            }],
+        isError: true,
+    };
+}
+/**
+ * Handler: gerar PRD
+ */
+function handleGerarPRD(onboarding, estado, diretorio) {
+    if (onboarding.brainstormStatus !== 'completed') {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: Brainstorm não foi concluído. Complete o brainstorm antes de gerar o PRD.",
+                }],
+            isError: true,
+        };
+    }
+    // Gerar conteúdo do PRD
+    const prdConteudo = gerarPRDConteudo(onboarding, estado.nome);
+    // Atualizar estado
+    onboarding.prdStatus = 'draft';
+    onboarding.phase = 'prd_draft';
+    onboarding.totalInteractions++;
+    onboarding.lastInteractionAt = new Date().toISOString();
+    const estadoAtualizado = {
+        ...estado,
+        onboarding,
+        atualizado_em: new Date().toISOString(),
+    };
+    const estadoFile = serializarEstado(estadoAtualizado);
+    const resposta = `# ✅ PRD Draft Gerado!
+
+O PRD foi consolidado a partir do discovery e brainstorm.
+
+---
+
+## 📄 Conteúdo do PRD
+
+\`\`\`markdown
+${prdConteudo.substring(0, 500)}...
+\`\`\`
+
+---
+
+## 🔍 Próximos Passos
+
+1. **Revisar PRD:** Verifique se todos os detalhes estão corretos
+2. **Validar Completude:** Use \`prd_writer(estado_json: "...", diretorio: "...", acao: "validar")\`
+3. **Ajustar se necessário:** Refine seções que precisam de melhorias
+4. **Avançar para Fase 1:** Quando validado, o PRD estará pronto para a próxima fase
+
+---
+
+## ⚡ AÇÃO OBRIGATÓRIA - Atualizar Estado
+
+**Caminho:** \`${estadoFile.path}\`
+
+\`\`\`json
+${estadoFile.content}
+\`\`\`
+
+**Arquivo PRD:** \`docs/01-produto/PRD.md\`
+
+\`\`\`markdown
+${prdConteudo}
+\`\`\`
+`;
+    return {
+        content: [{ type: "text", text: resposta }],
+        files: [
+            {
+                path: `${diretorio}/${estadoFile.path}`,
+                content: estadoFile.content,
+            },
+            {
+                path: `${diretorio}/docs/01-produto/PRD.md`,
+                content: prdConteudo,
+            },
+        ],
+        estado_atualizado: estadoFile.content,
+    };
+}
+/**
+ * Handler: validar PRD
+ */
+function handleValidarPRD(onboarding, estado, diretorio) {
+    if (onboarding.prdStatus !== 'draft') {
+        return {
+            content: [{
+                    type: "text",
+                    text: "❌ **Erro**: PRD não está em draft. Gere o PRD primeiro.",
+                }],
+            isError: true,
+        };
+    }
+    // Gerar conteúdo do PRD para validação
+    const prdConteudo = gerarPRDConteudo(onboarding, estado.nome);
+    // Validar completude
+    const checklist = {
+        'Sumário Executivo': prdConteudo.includes('Problema e Oportunidade'),
+        'Personas e JTBD': prdConteudo.includes('Personas e Jobs to Be Done'),
+        'MVP e Funcionalidades': prdConteudo.includes('MVP e Funcionalidades Priorizadas'),
+        'Métricas de Sucesso': prdConteudo.includes('Métricas de Sucesso'),
+        'Riscos e Mitigações': prdConteudo.includes('Riscos e Planos de Mitigação'),
+        'Contexto Técnico': prdConteudo.includes('Contexto Técnico'),
+        'Timeline e Recursos': prdConteudo.includes('Timeline e Recursos'),
+        'Requisitos Críticos': prdConteudo.includes('Requisitos Críticos'),
+    };
+    const itemsValidados = Object.values(checklist).filter((v) => v).length;
+    const totalItems = Object.keys(checklist).length;
+    const score = Math.round((itemsValidados / totalItems) * 100);
+    // Calcular qualidade
+    const qualidade = calcularQualidade(prdConteudo, {
+        camposObrigatorios: Object.keys(checklist),
+        secoes: Object.keys(checklist),
+    });
+    onboarding.prdScore = qualidade.overall;
+    onboarding.prdStatus = score >= 70 ? 'validated' : 'draft';
+    const linhas = [];
+    linhas.push('# 📊 Validação do PRD\n');
+    linhas.push(`**Score de Completude:** ${score}/100`);
+    linhas.push(`**Score de Qualidade:** ${qualidade.overall}/100\n`);
+    linhas.push('## Checklist de Completude\n');
+    Object.entries(checklist).forEach(([item, valido]) => {
+        const icon = valido ? '✅' : '❌';
+        linhas.push(`${icon} ${item}`);
+    });
+    linhas.push(`\n**Total:** ${itemsValidados}/${totalItems} itens validados\n`);
+    if (score >= 70) {
+        linhas.push('✅ **PRD VALIDADO!** Score ≥ 70\n');
+        linhas.push('Próximo passo: Avançar para Fase 1 (Produto)');
+    }
+    else {
+        linhas.push(`⚠️ **PRD INCOMPLETO** Score: ${score}/100\n`);
+        linhas.push('Recomendações:');
+        Object.entries(checklist).forEach(([item, valido]) => {
+            if (!valido) {
+                linhas.push(`- Adicionar: ${item}`);
+            }
+        });
+    }
+    return {
+        content: [{
+                type: "text",
+                text: linhas.join('\n'),
+            }],
+    };
+}
+/**
+ * Handler: status do PRD
+ */
+function handleStatusPRD(onboarding) {
+    const linhas = [];
+    linhas.push('# 📄 Status do PRD\n');
+    linhas.push(`**Status:** ${onboarding.prdStatus}`);
+    linhas.push(`**Score:** ${onboarding.prdScore}/100`);
+    linhas.push(`**Fase:** ${onboarding.phase}\n`);
+    if (onboarding.prdValidationReport) {
+        linhas.push('## Relatório de Validação\n');
+        linhas.push(`**Score:** ${onboarding.prdValidationReport.score}/100\n`);
+        linhas.push('### Checklist\n');
+        Object.entries(onboarding.prdValidationReport.checklist).forEach(([item, valido]) => {
+            const icon = valido ? '✅' : '❌';
+            linhas.push(`${icon} ${item}`);
+        });
+        if (onboarding.prdValidationReport.gaps.length > 0) {
+            linhas.push('\n### Lacunas\n');
+            onboarding.prdValidationReport.gaps.forEach((gap) => {
+                linhas.push(`- ${gap}`);
+            });
+        }
+        if (onboarding.prdValidationReport.suggestions.length > 0) {
+            linhas.push('\n### Sugestões\n');
+            onboarding.prdValidationReport.suggestions.forEach((sugestao) => {
+                linhas.push(`- ${sugestao}`);
+            });
+        }
+    }
+    return {
+        content: [{
+                type: "text",
+                text: linhas.join('\n'),
+            }],
+    };
+}
+export const prdWriterSchema = {
+    type: "object",
+    properties: {
+        estado_json: {
+            type: "string",
+            description: "Conteúdo do arquivo .maestro/estado.json",
+        },
+        diretorio: {
+            type: "string",
+            description: "Diretório absoluto do projeto",
+        },
+        acao: {
+            type: "string",
+            enum: ["gerar", "validar", "status"],
+            description: "Ação a executar",
+        },
+    },
+    required: ["estado_json", "diretorio"],
+};
+//# sourceMappingURL=prd-writer.js.map

package/dist/tools/prd-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd-writer.js","sourceRoot":"","sources":["../../src/tools/prd-writer.ts"],"names":[],"mappings":"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"}

package/dist/tools/proximo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"proximo.d.ts","sourceRoot":"","sources":["../../src/tools/proximo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAgBnE,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAuBD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAmjBpE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CAyBzB,CAAC"}
+{"version":3,"file":"proximo.d.ts","sourceRoot":"","sources":["../../src/tools/proximo.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,mBAAmB,CAAC;AAkBnE,UAAU,WAAW;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACrB;AAuBD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAwrBpE;AAED;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;CAyBzB,CAAC"}

package/dist/tools/proximo.js

@@ -2,15 +2,17 @@ import { existsSync } from "fs";
 import { parsearEstado, serializarEstado } from "../state/storage.js";
 import { getFaseComStitch, getFluxoComStitch } from "../flows/types.js";
 import { classificarPRD, descreverNivel } from "../flows/classifier.js";
-import { validarGate } from "../gates/validator.js";
+import { validarGate, validarGateComTemplate } from "../gates/validator.js";
 import { setCurrentDirectory } from "../state/context.js";
 import { parsearResumo, serializarResumo, criarResumoInicial, extrairResumoEntregavel } from "../state/memory.js";
 import { logEvent, EventTypes } from "../utils/history.js";
 import { gerarSystemMd } from "../utils/system-md.js";
 import { getSkillParaFase, getSkillResourcePath } from "../utils/prompt-mapper.js";
 import { validarEstrutura } from "../gates/estrutura.js";
-import { resolveProjectPath } from "../utils/files.js";
+import { resolveProjectPath, getServerContentRoot } from "../utils/files.js";
 import { formatSkillMessage, detectIDE, getSkillResourcePath as getIDESkillResourcePath } from "../utils/ide-paths.js";
+import { inferirContextoBalanceado } from "../utils/inferencia-contextual.js";
+import { verificarSkillCarregada } from "../utils/content-injector.js";
 /**
  * Calcula score de qualidade
  */
@@ -84,6 +86,28 @@ proximo(
     // Validar tamanho mínimo do entregável
     const TAMANHO_MINIMO_ENTREGAVEL = 200;
     if (!args.entregavel || args.entregavel.trim().length < TAMANHO_MINIMO_ENTREGAVEL) {
+        // Obter skill e IDE para instruções corretas
+        const ideDetectada = detectIDE(diretorio) || 'windsurf';
+        const skillNome = faseAtualInfo ? getSkillParaFase(faseAtualInfo.nome) : null;
+        let instrucoesSkill = "";
+        if (skillNome) {
+            const skillPath = getIDESkillResourcePath(skillNome, 'reference', ideDetectada);
+            const templatesPath = getIDESkillResourcePath(skillNome, 'templates', ideDetectada);
+            instrucoesSkill = `
+### 📚 Recursos da Skill
+
+Abra os seguintes arquivos no seu IDE:
+
+1. **SKILL.md** (instruções do especialista):
+   \`${getIDESkillResourcePath(skillNome, 'reference', ideDetectada)}SKILL.md\`
+
+2. **Templates** (estrutura do entregável):
+   \`${templatesPath}\`
+
+3. **Checklists** (validação):
+   \`${getIDESkillResourcePath(skillNome, 'checklists', ideDetectada)}\`
+`;
+        }
         return {
             content: [{
                     type: "text",
@@ -101,21 +125,17 @@ O entregável está vazio ou muito curto.
 ## ⚡ AÇÃO OBRIGATÓRIA
 
 Você **DEVE** desenvolver o entregável corretamente:
+${instrucoesSkill}
 
-1. **Ler especialista:**
-   \`\`\`
-   read_resource("maestro://especialista/${faseAtualInfo?.especialista || "..."}")
-   \`\`\`
+### Fluxo Obrigatório
 
-2. **Ler template:**
-   \`\`\`
-   read_resource("maestro://template/${faseAtualInfo?.template || "..."}")
-   \`\`\`
-
-3. Fazer as perguntas do especialista ao usuário
-4. Gerar entregável seguindo TODAS as seções do template
-5. Apresentar ao usuário para aprovação
-6. Só então chamar \`proximo()\`
+1. Leia a **SKILL.md** → Siga as instruções e perguntas do especialista
+2. Consulte os **Templates** → Use como base estrutural
+3. Faça perguntas ao usuário → Conforme indicado na SKILL
+4. Gere o entregável → Seguindo TODAS as seções do template
+5. Valide com o **Checklist** → Antes de avançar
+6. Apresente ao usuário → Para aprovação
+7. Só então chame \`proximo()\`
 
 > ⛔ **NÃO TENTE AVANÇAR** com entregáveis vazios ou incompletos!
 `,
@@ -149,6 +169,52 @@ O **usuário humano** deve decidir:
                 }],
         };
     }
+    // Fluxo PRD-first: se ainda aguardando PRD, analisar e sugerir em um único passo
+    if (estado.status === "aguardando_prd" && estado.fase_atual === 1) {
+        const analise = classificarPRD(args.entregavel);
+        estado.classificacao_sugerida = analise;
+        estado.aguardando_classificacao = true;
+        estado.classificacao_pos_prd_confirmada = false;
+        estado.status = "ativo";
+        // Inferência balanceada (não assume críticos) + perguntas agrupadas
+        estado.inferencia_contextual = inferirContextoBalanceado(`${estado.nome} ${args.entregavel}`);
+        const estadoFile = serializarEstado(estado);
+        const perguntas = estado.inferencia_contextual?.perguntas_prioritarias || [];
+        const perguntasMarkdown = perguntas.length
+            ? perguntas.map((p) => `- (${p.prioridade}) ${p.pergunta}${p.valor_inferido ? `
+  - Inferido: ${p.valor_inferido} (confiança ${((p.confianca_inferencia ?? 0) * 100).toFixed(0)}%)` : ""}`).join("\n")
+            : "- Informe domínio, stack preferida e integrações em um único prompt.";
+        return {
+            content: [{
+                    type: "text",
+                    text: `# 🔍 PRD Analisado (PRD-first)
+
+| Campo | Valor |
+|-------|-------|
+| Nível sugerido | ${analise.nivel.toUpperCase()} |
+| Pontuação | ${analise.pontuacao} |
+| Critérios | ${analise.criterios.join(", ")} |
+
+## Ação obrigatória (responder em UM ÚNICO PROMPT)
+1) Confirme ou ajuste a classificação:
+\`\`\`
+confirmar_classificacao({
+  estado_json: "...",
+  diretorio: "${diretorio}",
+  nivel: "${analise.nivel}" // opcional, ajuste se necessário
+})
+\`\`\`
+2) Responda também às perguntas abaixo no MESMO prompt (evita múltiplos prompts):
+${perguntasMarkdown}
+
+> ⚠️ Não prossiga para outras fases antes de confirmar a classificação.
+> Consulte SKILL e templates em: ${getIDESkillResourcePath(getSkillParaFase(faseAtualInfo?.nome || "Produto") || "specialist-gestao-produto", 'templates', detectIDE(diretorio) || 'windsurf')}
+`,
+                }],
+            files: [{ path: `${diretorio}/${estadoFile.path}`, content: estadoFile.content }],
+            estado_atualizado: estadoFile.content,
+        };
+    }
     // Verificar se há bloqueio de confirmação de classificação (Pós-PRD)
     if (estado.aguardando_classificacao) {
         let msgSugestao = "";
@@ -170,7 +236,7 @@ Antes de prosseguir, você precisa confirmar a classificação do projeto.
 
 ${msgSugestao}
 
-## 🔐 Ação Necessária
+## 🔐 Ação Necessária (responder em UM ÚNICO PROMPT)
 
 Use a tool \`confirmar_classificacao\` para validar ou ajustar a complexidade.
 
@@ -181,6 +247,8 @@ confirmar_classificacao(
 )
 \`\`\`
 
+Inclua no MESMO prompt qualquer ajuste de domínio/stack ou integrações críticas para evitar prompts adicionais.
+
 > ⚠️ **IMPORTANTE**: Você DEVE chamar esta tool antes de continuar.
 `,
                 }],
@@ -196,12 +264,69 @@ confirmar_classificacao(
             isError: true,
         };
     }
-    // Validar estrutura do entregável
-    const estruturaResult = validarEstrutura(estado.fase_atual, args.entregavel);
-    // Validar gate (checklist)
-    const gateResultado = validarGate(faseAtual, args.entregavel);
-    // Calcular score de qualidade
-    const qualityScore = calcularQualityScore(estruturaResult, gateResultado);
+    // Enforcement de skill + template + checklist antes de avançar
+    const ideDetectada = detectIDE(diretorio) || 'windsurf';
+    const skillObrigatoria = getSkillParaFase(faseAtual.nome);
+    if (skillObrigatoria) {
+        const skillOk = await verificarSkillCarregada(diretorio, skillObrigatoria, ideDetectada).catch(() => false);
+        if (!skillOk) {
+            return {
+                content: [{
+                        type: "text",
+                        text: `# ⛔ Skill Obrigatória Não Carregada
+
+Fase: **${faseAtual.nome}**
+Skill necessária: \`${skillObrigatoria}\`
+
+Carregue e leia a skill antes de gerar o entregável:
+1) Ler SKILL: \`${getIDESkillResourcePath(skillObrigatoria, 'reference', ideDetectada)}SKILL.md\`
+2) Templates: \`${getIDESkillResourcePath(skillObrigatoria, 'templates', ideDetectada)}\`
+3) Checklist: \`${getIDESkillResourcePath(skillObrigatoria, 'checklists', ideDetectada)}\`
+
+> Gere o entregável seguindo o template e valide com o checklist antes de chamar \`proximo\`.`,
+                    }],
+                isError: true,
+            };
+        }
+    }
+    // Tentar validação com template (novo sistema inteligente)
+    const diretorioContent = getServerContentRoot();
+    const tier = estado.tier_gate || "base";
+    const validacaoTemplate = validarGateComTemplate(faseAtual, args.entregavel, tier, diretorioContent);
+    let qualityScore;
+    let gateResultado;
+    let estruturaResult;
+    let usouTemplate = false;
+    if (validacaoTemplate.sucesso && validacaoTemplate.resultado) {
+        // Usar validação baseada em template (enforcement)
+        usouTemplate = true;
+        const resultado = validacaoTemplate.resultado;
+        // Converter resultado do template para formato legado para compatibilidade
+        qualityScore = resultado.qualidade?.scoreGeral || resultado.score || 0;
+        // Criar estrutura compatível para gateResultado
+        gateResultado = {
+            valido: resultado.valido,
+            itens_validados: resultado.checkboxes?.preenchidos.map((c) => c.texto) || [],
+            itens_pendentes: resultado.checkboxes?.faltando.map((c) => c.texto) || [],
+            sugestoes: resultado.sugestoes || [],
+        };
+        // Criar estrutura compatível para estruturaResult
+        estruturaResult = {
+            valido: resultado.estrutura?.valida || false,
+            score: resultado.estrutura?.score || 0,
+            secoes_encontradas: resultado.estrutura?.secoesEncontradas || [],
+            secoes_faltando: resultado.estrutura?.secoesFaltando || [],
+            tamanho_ok: true,
+            feedback: resultado.feedback || [],
+        };
+    }
+    else {
+        // Fallback para sistema legado
+        usouTemplate = false;
+        estruturaResult = validarEstrutura(estado.fase_atual, args.entregavel);
+        gateResultado = validarGate(faseAtual, args.entregavel);
+        qualityScore = calcularQualityScore(estruturaResult, gateResultado);
+    }
     // Score < 50: BLOQUEAR
     if (qualityScore < 50) {
         return {