spec-first-copilot 0.5.0-beta.3 → 0.5.0-beta.4

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 (6) hide show
  1. package/lib/init.js +2 -2
  2. package/package.json +1 -1
  3. package/templates/.github/copilot-instructions.md +4 -5
  4. package/templates/.github/skills/sf-new-project/SKILL.md +128 -0
  5. package/templates/.github/skills/sf-setup-projeto/SKILL.md +0 -123
  6. package/templates/workspace/Input/setup_projeto/.gitkeep +0 -0
package/lib/init.js CHANGED
@@ -62,8 +62,8 @@ function init({ name, templatesDir, targetDir }) {
62
62
  console.log(`\nDone! Project "${name}" is ready.`);
63
63
  console.log('\nNext steps:');
64
64
  console.log(` 1. cd ${name}`);
65
- console.log(' 2. Add your input files to workspace/Input/setup_projeto/');
66
- console.log(' 3. Run /sf-setup-projeto to start the pipeline');
65
+ console.log(' 2. Create a folder in workspace/Input/ with your project files (e.g. workspace/Input/my_app/)');
66
+ console.log(' 3. Run /sf-new-project <folder-name> to start the pipeline');
67
67
  console.log('');
68
68
  }
69
69
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "spec-first-copilot",
3
- "version": "0.5.0-beta.3",
3
+ "version": "0.5.0-beta.4",
4
4
  "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
