vireum-spec-cli 0.3.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -276,6 +276,11 @@ function gerarRulesGlobal() {
276
276
  - Nunca puxar task do backlog para active sem validação humana explícita
277
277
  - Sempre avisar escopo creep antes de implementar — parar e perguntar
278
278
 
279
+ ## Regras de Planejamento
280
+ - Sempre planejar antes de implementar — escrever o que sera feito e quais arquivos serao tocados
281
+ - Confirmar o plano com o dev em tasks complexas antes de executar
282
+ - Nunca comecar a escrever codigo sem ter um plano claro
283
+
279
284
  ## Regras de Spec
280
285
  - Nunca marcar task como done sem validar os critérios de aceitação
281
286
  - Nunca tomar decisão de arquitetura sem registrar em architecture.md com justificativa
@@ -294,6 +299,7 @@ function gerarRulesGlobal() {
294
299
 
295
300
  ## Nunca
296
301
  - Implementar sem ler o spec primeiro
302
+ - Implementar sem planejar primeiro
297
303
  - Tomar decisão de lib ou stack sem documentar o porquê
298
304
  - Responder dúvida de escopo sem consultar requirements.md
299
305
  - Comunicar diretamente com o cliente — isso é papel do dev
@@ -351,16 +357,19 @@ Acionado por: "desenvolve", "implementa", "cria", + nome de task
351
357
  1. Leia \`.spec/tasks/active.md\`
352
358
  2. Leia \`.spec/requirements.md\` para contexto da feature
353
359
  3. Consulte o Context7 para docs atualizadas da lib que vai usar
354
- 4. Implemente seguindo os critérios de aceitação da task
355
- 5. Ao concluir: marque como done, mova para \`tasks/done.md\`, atualize \`INDEX.md\`
356
- 6. Se decisão arquitetural tomada: registre em \`architecture.md\`
360
+ 4. PLANEJAR: escreva o que sera implementado, quais arquivos serao tocados e riscos identificados
361
+ 5. Confirme o plano com o dev antes de executar em tasks complexas
362
+ 6. Implemente seguindo os critérios de aceitação da task
363
+ 7. Ao concluir: marque como done, mova para \`tasks/done.md\`, atualize \`INDEX.md\`
364
+ 8. Se decisão arquitetural tomada: registre em \`architecture.md\`
357
365
 
358
366
  ### Modo 2 — Bug
359
367
  Acionado por: "erro", "bug", "quebrou", "não funciona"
360
- 1. Crie hotfix em \`tasks/active.md\` com tag [H] e prioridade crítica
361
- 2. Identifique e resolva a causa raiz
362
- 3. Registre causa raiz em \`changelog.md\`
363
- 4. Verifique se o bug afeta outras tasks em \`tasks/active.md\`
368
+ 1. PLANEJAR: descreva o que sera investigado e quais arquivos serao tocados
369
+ 2. Crie hotfix em \`tasks/active.md\` com tag [H] e prioridade crítica
370
+ 3. Identifique e resolva a causa raiz
371
+ 4. Registre causa raiz em \`changelog.md\`
372
+ 5. Verifique se o bug afeta outras tasks em \`tasks/active.md\`
364
373
 
365
374
  ### Modo 3 — Nova demanda
366
375
  Acionado por: "cliente pediu", "adiciona", "quero incluir" (fora do spec)
@@ -411,6 +420,12 @@ function gerarAgentsMd(d) {
411
420
  2. Identifique o modo pela solicitação
412
421
  3. Siga o protocolo em CLAUDE.md
413
422
 
423
+ ## Planejamento obrigatorio
424
+ Antes de qualquer implementacao:
425
+ 1. Escreva o que sera feito e quais arquivos serao tocados
426
+ 2. Identifique riscos e dependencias
427
+ 3. Confirme com o dev em tasks complexas antes de executar
428
+
414
429
  ## Context7
415
430
  Sempre consultar docs atualizadas via Context7 antes de usar qualquer lib.
416
431
 
@@ -441,13 +456,19 @@ Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
441
456
  - Sempre leia \`.spec/INDEX.md\` primeiro
442
457
  - Carregue outros arquivos de spec apenas quando necessário
443
458
 
459
+ ## Planejamento obrigatorio
460
+ Antes de qualquer implementacao:
461
+ - Escreva o que sera feito e quais arquivos serao tocados
462
+ - Identifique riscos e dependencias
463
+ - Confirme com o dev em tasks complexas antes de executar
464
+
444
465
  ## Context7
445
466
  - Sempre consultar Context7 antes de usar qualquer lib do projeto
446
467
  - Nunca assumir que conhece a API mais recente
447
468
 
448
469
  ## Modos
449
- - Implementar → leia tasks/active.md, consulte Context7, siga critérios de aceitação
450
- - Bug → crie hotfix [H] em active.md, registre causa raiz em changelog.md
470
+ - Implementar → PLANEJAR primeiro, consulte Context7, leia tasks/active.md, siga critérios de aceitação
471
+ - Bug → PLANEJAR investigacao, crie hotfix [H] em active.md, registre causa raiz em changelog.md
451
472
  - Nova demanda → crie [PENDING] em backlog.md, aguarde aprovação
452
473
  - Dúvida de escopo → consulte requirements.md
453
474
 
@@ -455,6 +476,7 @@ Este projeto usa Spec Driven Development pela Vireum Desenvolvimento.
455
476
  - Ver \`.vireum/rules.md\` — regras globais
456
477
  - Ver \`.spec/rules.md\` — regras do projeto
457
478
  - Nunca implementar fora do spec sem [PENDING] aprovado
479
+ - Nunca implementar sem planejar primeiro
458
480
  - Nunca marcar done sem critérios validados
459
481
  `;
460
482
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "vireum-spec-cli",
3
- "version": "0.3.0",
3
+ "version": "0.3.1",
4
4
  "description": "Spec Driven Development framework by Vireum Desenvolvimento",
5
5
  "main": "dist/index.js",
6
6
  "bin": {
@@ -2,13 +2,27 @@
2
2
 
3
3
  Quando o dev pedir para implementar uma task:
4
4
 
5
+ ## 1. Antes de implementar — PLANEJAR
6
+ Escreva um plano antes de qualquer codigo:
7
+ - O que sera implementado
8
+ - Quais arquivos serao criados ou modificados
9
+ - Dependencias ou riscos identificados
10
+ - Confirme com o dev se o plano faz sentido antes de continuar
11
+
12
+ ## 2. Consultar contexto
5
13
  1. Leia `.spec/tasks/active.md` e identifique a task solicitada
6
14
  2. Leia `.spec/requirements.md` para contexto da feature
7
- 3. Leia `.spec/architecture.md` para decisões técnicas tomadas
8
- 4. Verifique os critérios de aceitação da task antes de começar
9
- 5. Implemente seguindo a camada definida (Backend / Frontend / Integração)
10
- 6. Ao concluir:
11
- - Marque o status como [x] em active.md
12
- - Mova a task para tasks/done.md
13
- - Atualize o INDEX.md
14
- - Se tomou decisão arquitetural, registre em architecture.md
15
+ 3. Leia `.spec/architecture.md` para decisoes tecnicas ja tomadas
16
+ 4. Consulte Context7 para docs atualizadas da lib que vai usar
17
+ 5. Verifique os criterios de aceitacao da task
18
+
19
+ ## 3. Implementar
20
+ - Siga a camada definida (Backend / Frontend / Integracao)
21
+ - Siga as decisoes de stack do architecture.md
22
+ - Nao instale libs novas sem registrar em architecture.md
23
+
24
+ ## 4. Ao concluir
25
+ - Marque o status como [x] em active.md
26
+ - Mova a task para tasks/done.md
27
+ - Atualize o INDEX.md
28
+ - Se tomou decisao arquitetural, registre em architecture.md com justificativa