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,78 +0,0 @@
|
|
|
1
|
-
# Stack Tecnológica
|
|
2
|
-
|
|
3
|
-
> Tecnologias escolhidas, versões fixadas, e alternativas descartadas com justificativa.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
<!--
|
|
8
|
-
=============================================================================
|
|
9
|
-
INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
|
|
10
|
-
=============================================================================
|
|
11
|
-
|
|
12
|
-
ORIGEM: Gerado pelo /setup-projeto a partir do TRD §2.
|
|
13
|
-
ATUALIZAÇÃO: /merge-delta quando features introduzem novas tecnologias ou mudanças de stack (raro — deve gerar ADR).
|
|
14
|
-
|
|
15
|
-
COMO GERAR:
|
|
16
|
-
1. Ler TRD §2 (Stack e Tecnologias) — todas decisões de tech
|
|
17
|
-
2. Preencher TODAS as camadas, mesmo que "a definir"
|
|
18
|
-
3. Para cada tecnologia: versão EXATA (não "latest")
|
|
19
|
-
4. Justificativa deve ser técnica, não "é popular"
|
|
20
|
-
5. Alternativas descartadas: documentar POR QUE foram rejeitadas (evita rediscussão)
|
|
21
|
-
|
|
22
|
-
REGRAS:
|
|
23
|
-
- Versões devem ser fixadas (ex: "18.3.1", não "^18.0.0")
|
|
24
|
-
- Cada biblioteca/pacote precisa de justificativa (evita bloat)
|
|
25
|
-
- Alternativas descartadas previnem que o time rediscuta decisões já tomadas
|
|
26
|
-
- Mudanças de stack DEVEM gerar ADR em ADRs.md
|
|
27
|
-
- Camadas são dinâmicas — adicionar conforme necessidade (mobile, infra, etc.)
|
|
28
|
-
|
|
29
|
-
=============================================================================
|
|
30
|
-
-->
|
|
31
|
-
|
|
32
|
-
## Stack Principal
|
|
33
|
-
|
|
34
|
-
| Camada | Tecnologia | Versão | Justificativa |
|
|
35
|
-
|--------|-----------|--------|---------------|
|
|
36
|
-
| Frontend | | | |
|
|
37
|
-
| Backend | | | |
|
|
38
|
-
| Banco de Dados | | | |
|
|
39
|
-
| ORM/Query Builder | | | |
|
|
40
|
-
| Autenticação | | | |
|
|
41
|
-
| Testes | | | |
|
|
42
|
-
| CI/CD | | | |
|
|
43
|
-
|
|
44
|
-
<!-- Adicionar camadas conforme necessidade: Mobile, Cache, Fila, Monitoramento, etc. -->
|
|
45
|
-
|
|
46
|
-
## Bibliotecas e Dependências
|
|
47
|
-
|
|
48
|
-
<!-- Repetir seção para cada camada que tenha dependências relevantes -->
|
|
49
|
-
|
|
50
|
-
### {{Camada}}
|
|
51
|
-
|
|
52
|
-
| Pacote | Versão | Para quê | Alternativa descartada |
|
|
53
|
-
|--------|--------|----------|----------------------|
|
|
54
|
-
| | | | |
|
|
55
|
-
|
|
56
|
-
## Alternativas Descartadas
|
|
57
|
-
|
|
58
|
-
> Decisões já tomadas. Se alguém perguntar "por que não usamos X?", a resposta está aqui.
|
|
59
|
-
|
|
60
|
-
| Tecnologia escolhida | Alternativa considerada | Por que descartamos | Ref ADR |
|
|
61
|
-
|----------------------|------------------------|---------------------|---------|
|
|
62
|
-
| | | | |
|
|
63
|
-
|
|
64
|
-
## Convenções de Versionamento
|
|
65
|
-
|
|
66
|
-
| Aspecto | Convenção |
|
|
67
|
-
|---------|-----------|
|
|
68
|
-
| Versionamento | <!-- Semver? Pinned? --> |
|
|
69
|
-
| Lock files | <!-- package-lock.json? yarn.lock? --> |
|
|
70
|
-
| Atualização | <!-- Dependabot? Manual? Periodicidade? --> |
|
|
71
|
-
|
|
72
|
-
---
|
|
73
|
-
|
|
74
|
-
## Changelog
|
|
75
|
-
|
|
76
|
-
| Data | Feature | Tipo | Descrição |
|
|
77
|
-
|------|---------|------|-----------|
|
|
78
|
-
| | | | |
|
|
@@ -1,82 +0,0 @@
|
|
|
1
|
-
# Visão do Sistema
|
|
2
|
-
|
|
3
|
-
> C4 Nível 1 — Contexto do sistema: o que é, quem usa, com o que integra, quais restrições existem.
|
|
4
|
-
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
<!--
|
|
8
|
-
=============================================================================
|
|
9
|
-
INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
|
|
10
|
-
=============================================================================
|
|
11
|
-
|
|
12
|
-
ORIGEM: Gerado pelo /setup-projeto a partir do TRD §1.
|
|
13
|
-
ATUALIZAÇÃO: /merge-delta quando features alteram contexto global (novos atores, integrações, restrições).
|
|
14
|
-
|
|
15
|
-
COMO GERAR:
|
|
16
|
-
1. Ler TRD §1 (Visão do Sistema) — é a fonte primária
|
|
17
|
-
2. Ler TRD §8 (Módulos Planejados) — alimenta o Roadmap
|
|
18
|
-
3. Descrever o sistema em 2-3 frases objetivas (sem jargão de marketing)
|
|
19
|
-
4. Listar TODOS os atores e papéis mencionados nos insumos
|
|
20
|
-
5. Listar TODAS as integrações externas com direção clara
|
|
21
|
-
6. Glossário: termos de domínio que o time precisa compartilhar (DDD ubiquitous language)
|
|
22
|
-
|
|
23
|
-
REGRAS:
|
|
24
|
-
- Descrição do sistema deve responder: O QUE faz, PARA QUEM, QUAL PROBLEMA resolve
|
|
25
|
-
- Atores devem ter permissões gerais claras (o que pode E o que NÃO pode)
|
|
26
|
-
- Integrações devem ter direção explícita (envia/recebe/ambos)
|
|
27
|
-
- Glossário não é opcional — termos ambíguos geram bugs
|
|
28
|
-
|
|
29
|
-
=============================================================================
|
|
30
|
-
-->
|
|
31
|
-
|
|
32
|
-
## O que é este sistema?
|
|
33
|
-
|
|
34
|
-
<!-- Descrição em 2-3 frases. O que ele faz, para quem, qual problema resolve. -->
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
## Usuários e Papéis
|
|
38
|
-
|
|
39
|
-
| Papel | O que faz | O que NÃO pode fazer | Nível de acesso |
|
|
40
|
-
|-------|-----------|----------------------|-----------------|
|
|
41
|
-
| | | | |
|
|
42
|
-
|
|
43
|
-
## Integrações Externas
|
|
44
|
-
|
|
45
|
-
| Sistema/Serviço | Tipo (API/Webhook/Arquivo/Fila) | Direção (Envia/Recebe/Ambos) | Descrição | SLA/Disponibilidade |
|
|
46
|
-
|-----------------|--------------------------------|------------------------------|-----------|---------------------|
|
|
47
|
-
| | | | | |
|
|
48
|
-
|
|
49
|
-
## Restrições e Premissas
|
|
50
|
-
|
|
51
|
-
### Restrições técnicas
|
|
52
|
-
-
|
|
53
|
-
|
|
54
|
-
### Restrições de negócio
|
|
55
|
-
-
|
|
56
|
-
|
|
57
|
-
### Premissas
|
|
58
|
-
-
|
|
59
|
-
|
|
60
|
-
## Roadmap de Módulos
|
|
61
|
-
|
|
62
|
-
> Extraído do TRD §8. Visão de alto nível das funcionalidades planejadas.
|
|
63
|
-
|
|
64
|
-
| # | Módulo | Prioridade | Dependências | Status |
|
|
65
|
-
|---|--------|-----------|--------------|--------|
|
|
66
|
-
| | | | | planejado / em desenvolvimento / concluído |
|
|
67
|
-
|
|
68
|
-
## Glossário
|
|
69
|
-
|
|
70
|
-
> Termos do domínio usados em todo o projeto. Linguagem ubíqua (DDD).
|
|
71
|
-
|
|
72
|
-
| Termo | Definição | Exemplo de uso |
|
|
73
|
-
|-------|-----------|----------------|
|
|
74
|
-
| | | |
|
|
75
|
-
|
|
76
|
-
---
|
|
77
|
-
|
|
78
|
-
## Changelog
|
|
79
|
-
|
|
80
|
-
| Data | Feature | Tipo | Descrição |
|
|
81
|
-
|------|---------|------|-----------|
|
|
82
|
-
| | | | |
|
|
File without changes
|
|
File without changes
|
|
File without changes
|
|
File without changes
|