context-first-cli 2.1.4 → 2.1.6

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.
@@ -10,6 +10,29 @@ Antes de criar PRs, certifique-se de que:
10
10
  - Todos os testes estão passando
11
11
  - A documentação está atualizada
12
12
 
13
+ ## 🛑 CRÍTICO: ONDE TRABALHAR
14
+
15
+ **⚠️ ATENÇÃO: Se precisar fazer ajustes de última hora, TODO CÓDIGO DEVE SER CRIADO DENTRO DO WORKTREE!**
16
+
17
+ **✅ CORRETO** - Trabalhar dentro do worktree:
18
+ ```
19
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts ✅
20
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/README.md ✅
21
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/CHANGELOG.md ✅
22
+ ```
23
+
24
+ **❌ ERRADO** - NUNCA criar código fora do worktree:
25
+ ```
26
+ <orchestrator>/.sessions/file.ts ❌
27
+ <orchestrator>/.sessions/<ISSUE-ID>/file.ts ❌
28
+ {base_path}/<repo-name>/file.ts ❌ (repositório principal!)
29
+ ```
30
+
31
+ **REGRA ABSOLUTA**:
32
+ - 🛑 **Qualquer ajuste de código** (docs, changelog, fixes) **DEVE estar em** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
33
+ - 🛑 **NUNCA modifique** o repositório principal em `{base_path}/<repo-name>/`
34
+ - ✅ **Trabalhe APENAS** dentro do worktree do repositório específico
35
+
13
36
  ## 🎯 Processo de Criação de PRs
14
37
 
15
38
  ### 1. Identificar Repositórios Modificados
@@ -12,6 +12,29 @@ Este comando valida que tudo está pronto para criar Pull Requests.
12
12
 
13
13
  Garantir que a implementação está completa, testada e pronta para revisão antes de criar os PRs.
14
14
 
15
+ ## 🛑 CRÍTICO: ONDE TRABALHAR
16
+
17
+ **⚠️ ATENÇÃO: TODO CÓDIGO (testes, fixes, ajustes) DEVE SER CRIADO DENTRO DO WORKTREE!**
18
+
19
+ **✅ CORRETO** - Trabalhar dentro do worktree:
20
+ ```
21
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts ✅
22
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/tests/test.ts ✅
23
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/.eslintrc.js ✅
24
+ ```
25
+
26
+ **❌ ERRADO** - NUNCA criar código fora do worktree:
27
+ ```
28
+ <orchestrator>/.sessions/test.ts ❌
29
+ <orchestrator>/.sessions/<ISSUE-ID>/test.ts ❌
30
+ {base_path}/<repo-name>/test.ts ❌ (repositório principal!)
31
+ ```
32
+
33
+ **REGRA ABSOLUTA**:
34
+ - 🛑 **TODO código** (testes, fixes, configurações) **DEVE estar em** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
35
+ - 🛑 **NUNCA modifique** o repositório principal em `{base_path}/<repo-name>/`
36
+ - ✅ **Trabalhe APENAS** dentro do worktree do repositório específico
37
+
15
38
  ## ✅ Checklist de Validação
16
39
 
17
40
  ### 1. Completude da Implementação
@@ -36,16 +36,40 @@ Antes de executar, certifique-se de que:
36
36
  - ❌ NUNCA faça checkout nos repositórios principais
37
37
  - ❌ NUNCA navegue para `{base_path}/{repo-id}/`
38
38
 
39
+ ## 🛑 CRÍTICO: ONDE CRIAR CÓDIGO
40
+
41
+ **⚠️ ATENÇÃO: TODO CÓDIGO DEVE SER CRIADO DENTRO DO WORKTREE DO REPOSITÓRIO!**
42
+
43
+ **✅ CORRETO** - Criar código dentro do worktree:
44
+ ```
45
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/src/file.ts ✅
46
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/tests/test.ts ✅
47
+ <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/package.json ✅
48
+ ```
49
+
50
+ **❌ ERRADO** - NUNCA criar código diretamente em .sessions:
51
+ ```
52
+ <orchestrator>/.sessions/src/file.ts ❌
53
+ <orchestrator>/.sessions/<ISSUE-ID>/src/file.ts ❌
54
+ <orchestrator>/.sessions/<ISSUE-ID>/file.ts ❌
55
+ ```
56
+
57
+ **REGRA ABSOLUTA**:
58
+ - 🛑 **TODO arquivo de código** (`.ts`, `.js`, `.py`, `.java`, etc.) **DEVE estar dentro de** `<orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/`
59
+ - 🛑 **NUNCA crie código** diretamente em `<orchestrator>/.sessions/` ou `<orchestrator>/.sessions/<ISSUE-ID>/`
60
+ - ✅ **Único lugar válido**: Dentro do worktree do repositório específico
61
+
39
62
  ## ⚠️ IMPORTANTE: Arquivos Imutáveis
40
63
 
41
64
  **Este comando deve LER mas NÃO MODIFICAR:**
42
65
  - ✅ **LER** `.sessions/<ISSUE-ID>/context.md` (imutável)
43
66
  - ✅ **LER** `.sessions/<ISSUE-ID>/architecture.md` (imutável)
44
67
  - ✅ **ATUALIZAR** `.sessions/<ISSUE-ID>/plan.md` (marcar progresso)
45
- - ✅ **IMPLEMENTAR** código nos repositórios do workspace
46
- - ✅ **FAZER COMMITS** nos repositórios do workspace
68
+ - ✅ **IMPLEMENTAR** código **DENTRO DO WORKTREE**: `.sessions/<ISSUE-ID>/<repo-name>/`
69
+ - ✅ **FAZER COMMITS** nos worktrees: `.sessions/<ISSUE-ID>/<repo-name>/`
47
70
  - ❌ **NÃO modificar `context.md` ou `architecture.md`**
48
71
  - ❌ **NÃO fazer checkout de branches nos repositórios principais (fora do workspace)**
72
+ - 🛑 **NUNCA criar código em `.sessions/` ou `.sessions/<ISSUE-ID>/` diretamente**
49
73
 
50
74
  ## 📚 Carregar MetaSpecs
51
75