context-first-cli 2.3.2 → 2.3.5

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.
@@ -1,194 +0,0 @@
1
- # Criação de Pull Request
2
-
3
- Este comando cria Pull Requests para todos os repositórios modificados no workspace.
4
-
5
- ## 📋 Pré-requisitos
6
-
7
- Antes de criar PRs, certifique-se de que:
8
- - Executou `/pre-pr` e todas as validações passaram
9
- - Todos os commits foram feitos
10
- - Todos os testes estão passando
11
- - A documentação está atualizada
12
-
13
- ## Configuração
14
-
15
- Leia `context-manifest.json` e `ai.properties.md` do orchestrator para obter repositórios, base_path e task_management_system.
16
-
17
- ## 🛑 CRÍTICO: ONDE TRABALHAR
18
-
19
- **⚠️ ATENÇÃO: Se precisar fazer ajustes de última hora, TODO CÓDIGO DEVE SER CRIADO DENTRO DO WORKTREE!**
20
-
21
- **✅ CORRETO** - Trabalhar dentro do worktree:
22
- ```
23
- <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts ✅
24
- <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/README.md ✅
25
- <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/CHANGELOG.md ✅
26
- ```
27
-
28
- **❌ ERRADO** - NUNCA criar código fora do worktree:
29
- ```
30
- <orchestrator>/.sessions/file.ts ❌
31
- <orchestrator>/.sessions/<ISSUE-ID>/file.ts ❌
32
- {base_path}/<repo-name>/file.ts ❌ (repositório principal!)
33
- ```
34
-
35
- **REGRA ABSOLUTA**:
36
- - 🛑 **Qualquer ajuste de código** (docs, changelog, fixes) **DEVE estar em** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
37
- - 🛑 **NUNCA modifique** o repositório principal em `{base_path}/<repo-name>/`
38
- - ✅ **Trabalhe APENAS** dentro do worktree do repositório específico
39
-
40
- ## 🎯 Processo de Criação de PRs
41
-
42
- ### 1. Identificar Repositórios Modificados
43
-
44
- Para cada repositório no workspace, verifique:
45
- ```bash
46
- cd <repositório>
47
- git status
48
- git log origin/main..HEAD # Ver commits não pushados
49
- ```
50
-
51
- ### 2. Push das Branches
52
-
53
- Para cada repositório modificado:
54
- ```bash
55
- cd <repositório>
56
- git push origin <branch-name>
57
- ```
58
-
59
- ### 3. Criar Pull Requests
60
-
61
- Para cada repositório, crie um PR usando o GitHub CLI ou interface web:
62
-
63
- **Usando GitHub CLI**:
64
- ```bash
65
- cd <repositório>
66
- gh pr create --title "[ISSUE-ID] Título da Feature" \
67
- --body "$(cat ../.sessions/<ISSUE-ID>/pr-description.md)" \
68
- --base main
69
- ```
70
-
71
- **Template de Descrição do PR**:
72
-
73
- ```markdown
74
- ## 🎯 Objetivo
75
-
76
- [Breve descrição do que esta PR faz]
77
-
78
- ## 📝 Mudanças
79
-
80
- ### Repositório: <nome-do-repo>
81
-
82
- - [Mudança 1]
83
- - [Mudança 2]
84
- - [Mudança 3]
85
-
86
- ## 🔗 Relacionamentos
87
-
88
- - **Issue**: <ISSUE-ID>
89
- - **PRs Relacionados**:
90
- - <repo-1>#<PR-number>
91
- - <repo-2>#<PR-number>
92
-
93
- ## ✅ Checklist
94
-
95
- - [ ] Código implementado e testado
96
- - [ ] Testes unitários adicionados/atualizados
97
- - [ ] Testes de integração passando
98
- - [ ] Documentação atualizada
99
- - [ ] Sem breaking changes (ou documentados)
100
- - [ ] Revisado por pares (após criação do PR)
101
-
102
- ## 🧪 Como Testar
103
-
104
- 1. [Passo 1]
105
- 2. [Passo 2]
106
- 3. [Resultado esperado]
107
-
108
- ## 📸 Screenshots/Demos
109
-
110
- [Se aplicável, adicione screenshots ou links para demos]
111
-
112
- ## 🔍 Notas para Revisores
113
-
114
- - [Ponto de atenção 1]
115
- - [Ponto de atenção 2]
116
- ```
117
-
118
- ### 4. Vincular PRs
119
-
120
- Se houver múltiplos PRs (um por repositório):
121
- - Adicione links cruzados entre os PRs
122
- - Documente a ordem de merge recomendada
123
- - Indique dependências entre PRs
124
-
125
- ### 5. Atualizar Issue no Task Manager
126
-
127
- Se task manager estiver configurado:
128
- - Mova a issue para "Em Revisão" ou "PR Aberto"
129
- - Adicione links dos PRs na issue
130
- - Adicione comentário com resumo das mudanças
131
-
132
- ### 6. Documentação da Sessão
133
-
134
- Atualize `./.sessions/<ISSUE-ID>/pr.md`:
135
-
136
- ```markdown
137
- # [Título da Feature] - Pull Requests
138
-
139
- ## PRs Criados
140
-
141
- ### <repo-1>
142
- - **Link**: <URL do PR>
143
- - **Status**: Aberto
144
- - **Commits**: X commits
145
-
146
- ### <repo-2>
147
- - **Link**: <URL do PR>
148
- - **Status**: Aberto
149
- - **Commits**: Y commits
150
-
151
- ## Ordem de Merge Recomendada
152
-
153
- 1. <repo-1> - [Justificativa]
154
- 2. <repo-2> - [Justificativa]
155
-
156
- ## Notas para Merge
157
-
158
- - [Nota importante 1]
159
- - [Nota importante 2]
160
- ```
161
-
162
- ## 🔍 Checklist Final
163
-
164
- Antes de solicitar revisão:
165
- - [ ] Todos os PRs criados
166
- - [ ] Descrições completas e claras
167
- - [ ] PRs vinculados entre si
168
- - [ ] Issue atualizada no task manager
169
- - [ ] Testes passando em CI/CD
170
- - [ ] Documentação da sessão completa
171
-
172
- ## 📢 Comunicação
173
-
174
- Notifique o time sobre os PRs:
175
- - Mencione revisores relevantes
176
- - Destaque mudanças críticas ou breaking changes
177
- - Indique urgência se aplicável
178
-
179
- ---
180
-
181
- **Argumentos fornecidos**:
182
-
183
- ```
184
- #$ARGUMENTS
185
- ```
186
-
187
- ---
188
-
189
- ## 🎯 Próximos Passos
190
-
191
- 1. Aguardar revisão dos PRs
192
- 2. Responder comentários e fazer ajustes
193
- 3. Após aprovação, fazer merge na ordem recomendada
194
- 4. Executar `context-cli feature:end <ISSUE-ID>` para limpar o workspace
@@ -1,325 +0,0 @@
1
- # Preparação para Pull Request
2
-
3
- Este comando valida que tudo está pronto para criar Pull Requests.
4
-
5
- ## 📋 Pré-requisitos
6
-
7
- - Implementação completa (todas as tarefas do `/plan` executadas)
8
- - Todos os commits realizados
9
- - Workspace limpo e organizado
10
-
11
- ## Configuração
12
-
13
- Leia `context-manifest.json` e `ai.properties.md` do orchestrator para obter repositórios, base_path e task_management_system.
14
-
15
- ## 🎯 Objetivo
16
-
17
- Garantir que a implementação está completa, testada e pronta para revisão antes de criar os PRs.
18
-
19
- ## 🛑 CRÍTICO: ONDE TRABALHAR
20
-
21
- **⚠️ ATENÇÃO: TODO CÓDIGO (testes, fixes, ajustes) DEVE SER CRIADO DENTRO DO WORKTREE!**
22
-
23
- **✅ CORRETO** - Trabalhar dentro do worktree:
24
- ```
25
- <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts ✅
26
- <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/tests/test.ts ✅
27
- <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/.eslintrc.js ✅
28
- ```
29
-
30
- **❌ ERRADO** - NUNCA criar código fora do worktree:
31
- ```
32
- <orchestrator>/.sessions/test.ts ❌
33
- <orchestrator>/.sessions/<ISSUE-ID>/test.ts ❌
34
- {base_path}/<repo-name>/test.ts ❌ (repositório principal!)
35
- ```
36
-
37
- **REGRA ABSOLUTA**:
38
- - 🛑 **TODO código** (testes, fixes, configurações) **DEVE estar em** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
39
- - 🛑 **NUNCA modifique** o repositório principal em `{base_path}/<repo-name>/`
40
- - ✅ **Trabalhe APENAS** dentro do worktree do repositório específico
41
-
42
- ## ✅ Checklist de Validação
43
-
44
- ### 1. Completude da Implementação
45
-
46
- ```markdown
47
- ## Verificação de Completude
48
-
49
- - [ ] Todas as tarefas do plano foram executadas
50
- - [ ] Todos os requisitos funcionais do PRD foram implementados
51
- - [ ] Todos os critérios de aceitação foram atendidos
52
- - [ ] Nenhuma funcionalidade ficou pela metade
53
- ```
54
-
55
- ### 2. Qualidade do Código
56
-
57
- Para cada repositório modificado:
58
-
59
- ```bash
60
- cd <repositório>
61
-
62
- # Verificar status
63
- git status
64
-
65
- # Verificar linting (exemplos por stack):
66
- # Node.js: npm run lint / yarn lint / pnpm lint
67
- # Python: flake8 . / pylint src/ / black --check .
68
- # Java: mvn checkstyle:check / gradle check
69
- # Go: golangci-lint run / go vet ./...
70
- # Ruby: rubocop
71
- # Rust: cargo clippy
72
- # PHP: ./vendor/bin/phpcs
73
- # C#: dotnet format --verify-no-changes
74
-
75
- # Verificar formatação (exemplos por stack):
76
- # Node.js: npm run format:check / prettier --check .
77
- # Python: black --check . / autopep8 --diff .
78
- # Java: mvn formatter:validate
79
- # Go: gofmt -l . / go fmt ./...
80
- # Ruby: rubocop --format-only
81
- # Rust: cargo fmt --check
82
-
83
- # Verificar build (exemplos por stack):
84
- # Node.js: npm run build / yarn build
85
- # Python: python setup.py build
86
- # Java: mvn compile / gradle build
87
- # Go: go build ./...
88
- # Ruby: rake build
89
- # Rust: cargo build
90
- ```
91
-
92
- Checklist:
93
- ```markdown
94
- ## Qualidade do Código
95
-
96
- ### <repo-1>
97
- - [ ] Linting sem erros
98
- - [ ] Formatação correta
99
- - [ ] Build sem erros
100
- - [ ] Sem warnings críticos
101
-
102
- ### <repo-2>
103
- - [ ] Linting sem erros
104
- - [ ] Formatação correta
105
- - [ ] Build sem erros
106
- - [ ] Sem warnings críticos
107
- ```
108
-
109
- ### 3. Testes
110
-
111
- Para cada repositório:
112
-
113
- ```bash
114
- cd <repositório>
115
-
116
- # Executar testes unitários (exemplos por stack):
117
- # Node.js: npm run test:unit / jest / vitest
118
- # Python: pytest tests/unit / python -m unittest
119
- # Java: mvn test / gradle test
120
- # Go: go test ./... -short
121
- # Ruby: rspec spec/unit / rake test:unit
122
- # Rust: cargo test --lib
123
- # PHP: ./vendor/bin/phpunit --testsuite=unit
124
- # C#: dotnet test --filter Category=Unit
125
-
126
- # Executar testes de integração (exemplos por stack):
127
- # Node.js: npm run test:integration
128
- # Python: pytest tests/integration
129
- # Java: mvn verify / gradle integrationTest
130
- # Go: go test ./... -run Integration
131
- # Ruby: rspec spec/integration
132
- # Rust: cargo test --test '*'
133
- # PHP: ./vendor/bin/phpunit --testsuite=integration
134
-
135
- # Verificar cobertura (exemplos por stack):
136
- # Node.js: npm run test:coverage / jest --coverage
137
- # Python: pytest --cov=src tests/
138
- # Java: mvn jacoco:report / gradle jacocoTestReport
139
- # Go: go test -cover ./...
140
- # Ruby: rspec --coverage
141
- # Rust: cargo tarpaulin
142
- # PHP: ./vendor/bin/phpunit --coverage-html coverage/
143
- ```
144
-
145
- Checklist:
146
- ```markdown
147
- ## Testes
148
-
149
- ### <repo-1>
150
- - [ ] Todos os testes unitários passando
151
- - [ ] Todos os testes de integração passando
152
- - [ ] Cobertura de testes adequada (>= X%)
153
- - [ ] Novos testes adicionados para novas funcionalidades
154
-
155
- ### <repo-2>
156
- - [ ] Todos os testes unitários passando
157
- - [ ] Todos os testes de integração passando
158
- - [ ] Cobertura de testes adequada (>= X%)
159
- - [ ] Novos testes adicionados para novas funcionalidades
160
- ```
161
-
162
- ### 4. Documentação
163
-
164
- ```markdown
165
- ## Documentação
166
-
167
- - [ ] README atualizado (se necessário)
168
- - [ ] Comentários de código adequados
169
- - [ ] Documentação de APIs atualizada (se houver mudanças)
170
- - [ ] Changelog atualizado
171
- - [ ] Documentação técnica atualizada nas metaspecs (se aplicável)
172
- ```
173
-
174
- ### 5. Commits
175
-
176
- ```markdown
177
- ## Commits
178
-
179
- - [ ] Todos os commits têm mensagens claras e descritivas
180
- - [ ] Commits seguem o padrão do projeto (conventional commits, etc.)
181
- - [ ] Não há commits com mensagens genéricas ("fix", "update", etc.)
182
- - [ ] Commits estão organizados logicamente
183
- - [ ] Não há commits de debug ou temporários
184
- ```
185
-
186
- ### 6. Sincronização
187
-
188
- ```markdown
189
- ## Sincronização
190
-
191
- - [ ] Branches estão atualizadas com a branch base (main/develop)
192
- - [ ] Não há conflitos de merge
193
- - [ ] Mudanças entre repositórios estão sincronizadas
194
- - [ ] Dependências entre repos foram testadas
195
- ```
196
-
197
- ### 7. Segurança
198
-
199
- ```markdown
200
- ## Segurança
201
-
202
- - [ ] Não há credenciais ou secrets no código
203
- - [ ] Não há dados sensíveis em logs
204
- - [ ] Dependências de segurança foram verificadas
205
- - [ ] Não há vulnerabilidades conhecidas introduzidas
206
- ```
207
-
208
- ### 8. Performance
209
-
210
- ```markdown
211
- ## Performance
212
-
213
- - [ ] Não há regressões de performance óbvias
214
- - [ ] Queries/operações custosas foram otimizadas
215
- - [ ] Não há memory leaks introduzidos
216
- - [ ] Requisitos de performance do PRD foram atendidos
217
- ```
218
-
219
- ## 🔍 Validação Cruzada
220
-
221
- Se múltiplos repositórios foram modificados:
222
-
223
- ```markdown
224
- ## Validação Cruzada
225
-
226
- - [ ] Testei a integração entre os repositórios localmente
227
- - [ ] APIs/contratos entre repos estão consistentes
228
- - [ ] Não há breaking changes não documentados
229
- - [ ] Ordem de deploy/merge está clara
230
- ```
231
-
232
- ## 📄 Preparação da Descrição do PR
233
-
234
- Crie `./.sessions/<ISSUE-ID>/pr-description.md`:
235
-
236
- ```markdown
237
- ## 🎯 Objetivo
238
- [Breve descrição do que esta feature faz]
239
-
240
- ## 📝 Mudanças Principais
241
- - [Mudança 1]
242
- - [Mudança 2]
243
- - [Mudança 3]
244
-
245
- ## 🔗 Links
246
- - **Issue**: [ISSUE-ID]
247
- - **PRD**: [link ou caminho]
248
- - **Plano Técnico**: [link ou caminho]
249
-
250
- ## ✅ Checklist
251
- - [x] Código implementado e testado
252
- - [x] Testes unitários adicionados/atualizados
253
- - [x] Testes de integração passando
254
- - [x] Documentação atualizada
255
- - [x] Linting e formatação OK
256
- - [x] Build sem erros
257
-
258
- ## 🧪 Como Testar
259
- 1. [Passo 1]
260
- 2. [Passo 2]
261
- 3. [Resultado esperado]
262
-
263
- ## 🔍 Notas para Revisores
264
- - [Ponto de atenção 1]
265
- - [Ponto de atenção 2]
266
- ```
267
-
268
- ## 🚨 Problemas Encontrados
269
-
270
- Se alguma validação falhar:
271
- 1. 🛑 **PARE** o processo de criação de PR
272
- 2. 📝 **DOCUMENTE** o problema
273
- 3. 🔧 **CORRIJA** o problema
274
- 4. 🔄 **EXECUTE** `/pre-pr` novamente
275
-
276
- ## 📊 Relatório de Validação
277
-
278
- Crie `./.sessions/<ISSUE-ID>/pre-pr-report.md`:
279
-
280
- ```markdown
281
- # Relatório de Validação Pre-PR
282
-
283
- **Data**: [data/hora]
284
- **Issue**: [ISSUE-ID]
285
-
286
- ## Status Geral
287
- ✅ Pronto para PR / ⚠️ Pendências / ❌ Bloqueado
288
-
289
- ## Repositórios Validados
290
- - **<repo-1>**: ✅ OK
291
- - **<repo-2>**: ✅ OK
292
-
293
- ## Resumo de Testes
294
- - **Testes Unitários**: X/X passando
295
- - **Testes de Integração**: Y/Y passando
296
- - **Cobertura**: Z%
297
-
298
- ## Pendências (se houver)
299
- - [Pendência 1]
300
- - [Pendência 2]
301
-
302
- ## Próximos Passos
303
- - [x] Todas as validações passaram
304
- - [ ] Executar `/pr` para criar Pull Requests
305
- ```
306
-
307
- ---
308
-
309
- **Argumentos fornecidos**:
310
-
311
- ```
312
- #$ARGUMENTS
313
- ```
314
-
315
- ---
316
-
317
- ## 🎯 Próximo Passo
318
-
319
- Se todas as validações passaram:
320
-
321
- ```bash
322
- /pr
323
- ```
324
-
325
- Este comando criará os Pull Requests para todos os repositórios modificados.