spec-first-copilot 0.4.0 → 0.5.0-beta.0

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.
Files changed (49) hide show
  1. package/README.md +156 -148
  2. package/bin/cli.js +52 -52
  3. package/lib/init.js +89 -89
  4. package/package.json +11 -4
  5. package/templates/.ai/memory/napkin.md +68 -68
  6. package/templates/.github/agents/backend-coder.md +215 -215
  7. package/templates/.github/agents/db-coder.md +165 -165
  8. package/templates/.github/agents/doc-writer.md +48 -51
  9. package/templates/.github/agents/frontend-coder.md +222 -222
  10. package/templates/.github/agents/infra-coder.md +341 -341
  11. package/templates/.github/agents/reviewer.md +99 -99
  12. package/templates/.github/agents/security-reviewer.md +153 -153
  13. package/templates/.github/copilot-instructions.md +194 -175
  14. package/templates/.github/instructions/docs.instructions.md +123 -123
  15. package/templates/.github/instructions/sensitive-files.instructions.md +32 -32
  16. package/templates/{docs/Desenvolvimento → .github}/rules.md +229 -229
  17. package/templates/.github/skills/sf-design/SKILL.md +180 -181
  18. package/templates/.github/skills/sf-dev/SKILL.md +349 -349
  19. package/templates/.github/skills/sf-discovery/SKILL.md +405 -405
  20. package/templates/.github/skills/sf-extract/SKILL.md +284 -284
  21. package/templates/.github/skills/sf-feature/SKILL.md +130 -130
  22. package/templates/.github/skills/sf-merge-delta/SKILL.md +145 -142
  23. package/templates/.github/skills/sf-plan/SKILL.md +178 -178
  24. package/templates/.github/skills/sf-session-finish/SKILL.md +120 -120
  25. package/templates/.github/skills/sf-setup-projeto/SKILL.md +123 -123
  26. package/templates/{docs/_templates/estrutura/API.template.md → .github/templates/estrutura/apiContracts.template.md} +151 -144
  27. package/templates/.github/templates/estrutura/architecture.template.md +158 -0
  28. package/templates/{docs/_templates/estrutura/Seguranca.template.md → .github/templates/estrutura/conventions.template.md} +202 -138
  29. package/templates/{docs/_templates/estrutura/ADRs.template.md → .github/templates/estrutura/decisions.template.md} +99 -91
  30. package/templates/.github/templates/estrutura/domain.template.md +148 -0
  31. package/templates/{docs/_templates → .github/templates}/feature/PRD.template.md +256 -256
  32. package/templates/{docs/_templates → .github/templates}/feature/Progresso.template.md +136 -136
  33. package/templates/{docs/_templates → .github/templates}/feature/TRD.template.md +204 -200
  34. package/templates/{docs/_templates → .github/templates}/feature/backlog-extraido.template.md +154 -154
  35. package/templates/{docs/_templates → .github/templates}/feature/context.template.md +42 -42
  36. package/templates/{docs/_templates → .github/templates}/feature/extract-log.template.md +38 -38
  37. package/templates/{docs/_templates → .github/templates}/feature/projetos.template.yaml +73 -73
  38. package/templates/{docs/_templates → .github/templates}/feature/sdd.template.md +372 -372
  39. package/templates/{docs/_templates → .github/templates}/feature/tasks.template.md +115 -115
  40. package/templates/{docs/_templates → .github/templates}/global/progresso_global.template.md +57 -57
  41. package/templates/docs/_templates/estrutura/Arquitetura.template.md +0 -82
  42. package/templates/docs/_templates/estrutura/Infraestrutura.template.md +0 -104
  43. package/templates/docs/_templates/estrutura/Modelo_Dados.template.md +0 -99
  44. package/templates/docs/_templates/estrutura/Stack.template.md +0 -78
  45. package/templates/docs/_templates/estrutura/Visao.template.md +0 -82
  46. /package/templates/docs/{Desenvolvimento/.gitkeep → .gitkeep} +0 -0
  47. /package/templates/{docs/Estrutura → workspace/Input}/.gitkeep +0 -0
  48. /package/templates/{docs/PM → workspace/Input/setup_projeto}/.gitkeep +0 -0
  49. /package/templates/{docs/PM/setup_projeto → workspace/Output}/.gitkeep +0 -0
