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.
- package/README.md +156 -148
- package/bin/cli.js +52 -52
- package/lib/init.js +89 -89
- package/package.json +11 -4
- package/templates/.ai/memory/napkin.md +68 -68
- package/templates/.github/agents/backend-coder.md +215 -215
- package/templates/.github/agents/db-coder.md +165 -165
- package/templates/.github/agents/doc-writer.md +48 -51
- package/templates/.github/agents/frontend-coder.md +222 -222
- package/templates/.github/agents/infra-coder.md +341 -341
- package/templates/.github/agents/reviewer.md +99 -99
- package/templates/.github/agents/security-reviewer.md +153 -153
- package/templates/.github/copilot-instructions.md +194 -175
- package/templates/.github/instructions/docs.instructions.md +123 -123
- package/templates/.github/instructions/sensitive-files.instructions.md +32 -32
- package/templates/{docs/Desenvolvimento → .github}/rules.md +229 -229
- package/templates/.github/skills/sf-design/SKILL.md +180 -181
- package/templates/.github/skills/sf-dev/SKILL.md +349 -349
- package/templates/.github/skills/sf-discovery/SKILL.md +405 -405
- package/templates/.github/skills/sf-extract/SKILL.md +284 -284
- package/templates/.github/skills/sf-feature/SKILL.md +130 -130
- package/templates/.github/skills/sf-merge-delta/SKILL.md +145 -142
- package/templates/.github/skills/sf-plan/SKILL.md +178 -178
- package/templates/.github/skills/sf-session-finish/SKILL.md +120 -120
- package/templates/.github/skills/sf-setup-projeto/SKILL.md +123 -123
- package/templates/{docs/_templates/estrutura/API.template.md → .github/templates/estrutura/apiContracts.template.md} +151 -144
- package/templates/.github/templates/estrutura/architecture.template.md +158 -0
- package/templates/{docs/_templates/estrutura/Seguranca.template.md → .github/templates/estrutura/conventions.template.md} +202 -138
- package/templates/{docs/_templates/estrutura/ADRs.template.md → .github/templates/estrutura/decisions.template.md} +99 -91
- package/templates/.github/templates/estrutura/domain.template.md +148 -0
- package/templates/{docs/_templates → .github/templates}/feature/PRD.template.md +256 -256
- package/templates/{docs/_templates → .github/templates}/feature/Progresso.template.md +136 -136
- package/templates/{docs/_templates → .github/templates}/feature/TRD.template.md +204 -200
- package/templates/{docs/_templates → .github/templates}/feature/backlog-extraido.template.md +154 -154
- package/templates/{docs/_templates → .github/templates}/feature/context.template.md +42 -42
- package/templates/{docs/_templates → .github/templates}/feature/extract-log.template.md +38 -38
- package/templates/{docs/_templates → .github/templates}/feature/projetos.template.yaml +73 -73
- package/templates/{docs/_templates → .github/templates}/feature/sdd.template.md +372 -372
- package/templates/{docs/_templates → .github/templates}/feature/tasks.template.md +115 -115
- package/templates/{docs/_templates → .github/templates}/global/progresso_global.template.md +57 -57
- package/templates/docs/_templates/estrutura/Arquitetura.template.md +0 -82
- package/templates/docs/_templates/estrutura/Infraestrutura.template.md +0 -104
- package/templates/docs/_templates/estrutura/Modelo_Dados.template.md +0 -99
- package/templates/docs/_templates/estrutura/Stack.template.md +0 -78
- package/templates/docs/_templates/estrutura/Visao.template.md +0 -82
- /package/templates/docs/{Desenvolvimento/.gitkeep → .gitkeep} +0 -0
- /package/templates/{docs/Estrutura → workspace/Input}/.gitkeep +0 -0
- /package/templates/{docs/PM → workspace/Input/setup_projeto}/.gitkeep +0 -0
- /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
|
|
135
|
-
- [ ] Atualizar `
|
|
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
|