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.
- package/dist/commands/setup.js +31 -9
- package/package.json +1 -1
- package/src/skills/task-implement.md +22 -8
package/dist/commands/setup.js
CHANGED
|
@@ -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.
|
|
355
|
-
5.
|
|
356
|
-
6.
|
|
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.
|
|
361
|
-
2.
|
|
362
|
-
3.
|
|
363
|
-
4.
|
|
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,
|
|
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
|
@@ -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
|
|
8
|
-
4.
|
|
9
|
-
5.
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
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
|