@@ -1,136 +1,136 @@
1
- # Progresso — {{FEATURE}}
2
-
3
- > Visão consolidada do andamento da feature.
4
- > Organizado por **fases de entrega** — cada fase é um entregável independente.
5
- > Atualizado automaticamente pelo /dev a cada task concluída.
6
-
7
- ---
8
-
9
- ## Status Geral: `não iniciado`
10
-
11
- <!-- não iniciado → em desenvolvimento → em revisão → concluído → arquivado -->
12
-
13
- ---
14
-
15
- <!--
16
- =============================================================================
17
- INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
18
- =============================================================================
19
-
20
- COMO GERAR ESTE ARQUIVO:
21
-
22
- 1. Ler PRD §11 (Fases de Entrega) para definir as fases
23
- 2. Ler TODOS os *_tasks.md da feature
24
- 3. Para cada FASE DE ENTREGA, listar as áreas e contagem de tasks
25
- 4. A visão primária é POR FASE, não por área
26
-
27
- COMO ATUALIZAR:
28
-
29
- - O /dev atualiza após cada task concluída
30
- - Status por fase: ⬜ pendente → 🔄 em andamento → ✅ concluída
31
- - Fase concluída = todas tasks de todas áreas daquela fase estão [x]
32
- - Ao concluir uma fase: registrar no Histórico + abrir PR
33
-
34
- =============================================================================
35
- -->
36
-
37
- ## Fases de Entrega
38
-
39
- | Fase | Nome | Prioridade | Entregável | Status | Tasks |
40
- |------|------|-----------|------------|--------|-------|
41
- | 1 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
42
- | 2 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
43
- | 3 | {{Nome}} | P2 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
44
-
45
- ---
46
-
47
- ## Fase 1 — {{Nome}} [P1]
48
-
49
- > **Entregável**: {{O que o usuário pode usar}}
50
- > **Critério de done**: {{Testes E2E que devem passar}}
51
- > **Branch**: `feature/{{FEATURE}}_fase1`
52
- > **PR**: (a ser criado)
53
-
54
- ### Tasks por área
55
-
56
- #### {{AREA_1}} ({{N}} tasks)
57
-
58
- | Task | Descrição | Tamanho | Repo | Status |
59
- |------|-----------|---------|------|--------|
60
- | AREA-001 | | S/M/L | {{repo}} | ⬜ |
61
-
62
- #### {{AREA_2}} ({{N}} tasks)
63
-
64
- | Task | Descrição | Tamanho | Repo | Status |
65
- |------|-----------|---------|------|--------|
66
- | AREA-001 | | S/M/L | {{repo}} | ⬜ |
67
-
68
- ### Resumo Fase 1
69
-
70
- | Área | Total | Feitas | % |
71
- |------|-------|--------|---|
72
- | {{AREA_1}} | {{N}} | 0 | 0% |
73
- | {{AREA_2}} | {{N}} | 0 | 0% |
74
- | **Total Fase 1** | **{{N}}** | **0** | **0%** |
75
-
76
- ---
77
-
78
- ## Fase 2 — {{Nome}} [P1]
79
-
80
- > **Entregável**: {{...}}
81
- > **Depende de**: Fase 1 concluída
82
-
83
- <!-- Repetir mesma estrutura -->
84
-
85
- ---
86
-
87
- ## Totais Gerais
88
-
89
- | Fase | Total | Feitas | % |
90
- |------|-------|--------|---|
91
- | Fase 1 | {{N}} | 0 | 0% |
92
- | Fase 2 | {{N}} | 0 | 0% |
93
- | **Total** | **{{N}}** | **0** | **0%** |
94
-
95
- ---
96
-
97
- ## Ordem de Execução
98
-
99
- ```
100
- Fase 1:
101
- 1. INFRA (setup de repos/ambiente)
102
- 2. BANCO (schema/migrations)
103
- 3. BACK (endpoints) ← pode paralelizar com FRONT após BANCO
104
- 4. FRONT (telas)
105
- → PR Fase 1 + testes manuais + merge
106
-
107
- Fase 2:
108
- 1. BANCO (novas tabelas/migrations)
109
- 2. BACK (endpoints + regras)
110
- 3. FRONT (telas + integração)
111
- → PR Fase 2 + testes manuais + merge
112
- ```
113
-
114
- ---
115
-
116
- ## Histórico
117
-
118
- | Data | Evento | Detalhes |
119
- |------|--------|----------|
120
- | | Feature criada | PRD aprovado, SDD gerado |
121
-
122
- ---
123
-
124
- ## Pós-conclusão (por fase)
125
-
126
- - [ ] PR aberto com template detalhado
127
- - [ ] Ambiente local rodando para testes manuais
128
- - [ ] Testes automatizados passando (unit + integration + security)
129
- - [ ] Usuário aprovou e fez merge
130
-
131
- ## Pós-conclusão (feature completa)
132
-
133
- - [ ] Todas fases concluídas e mergeadas
134
- - [ ] Mergear Delta Specs (SDD §11) nos docs de `docs/Estrutura/`
135
- - [ ] Atualizar `docs/Desenvolvimento/progresso.md` (visão global)
136
- - [ ] Atualizar `.ai/memory/napkin.md` se houver aprendizado relevante
1
+ # Progresso — {{FEATURE}}
2
+
3
+ > Visão consolidada do andamento da feature.
4
+ > Organizado por **fases de entrega** — cada fase é um entregável independente.
5
+ > Atualizado automaticamente pelo /dev a cada task concluída.
6
+
7
+ ---
8
+
9
+ ## Status Geral: `não iniciado`
10
+
11
+ <!-- não iniciado → em desenvolvimento → em revisão → concluído → arquivado -->
12
+
13
+ ---
14
+
15
+ <!--
16
+ =============================================================================
17
+ INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
18
+ =============================================================================
19
+
20
+ COMO GERAR ESTE ARQUIVO:
21
+
22
+ 1. Ler PRD §11 (Fases de Entrega) para definir as fases
23
+ 2. Ler TODOS os *_tasks.md da feature
24
+ 3. Para cada FASE DE ENTREGA, listar as áreas e contagem de tasks
25
+ 4. A visão primária é POR FASE, não por área
26
+
27
+ COMO ATUALIZAR:
28
+
29
+ - O /dev atualiza após cada task concluída
30
+ - Status por fase: ⬜ pendente → 🔄 em andamento → ✅ concluída
31
+ - Fase concluída = todas tasks de todas áreas daquela fase estão [x]
32
+ - Ao concluir uma fase: registrar no Histórico + abrir PR
33
+
34
+ =============================================================================
35
+ -->
36
+
37
+ ## Fases de Entrega
38
+
39
+ | Fase | Nome | Prioridade | Entregável | Status | Tasks |
40
+ |------|------|-----------|------------|--------|-------|
41
+ | 1 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
42
+ | 2 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
43
+ | 3 | {{Nome}} | P2 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
44
+
45
+ ---
46
+
47
+ ## Fase 1 — {{Nome}} [P1]
48
+
49
+ > **Entregável**: {{O que o usuário pode usar}}
50
+ > **Critério de done**: {{Testes E2E que devem passar}}
51
+ > **Branch**: `feature/{{FEATURE}}_fase1`
52
+ > **PR**: (a ser criado)
53
+
54
+ ### Tasks por área
55
+
56
+ #### {{AREA_1}} ({{N}} tasks)
57
+
58
+ | Task | Descrição | Tamanho | Repo | Status |
59
+ |------|-----------|---------|------|--------|
60
+ | AREA-001 | | S/M/L | {{repo}} | ⬜ |
61
+
62
+ #### {{AREA_2}} ({{N}} tasks)
63
+
64
+ | Task | Descrição | Tamanho | Repo | Status |
65
+ |------|-----------|---------|------|--------|
66
+ | AREA-001 | | S/M/L | {{repo}} | ⬜ |
67
+
68
+ ### Resumo Fase 1
69
+
70
+ | Área | Total | Feitas | % |
71
+ |------|-------|--------|---|
72
+ | {{AREA_1}} | {{N}} | 0 | 0% |
73
+ | {{AREA_2}} | {{N}} | 0 | 0% |
74
+ | **Total Fase 1** | **{{N}}** | **0** | **0%** |
75
+
76
+ ---
77
+
78
+ ## Fase 2 — {{Nome}} [P1]
79
+
80
+ > **Entregável**: {{...}}
81
+ > **Depende de**: Fase 1 concluída
82
+
83
+ <!-- Repetir mesma estrutura -->
84
+
85
+ ---
86
+
87
+ ## Totais Gerais
88
+
89
+ | Fase | Total | Feitas | % |
90
+ |------|-------|--------|---|
91
+ | Fase 1 | {{N}} | 0 | 0% |
92
+ | Fase 2 | {{N}} | 0 | 0% |
93
+ | **Total** | **{{N}}** | **0** | **0%** |
94
+
95
+ ---
96
+
97
+ ## Ordem de Execução
98
+
99
+ ```
100
+ Fase 1:
101
+ 1. INFRA (setup de repos/ambiente)
102
+ 2. BANCO (schema/migrations)
103
+ 3. BACK (endpoints) ← pode paralelizar com FRONT após BANCO
104
+ 4. FRONT (telas)
105
+ → PR Fase 1 + testes manuais + merge
106
+
107
+ Fase 2:
108
+ 1. BANCO (novas tabelas/migrations)
109
+ 2. BACK (endpoints + regras)
110
+ 3. FRONT (telas + integração)
111
+ → PR Fase 2 + testes manuais + merge
112
+ ```
113
+
114
+ ---
115
+
116
+ ## Histórico
117
+
118
+ | Data | Evento | Detalhes |
119
+ |------|--------|----------|
120
+ | | Feature criada | PRD aprovado, SDD gerado |
121
+
122
+ ---
123
+
124
+ ## Pós-conclusão (por fase)
125
+
126
+ - [ ] PR aberto com template detalhado
127
+ - [ ] Ambiente local rodando para testes manuais
128
+ - [ ] Testes automatizados passando (unit + integration + security)
129
+ - [ ] Usuário aprovou e fez merge
130
+
131
+ ## Pós-conclusão (feature completa)
132
+
133
+ - [ ] Todas fases concluídas e mergeadas
134
+ - [ ] Mergear Delta Specs (SDD §11) nos docs de `docs/`
135
+ - [ ] Atualizar `workspace/Output/progresso.md` (visão global)
136
+ - [ ] Atualizar `.ai/memory/napkin.md` se houver aprendizado relevante