vireum-spec-cli 0.2.1 → 0.3.1

package/dist/commands/setup.js

@@ -149,6 +149,7 @@ async function runSetup() {
     const mcpsSelecionados = await (0, prompts_1.checkbox)({
         message: 'Selecione os MCPs para este projeto:',
         choices: [
+            { name: 'context7   — docs atualizadas das libs do projeto', value: 'context7', checked: true },
             { name: 'github     — PRs, issues, branches', value: 'github', checked: true },
             { name: 'database   — consultar banco em dev', value: 'database', checked: true },
             { name: 'browser    — testar endpoints e fluxos', value: 'browser', checked: true },
@@ -157,10 +158,14 @@ async function runSetup() {
             { name: 'redis      — inspecionar cache e filas', value: 'redis', checked: false },
         ],
     });
+    // Context7 sempre presente
+    const mcpsFinais = mcpsSelecionados.includes('context7')
+        ? mcpsSelecionados
+        : ['context7', ...mcpsSelecionados];
     // ── Gerar arquivos ─────────────────────────────────────────────────────────
     console.log('');
     const projeto = extrairProjeto(path.join(specDir, 'INDEX.md'));
-    const dados = { stack, infra, mcps: mcpsSelecionados, projeto };
+    const dados = { stack, infra, mcps: mcpsFinais, projeto };
     for (const dir of [vireumDir, cursorDir]) {
         if (!fs.existsSync(dir))
             fs.mkdirSync(dir, { recursive: true });
@@ -236,6 +241,7 @@ ${mcps.map((m) => `- ${m}`).join('\n')}
 }
 function gerarMcpSetup(d) {
     const mcpInfo = {
+        context7: 'https://github.com/upstash/context7',
         github: 'https://github.com/modelcontextprotocol/servers/tree/main/src/github',
         database: 'https://github.com/modelcontextprotocol/servers/tree/main/src/postgres',
         browser: 'https://github.com/modelcontextprotocol/servers/tree/main/src/puppeteer',
@@ -256,7 +262,7 @@ ${lista}
 1. Acesse o link de cada MCP acima
 2. Siga as instruções de instalação
 3. Configure as credenciais manualmente no seu cliente (Claude Code / Cursor)
-4. Execute: vireum-spec verify-mcps (em breve)
+4. Execute: vireum-spec verify-mcps
 `;
 }
 function gerarRulesGlobal() {
@@ -270,6 +276,11 @@ function gerarRulesGlobal() {
 - Nunca puxar task do backlog para active sem validação humana explícita
 - Sempre avisar escopo creep antes de implementar — parar e perguntar
 
+## Regras de Planejamento
+- Sempre planejar antes de implementar — escrever o que sera feito e quais arquivos serao tocados
+- Confirmar o plano com o dev em tasks complexas antes de executar
+- Nunca comecar a escrever codigo sem ter um plano claro
+
 ## Regras de Spec
 - Nunca marcar task como done sem validar os critérios de aceitação
 - Nunca tomar decisão de arquitetura sem registrar em architecture.md com justificativa
@@ -288,6 +299,7 @@ function gerarRulesGlobal() {
 
 ## Nunca
 - Implementar sem ler o spec primeiro
+- Implementar sem planejar primeiro
 - Tomar decisão de lib ou stack sem documentar o porquê
 - Responder dúvida de escopo sem consultar requirements.md
 - Comunicar diretamente com o cliente — isso é papel do dev
@@ -300,18 +312,20 @@ function gerarMcpsGlobal(d) {
 > MCPs ativos por projeto estão em .spec/architecture.md
 
 ## Stack Padrão
-- filesystem  — leitura e escrita no projeto (nativo)
-- github      — PRs, issues, branches referenciando tasks
-- database    — validar schema e dados em desenvolvimento
-- browser     — testar endpoints e validar fluxos
-- puppeteer   — testes de jornada de UI
-- docker      — gerenciar containers em desenvolvimento
-- redis       — inspecionar cache e filas (quando aplicável)
+- context7   — documentação atualizada das libs (sempre ativo)
+- filesystem — leitura e escrita no projeto (nativo)
+- github     — PRs, issues, branches referenciando tasks
+- database   — validar schema e dados em desenvolvimento
+- browser    — testar endpoints e validar fluxos
+- puppeteer  — testes de jornada de UI
+- docker     — gerenciar containers em desenvolvimento
+- redis      — inspecionar cache e filas (quando aplicável)
 
 ## MCPs Ativos Neste Projeto
 ${d.mcps.map((m) => `- ${m}`).join('\n')}
 
 ## Quando usar cada MCP
+- Antes de usar qualquer lib → context7: buscar docs atualizadas
 - Task concluída → github: criar PR referenciando a task
 - Bug identificado → github: abrir issue com contexto
 - Decisão de schema → database: validar antes de implementar
@@ -323,6 +337,9 @@ function gerarClaudeMd(d) {
     const { projeto, stack, mcps } = d;
     const tenant = stack.multiTenant
         ? '\n- NUNCA fazer query sem filtro de tenantId — projeto multi-tenant' : '';
+    const libs = [stack.frontend, stack.backend, stack.orm, stack.cache]
+        .filter((l) => l && l !== 'Nenhum' && l !== 'Outro')
+        .join(', ');
     return `# ${projeto} — Vireum Spec Protocol
 
 > Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
@@ -339,16 +356,20 @@ function gerarClaudeMd(d) {
 Acionado por: "desenvolve", "implementa", "cria", + nome de task
 1. Leia \`.spec/tasks/active.md\`
 2. Leia \`.spec/requirements.md\` para contexto da feature
-3. Implemente seguindo os critérios de aceitação da task
-4. Ao concluir: marque como done, mova para \`tasks/done.md\`, atualize \`INDEX.md\`
-5. Se decisão arquitetural tomada: registre em \`architecture.md\`
+3. Consulte o Context7 para docs atualizadas da lib que vai usar
+4. PLANEJAR: escreva o que sera implementado, quais arquivos serao tocados e riscos identificados
+5. Confirme o plano com o dev antes de executar em tasks complexas
+6. Implemente seguindo os critérios de aceitação da task
+7. Ao concluir: marque como done, mova para \`tasks/done.md\`, atualize \`INDEX.md\`
+8. Se decisão arquitetural tomada: registre em \`architecture.md\`
 
 ### Modo 2 — Bug
 Acionado por: "erro", "bug", "quebrou", "não funciona"
-1. Crie hotfix em \`tasks/active.md\` com tag [H] e prioridade crítica
-2. Identifique e resolva a causa raiz
-3. Registre causa raiz em \`changelog.md\`
-4. Verifique se o bug afeta outras tasks em \`tasks/active.md\`
+1. PLANEJAR: descreva o que sera investigado e quais arquivos serao tocados
+2. Crie hotfix em \`tasks/active.md\` com tag [H] e prioridade crítica
+3. Identifique e resolva a causa raiz
+4. Registre causa raiz em \`changelog.md\`
+5. Verifique se o bug afeta outras tasks em \`tasks/active.md\`
 
 ### Modo 3 — Nova demanda
 Acionado por: "cliente pediu", "adiciona", "quero incluir" (fora do spec)
@@ -362,6 +383,11 @@ Acionado por: "como deve funcionar", "o que foi combinado", "qual o comportament
 1. Leia \`.spec/requirements.md\`
 2. Responda com base no spec — não invente comportamento
 
+## Context7 — Documentação atualizada
+Sempre que for usar uma lib do projeto, consulte a documentação atualizada via Context7 antes de implementar.
+Nunca assuma que você conhece a API mais recente — sempre verifique.
+Libs deste projeto: ${libs}
+
 ## Regras globais
 Leia \`.vireum/rules.md\` — aplicam-se a todas as sessões.
 
@@ -394,10 +420,19 @@ function gerarAgentsMd(d) {
 2. Identifique o modo pela solicitação
 3. Siga o protocolo em CLAUDE.md
 
+## Planejamento obrigatorio
+Antes de qualquer implementacao:
+1. Escreva o que sera feito e quais arquivos serao tocados
+2. Identifique riscos e dependencias
+3. Confirme com o dev em tasks complexas antes de executar
+
+## Context7
+Sempre consultar docs atualizadas via Context7 antes de usar qualquer lib.
+
 ## Regras globais
 Ver \`.vireum/rules.md\`
 
-## Regras do projeto  
+## Regras do projeto
 Ver \`.spec/rules.md\`
 
 ## Stack
@@ -421,9 +456,19 @@ Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
 - Sempre leia \`.spec/INDEX.md\` primeiro
 - Carregue outros arquivos de spec apenas quando necessário
 
+## Planejamento obrigatorio
+Antes de qualquer implementacao:
+- Escreva o que sera feito e quais arquivos serao tocados
+- Identifique riscos e dependencias
+- Confirme com o dev em tasks complexas antes de executar
+
+## Context7
+- Sempre consultar Context7 antes de usar qualquer lib do projeto
+- Nunca assumir que conhece a API mais recente
+
 ## Modos
-- Implementar → leia tasks/active.md, siga critérios de aceitação
-- Bug → crie hotfix [H] em active.md, registre causa raiz em changelog.md  
+- Implementar → PLANEJAR primeiro, consulte Context7, leia tasks/active.md, siga critérios de aceitação
+- Bug → PLANEJAR investigacao, crie hotfix [H] em active.md, registre causa raiz em changelog.md
 - Nova demanda → crie [PENDING] em backlog.md, aguarde aprovação
 - Dúvida de escopo → consulte requirements.md
 
@@ -431,6 +476,7 @@ Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
 - Ver \`.vireum/rules.md\` — regras globais
 - Ver \`.spec/rules.md\` — regras do projeto
 - Nunca implementar fora do spec sem [PENDING] aprovado
+- Nunca implementar sem planejar primeiro
 - Nunca marcar done sem critérios validados
 `;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vireum-spec-cli",
-  "version": "0.2.1",
+  "version": "0.3.1",
   "description": "Spec Driven Development framework by Vireum Desenvolvimento",
   "main": "dist/index.js",
   "bin": {

package/src/skills/task-implement.md

@@ -2,13 +2,27 @@
 
 Quando o dev pedir para implementar uma task:
 
+## 1. Antes de implementar — PLANEJAR
+Escreva um plano antes de qualquer codigo:
+- O que sera implementado
+- Quais arquivos serao criados ou modificados
+- Dependencias ou riscos identificados
+- Confirme com o dev se o plano faz sentido antes de continuar
+
+## 2. Consultar contexto
 1. Leia `.spec/tasks/active.md` e identifique a task solicitada
 2. Leia `.spec/requirements.md` para contexto da feature
-3. Leia `.spec/architecture.md` para decisões técnicas já tomadas
-4. Verifique os critérios de aceitação da task antes de começar
-5. Implemente seguindo a camada definida (Backend / Frontend / Integração)
-6. Ao concluir:
-   - Marque o status como [x] em active.md
-   - Mova a task para tasks/done.md
-   - Atualize o INDEX.md
-   - Se tomou decisão arquitetural, registre em architecture.md
+3. Leia `.spec/architecture.md` para decisoes tecnicas ja tomadas
+4. Consulte Context7 para docs atualizadas da lib que vai usar
+5. Verifique os criterios de aceitacao da task
+
+## 3. Implementar
+- Siga a camada definida (Backend / Frontend / Integracao)
+- Siga as decisoes de stack do architecture.md
+- Nao instale libs novas sem registrar em architecture.md
+
+## 4. Ao concluir
+- Marque o status como [x] em active.md
+- Mova a task para tasks/done.md
+- Atualize o INDEX.md
+- Se tomou decisao arquitetural, registre em architecture.md com justificativa