5
5
  "bin": {
6
6
  "spec-first-copilot": "bin/cli.js"
package/templates/.github/copilot-instructions.md CHANGED
@@ -24,7 +24,7 @@ Verificar que TODAS as 9 skills estão acessíveis:
24
24
 
25
25
  | Skill | Caminho |
26
26
  |-------|---------|
27
- | `/sf-setup-projeto` | `.github/skills/sf-setup-projeto/SKILL.md` |
27
+ | `/sf-new-project` | `.github/skills/sf-new-project/SKILL.md` |
28
28
  | `/sf-feature` | `.github/skills/sf-feature/SKILL.md` |
29
29
  | `/sf-extract` | `.github/skills/sf-extract/SKILL.md` |
30
30
  | `/sf-design` | `.github/skills/sf-design/SKILL.md` |
@@ -77,7 +77,7 @@ Nenhum código é escrito sem especificação aprovada (SDD).
77
77
 
78
78
  ```
79
79
  workspace/Input/ (qualquer arquivo)
80
- ↓ /sf-setup-projeto (uma vez) ou /sf-feature (por feature)
80
+ ↓ /sf-new-project <nome> (TRD — bootstrap técnico) ou /sf-feature <nome> (PRD — feature)
81
81
  /sf-discovery → análise profunda dos insumos (RECOMENDADO, opcional)
82
82
  ↓
83
83
  /sf-extract → PRD ou TRD em workspace/Output/{nome}/ (checkpoint — usuário revisa e aprova)
@@ -94,7 +94,7 @@ workspace/Input/ (qualquer arquivo)
94
94
 
95
95
  | Skill | Tipo | O que faz |
96
96
  |-------|------|-----------|
97
- | `/sf-setup-projeto` | Orquestrador | Bootstrap: cria .context.md, chama /sf-extract, para no checkpoint. Roda UMA vez |
97
+ | `/sf-new-project <nome>` | Orquestrador | Bootstrap técnico: cria .context.md tipo TRD, chama /sf-extract, para no checkpoint |
98
98
  | `/sf-feature <nome>` | Orquestrador | Feature: cria .context.md tipo PRD, chama /sf-extract, para no checkpoint |
99
99
  | `/sf-extract <nome>` | Atômica | Lê workspace/Input/{nome}/ → gera PRD ou TRD. Re-executável para novos insumos |
100
100
  | `/sf-design <nome>` | Atômica | Pergunta aprovação → gera SDD a partir do PRD/TRD |
@@ -168,8 +168,7 @@ specs/ ← AGENT CONTRACTS (projeções do SDD pro coder)
168
168
 
169
169
  workspace/ ← TEAM CONTENT (futuro wiki)
170
170
  ├── Input/ ← Insumos brutos (QUALQUER formato — nunca modificar)
171
- │ ├── setup_projeto/ ← Insumos de bootstrap
172
- │ └── feat_*/ ← Insumos por feature
171
+ │ └── {nome}/ ← Nomeado livremente pelo usuário (ex: app_barbearia, feat_login)
173
172
  └── Output/ ← Artefatos humanos gerados pelo workflow
174
173
  └── {nome}/
175
174
  ├── PRD.md ou TRD.md ← Requirements (gerado pelo /sf-extract)
package/templates/.github/skills/sf-new-project/SKILL.md ADDED
@@ -0,0 +1,128 @@
1
+ ---
2
+ name: sf-new-project
3
+ description: |
4
+ Bootstrap técnico do projeto. Recebe nome do scope no Input, cria contexto TRD,
5
+ chama /sf-extract, para no checkpoint.
6
+ Trigger: /sf-new-project <nome>
7
+ author: GustavoMaritan
8
+ version: 2.0.0
9
+ date: 2026-04-12
10
+ ---
11
+
12
+ # Skill: /sf-new-project <nome>
13
+
14
+ > Orquestrador de bootstrap técnico do projeto.
15
+ > Cria contexto TRD a partir dos insumos em `workspace/Input/{nome}/`,
16
+ > chama `/sf-extract` e para no checkpoint de aprovação.
17
+ >
18
+ > Simétrico ao `/sf-feature <nome>` — a diferença é que gera TRD (perfil técnico)
19
+ > em vez de PRD (perfil de produto).
20
+
21
+ ## Tipo
22
+ Orquestrador (primeira etapa do pipeline)
23
+
24
+ ## Uso
25
+ ```
26
+ /sf-new-project <nome>
27
+ ```
28
+
29
+ `<nome>` = nome da pasta no Input. O usuário nomeia livremente
30
+ (ex: `app_barbearia`, `meu_sistema`, `api_pagamentos`).
31
+
32
+ ## Pré-condições
33
+
34
+ | # | Validação | Se falhar |
35
+ |---|-----------|-----------|
36
+ | 1 | `workspace/Input/{nome}/` existe | Parar → "Crie a pasta workspace/Input/{nome}/ e adicione seus insumos" |
37
+ | 2 | Pasta contém pelo menos 1 arquivo (ignorar .gitkeep) | Parar → "Adicione insumos na pasta (aceitos: .md, .txt, .sql, .xml, .html, .json, .csv, .png, .jpg, .pdf — qualquer formato)" |
38
+ | 3 | `workspace/Output/{nome}/.context.md` não existe ou status é `not_started` | Parar → "Este escopo já está em andamento. Verifique o status em .context.md" |
39
+
40
+ ## Passos
41
+
42
+ ### 1. Criar estrutura
43
+ ```
44
+ workspace/Output/{nome}/
45
+ ├── .context.md ← criado agora
46
+ └── (TRD.md será criado pelo /sf-extract)
47
+ ```
48
+
49
+ ### 2. Criar `.context.md`
50
+ ```yaml
51
+ ---
52
+ nome: "{nome}"
53
+ tipo: "project"
54
+ documento: "TRD"
55
+ pm_path: "workspace/Input/{nome}/"
56
+ status: "not_started"
57
+ ultima_skill: "/sf-new-project"
58
+ atualizado_em: "{{ISO_DATETIME}}"
59
+ ---
60
+ ```
61
+
62
+ ### 3. Sugerir /sf-discovery (RECOMENDADO)
63
+
64
+ Antes de extrair, perguntar ao usuário:
65
+ ```
66
+ Insumos encontrados em workspace/Input/{nome}/.
67
+
68
+ Recomendo rodar /sf-discovery antes da extração para:
69
+ - Análise profunda dos insumos (parseia drawio, XML, SQL completo)
70
+ - Identificar gaps e contradições antes de estruturar
71
+ - Validar entendimento com você (mapa do sistema)
72
+
73
+ Quer rodar /sf-discovery workspace/Input/{nome}/ agora? (s/n)
74
+ Se SIM → rodar discovery, salvar discovery.md, depois continuar com extract
75
+ Se NÃO → pular direto para /sf-extract (ok para insumos simples)
76
+ ```
77
+
78
+ Se o usuário aceitar:
79
+ - Rodar `/sf-discovery workspace/Input/{nome}/`
80
+ - Aguardar conclusão — discovery.md salvo em `workspace/Output/{nome}/`
81
+ - Continuar para o passo 4
82
+
83
+ ### 4. Chamar `/sf-extract {nome}`
84
+ O `/sf-extract` lê os insumos + discovery.md (se existir), gera o TRD e atualiza status para `extract_done`.
85
+
86
+ ### 5. CHECKPOINT — Parar e informar o usuário
87
+ Mensagem ao usuário:
88
+ ```
89
+ TRD gerado em workspace/Output/{nome}/TRD.md
90
+
91
+ Revise o documento. Quando estiver satisfeito, execute:
92
+ /sf-design {nome}
93
+
94
+ Se precisar adicionar mais insumos, coloque na pasta workspace/Input/{nome}/
95
+ e execute:
96
+ /sf-extract {nome}
97
+ ```
98
+
99
+ **O orquestrador encerra aqui.** O restante do pipeline é responsabilidade do usuário chamar as skills atômicas na ordem:
100
+ 1. `/sf-design {nome}` (pergunta aprovação → gera SDD + docs/ + projetos.yaml)
101
+ 2. `/sf-plan {nome}` (gera tasks com campo Repo por task)
102
+ 3. `/sf-dev {nome}` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
103
+
104
+ ## Saídas diretas desta skill
105
+ - `workspace/Output/{nome}/.context.md`
106
+ - `workspace/Output/{nome}/TRD.md` (via /sf-extract)
107
+ - `workspace/Output/{nome}/.extract-log.md` (via /sf-extract)
108
+
109
+ ## Saídas indiretas (skills subsequentes)
110
+ - `sdd.md` (via /sf-design)
111
+ - `projetos.yaml` (via /sf-design — manifesto de repos)
112
+ - `docs/` populado (via /sf-design)
113
+ - `specs/{nome}/tasks.md` + `Progresso.md` (via /sf-plan)
114
+ - `projetos/` com repos criados/clonados (via /sf-dev INFRA-001)
115
+
116
+ ## Erros
117
+
118
+ | Erro | Ação |
119
+ |------|------|
120
+ | workspace/Input/{nome}/ não existe | Parar, instruir criação |
121
+ | workspace/Input/{nome}/ vazio | Parar, listar formatos aceitos |
122
+ | Pipeline já iniciado | Parar, mostrar status atual do .context.md |
123
+
124
+ ## Notas
125
+ - docs/ é gerado pelo /sf-design (passo 3), não por tasks DOC
126
+ - `projetos.yaml` é gerado pelo /sf-design (passo 3b) — mapeia serviços para repos
127
+ - Repos são criados/clonados pelo /sf-dev (INFRA-001) dentro de `projetos/`
128
+ - O `/sf-merge-delta` NÃO se aplica ao new-project (é criação, não atualização)
package/templates/.github/skills/sf-setup-projeto/SKILL.md DELETED
@@ -1,123 +0,0 @@
1
- ---
2
- name: sf-setup-projeto
3
- description: |
4
- Bootstrap do projeto. Cria contexto TRD, chama /sf-extract, para no checkpoint.
5
- Trigger: /sf-setup-projeto
6
- author: GustavoMaritan
7
- version: 1.0.0
8
- date: 2026-04-08
9
- ---
10
-
11
- # Skill: /sf-setup-projeto
12
-
13
- > Orquestrador de bootstrap do projeto. Executa uma única vez.
14
- > Cria contexto TRD, chama `/extract` e para no checkpoint de aprovação.
15
-
16
- ## Tipo
17
- Orquestrador (primeira etapa do pipeline)
18
-
19
- ## Uso
20
- ```
21
- /sf-setup-projeto
22
- ```
23
-
24
- ## Pré-condições
25
-
26
- | # | Validação | Se falhar |
27
- |---|-----------|-----------|
28
- | 1 | `workspace/Input/setup_projeto/` existe | Parar → "Crie a pasta workspace/Input/setup_projeto/ e adicione seus insumos" |
29
- | 2 | Pasta contém pelo menos 1 arquivo (ignorar .gitkeep) | Parar → "Adicione insumos na pasta (aceitos: .md, .txt, .sql, .xml, .html, .json, .csv, .png, .jpg, .pdf — qualquer formato)" |
30
- | 3 | `docs/` está vazio ou contém apenas templates vazios | Parar → "Setup já foi executado. Use /sf-feature para novas funcionalidades" |
31
- | 4 | `workspace/Output/setup_projeto/.context.md` não existe ou status é `not_started` | Parar → "Setup já está em andamento. Verifique o status em .context.md" |
32
-
33
- ## Passos
34
-
35
- ### 1. Criar estrutura
36
- ```
37
- workspace/Output/setup_projeto/
38
- ├── .context.md ← criado agora
39
- └── (TRD.md será criado pelo /extract)
40
- ```
41
-
42
- ### 2. Criar `.context.md`
43
- ```yaml
44
- ---
45
- nome: "setup_projeto"
46
- tipo: "setup"
47
- documento: "TRD"
48
- pm_path: "workspace/Input/setup_projeto/"
49
- status: "not_started"
50
- ultima_skill: "/sf-setup-projeto"
51
- atualizado_em: "{{ISO_DATETIME}}"
52
- ---
53
- ```
54
-
55
- ### 3. Sugerir /sf-discovery (RECOMENDADO)
56
-
57
- Antes de extrair, perguntar ao usuário:
58
- ```
59
- 📋 Insumos encontrados em workspace/Input/setup_projeto/.
60
-
61
- Recomendo rodar /sf-discovery antes da extração para:
62
- - Análise profunda dos insumos (parseia drawio, XML, SQL completo)
63
- - Identificar gaps e contradições antes de estruturar
64
- - Validar entendimento com você (mapa do sistema)
65
-
66
- Quer rodar /sf-discovery workspace/Input/setup_projeto/ agora? (s/n)
67
- Se SIM → rodar discovery, salvar discovery.md, depois continuar com extract
68
- Se NÃO → pular direto para /sf-extract (ok para insumos simples)
69
- ```
70
-
71
- Se o usuário aceitar:
72
- - Rodar `/sf-discovery workspace/Input/setup_projeto/`
73
- - Aguardar conclusão — discovery.md salvo em `workspace/Output/setup_projeto/`
74
- - Continuar para o passo 4
75
-
76
- ### 4. Chamar `/sf-extract setup_projeto`
77
- O `/sf-extract` lê os insumos + discovery.md (se existir), gera o TRD e atualiza status para `extract_done`.
78
-
79
- ### 5. CHECKPOINT — Parar e informar o usuário
80
- Mensagem ao usuário:
81
- ```
82
- ✅ TRD gerado em workspace/Output/setup_projeto/TRD.md
83
-
84
- Revise o documento. Quando estiver satisfeito, execute:
85
- /sf-design setup_projeto
86
-
87
- Se precisar adicionar mais insumos, coloque na pasta workspace/Input/setup_projeto/
88
- e execute:
89
- /sf-extract setup_projeto
90
- ```
91
-
92
- **O orquestrador encerra aqui.** O restante do pipeline é responsabilidade do usuário chamar as skills atômicas na ordem:
93
- 1. `/sf-design setup_projeto` (pergunta aprovação → gera SDD + docs/ + projetos.yaml)
94
- 2. `/sf-plan setup_projeto` (gera tasks com campo Repo por task)
95
- 3. `/sf-dev setup_projeto` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
96
-
97
- ## Saídas diretas desta skill
98
- - `workspace/Output/setup_projeto/.context.md`
99
- - `workspace/Output/setup_projeto/TRD.md` (via /extract)
100
- - `workspace/Output/setup_projeto/.extract-log.md` (via /extract)
101
-
102
- ## Saídas indiretas (skills subsequentes)
103
- - `sdd.md` (via /design)
104
- - `projetos.yaml` (via /sf-design — manifesto de repos)
105
- - `docs/` populado (via /design)
106
- - `specs/{nome}/tasks.md` + `Progresso.md` (via /plan)
107
- - `projetos/` com repos criados/clonados (via /sf-dev INFRA-001)
108
-
109
- ## Erros
110
-
111
- | Erro | Ação |
112
- |------|------|
113
- | workspace/Input/setup_projeto/ não existe | Parar, instruir criação |
114
- | workspace/Input/setup_projeto/ vazio | Parar, listar formatos aceitos |
115
- | docs/ já populado | Parar, sugerir /sf-feature |
116
- | Pipeline já iniciado | Parar, mostrar status atual do .context.md |
117
-
118
- ## Notas
119
- - Esta skill roda **uma única vez** por projeto
120
- - docs/ é gerado pelo /sf-design (passo 3), não por tasks DOC
121
- - `projetos.yaml` é gerado pelo /sf-design (passo 3b) — mapeia serviços para repos
122
- - Repos são criados/clonados pelo /sf-dev (INFRA-001) dentro de `projetos/`
123
- - O `/merge-delta` NÃO se aplica ao setup (é criação, não atualização)
package/templates/workspace/Input/setup_projeto/.gitkeep DELETED
File without changes