context-first-cli 1.6.0 → 1.6.1

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 (7) hide show
  1. package/dist/templates/commands/engineer/plan.md +25 -0
  2. package/dist/templates/commands/engineer/start.md +24 -0
  3. package/dist/templates/commands/engineer/work.md +46 -3
  4. package/package.json +1 -1
  5. package/templates/commands/engineer/plan.md +25 -0
  6. package/templates/commands/engineer/start.md +24 -0
  7. package/templates/commands/engineer/work.md +46 -3
package/dist/templates/commands/engineer/plan.md CHANGED
@@ -8,6 +8,31 @@ Este comando cria o plano técnico detalhado para implementação da feature.
8
8
  - Análise inicial feita via `/start`
9
9
  - Arquivos `context.md` e `architecture.md` criados e aprovados
10
10
 
11
+ ## 📍 IMPORTANTE: Entenda a Estrutura
12
+
13
+ **Workspace**:
14
+ ```
15
+ <orchestrator>/.sessions/<ISSUE-ID>/
16
+ ├── repo-1/ # worktree (será usado no /work)
17
+ ├── repo-2/ # worktree (será usado no /work)
18
+ ├── context.md # contexto (imutável - LER)
19
+ ├── architecture.md # arquitetura (imutável - LER)
20
+ └── plan.md # plano (mutável - CRIAR)
21
+ ```
22
+
23
+ **Repositórios principais** (apenas leitura):
24
+ ```
25
+ {base_path}/repo-1/ # repo principal (branch main/master)
26
+ {base_path}/repo-2/ # repo principal (branch main/master)
27
+ ```
28
+
29
+ **REGRA DE OURO**:
30
+ - ✅ Leia `context.md` e `architecture.md` (imutáveis)
31
+ - ✅ Crie `plan.md` em `.sessions/<ISSUE-ID>/`
32
+ - ✅ Leia código dos repositórios principais (read-only)
33
+ - ❌ NUNCA faça checkout nos repositórios principais
34
+ - ❌ NUNCA modifique `context.md` ou `architecture.md`
35
+
11
36
  ## ⚠️ IMPORTANTE: Arquivos Imutáveis
12
37
 
13
38
  **Este comando deve LER mas NÃO MODIFICAR:**
package/dist/templates/commands/engineer/start.md CHANGED
@@ -2,6 +2,30 @@
2
2
 
3
3
  Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
4
4
 
5
+ ## 📍 IMPORTANTE: Entenda a Estrutura
6
+
7
+ **Workspace** (onde você trabalhará):
8
+ ```
9
+ <orchestrator>/.sessions/<ISSUE-ID>/
10
+ ├── repo-1/ # worktree com branch feature/<ISSUE-ID>
11
+ ├── repo-2/ # worktree com branch feature/<ISSUE-ID>
12
+ ├── context.md # contexto (imutável - criado por este comando)
13
+ ├── architecture.md # arquitetura (imutável - criado por este comando)
14
+ └── plan.md # plano (mutável - criado por /plan)
15
+ ```
16
+
17
+ **Repositórios principais** (apenas leitura):
18
+ ```
19
+ {base_path}/repo-1/ # repo principal (branch main/master)
20
+ {base_path}/repo-2/ # repo principal (branch main/master)
21
+ ```
22
+
23
+ **REGRA DE OURO**:
24
+ - ✅ Leia metaspecs e código dos repositórios principais (read-only)
25
+ - ✅ Crie `context.md` e `architecture.md` em `.sessions/<ISSUE-ID>/`
26
+ - ❌ NUNCA faça checkout nos repositórios principais
27
+ - ❌ NUNCA modifique código neste comando (use `/work` depois)
28
+
5
29
  ## 📚 Carregar MetaSpecs
6
30
 
7
31
  **Localizar MetaSpecs automaticamente**:
package/dist/templates/commands/engineer/work.md CHANGED
@@ -6,12 +6,36 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
6
6
 
7
7
  Antes de executar, certifique-se de que:
8
8
  - Executou `/start` e `/plan` para ter o planejamento técnico
9
- - Está no workspace correto (verifique `diretório do workspace`)
9
+ - Está no workspace correto: `<orchestrator>/.sessions/<ISSUE-ID>/`
10
10
  - Tem os arquivos `.sessions/<ISSUE-ID>/` disponíveis:
11
11
  - `context.md` (imutável)
12
12
  - `architecture.md` (imutável)
13
13
  - `plan.md` (mutável)
14
14
 
15
+ ## 📍 IMPORTANTE: Entenda a Estrutura
16
+
17
+ **Workspace** (onde você trabalha):
18
+ ```
19
+ <orchestrator>/.sessions/<ISSUE-ID>/
20
+ ├── repo-1/ # worktree com branch feature/<ISSUE-ID>
21
+ ├── repo-2/ # worktree com branch feature/<ISSUE-ID>
22
+ ├── context.md # contexto (imutável)
23
+ ├── architecture.md # arquitetura (imutável)
24
+ └── plan.md # plano (mutável)
25
+ ```
26
+
27
+ **Repositórios principais** (NÃO tocar):
28
+ ```
29
+ {base_path}/repo-1/ # repo principal (branch main/master)
30
+ {base_path}/repo-2/ # repo principal (branch main/master)
31
+ ```
32
+
33
+ **REGRA DE OURO**:
34
+ - ✅ Trabalhe APENAS dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
35
+ - ✅ Faça commits nos worktrees dentro do workspace
36
+ - ❌ NUNCA faça checkout nos repositórios principais
37
+ - ❌ NUNCA navegue para `{base_path}/{repo-id}/`
38
+
15
39
  ## ⚠️ IMPORTANTE: Arquivos Imutáveis
16
40
 
17
41
  **Este comando deve LER mas NÃO MODIFICAR:**
@@ -55,6 +79,20 @@ Com base no plano técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
55
79
 
56
80
  ### 2. Implementação
57
81
 
82
+ **IMPORTANTE**: Trabalhe APENAS dentro do workspace em `.sessions/<ISSUE-ID>/`
83
+
84
+ Para cada repositório no workspace:
85
+
86
+ ```bash
87
+ # Navegue para o worktree dentro do workspace
88
+ cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
89
+
90
+ # Verifique que está na branch correta
91
+ git branch # deve mostrar * feature/<ISSUE-ID>
92
+
93
+ # Implemente o código aqui
94
+ ```
95
+
58
96
  Execute a implementação seguindo:
59
97
  - **Padrões do projeto**: Consulte guias de estilo e arquitetura
60
98
  - **Stack aprovada**: Use apenas tecnologias documentadas nas metaspecs
@@ -70,11 +108,16 @@ Antes de commitar:
70
108
 
71
109
  ### 4. Commit
72
110
 
73
- Para cada repositório modificado:
111
+ Para cada repositório modificado **dentro do workspace**:
74
112
 
75
113
  ```bash
76
- cd <repositório>
114
+ # Navegue para o worktree dentro do workspace
115
+ cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
116
+
117
+ # Adicione as mudanças
77
118
  git add .
119
+
120
+ # Commit
78
121
  git commit -m "tipo: descrição concisa
79
122
 
80
123
  - Detalhe 1
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "context-first-cli",
3
- "version": "1.6.0",
3
+ "version": "1.6.1",
4
4
  "description": "A generic CLI to manage the Context-First development methodology across any project.",
5
5
  "main": "dist/index.js",
6
6
  "types": "dist/index.d.ts",
package/templates/commands/engineer/plan.md CHANGED
@@ -8,6 +8,31 @@ Este comando cria o plano técnico detalhado para implementação da feature.
8
8
  - Análise inicial feita via `/start`
9
9
  - Arquivos `context.md` e `architecture.md` criados e aprovados
10
10
 
11
+ ## 📍 IMPORTANTE: Entenda a Estrutura
12
+
13
+ **Workspace**:
14
+ ```
15
+ <orchestrator>/.sessions/<ISSUE-ID>/
16
+ ├── repo-1/ # worktree (será usado no /work)
17
+ ├── repo-2/ # worktree (será usado no /work)
18
+ ├── context.md # contexto (imutável - LER)
19
+ ├── architecture.md # arquitetura (imutável - LER)
20
+ └── plan.md # plano (mutável - CRIAR)
21
+ ```
22
+
23
+ **Repositórios principais** (apenas leitura):
24
+ ```
25
+ {base_path}/repo-1/ # repo principal (branch main/master)
26
+ {base_path}/repo-2/ # repo principal (branch main/master)
27
+ ```
28
+
29
+ **REGRA DE OURO**:
30
+ - ✅ Leia `context.md` e `architecture.md` (imutáveis)
31
+ - ✅ Crie `plan.md` em `.sessions/<ISSUE-ID>/`
32
+ - ✅ Leia código dos repositórios principais (read-only)
33
+ - ❌ NUNCA faça checkout nos repositórios principais
34
+ - ❌ NUNCA modifique `context.md` ou `architecture.md`
35
+
11
36
  ## ⚠️ IMPORTANTE: Arquivos Imutáveis
12
37
 
13
38
  **Este comando deve LER mas NÃO MODIFICAR:**
package/templates/commands/engineer/start.md CHANGED
@@ -2,6 +2,30 @@
2
2
 
3
3
  Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
4
4
 
5
+ ## 📍 IMPORTANTE: Entenda a Estrutura
6
+
7
+ **Workspace** (onde você trabalhará):
8
+ ```
9
+ <orchestrator>/.sessions/<ISSUE-ID>/
10
+ ├── repo-1/ # worktree com branch feature/<ISSUE-ID>
11
+ ├── repo-2/ # worktree com branch feature/<ISSUE-ID>
12
+ ├── context.md # contexto (imutável - criado por este comando)
13
+ ├── architecture.md # arquitetura (imutável - criado por este comando)
14
+ └── plan.md # plano (mutável - criado por /plan)
15
+ ```
16
+
17
+ **Repositórios principais** (apenas leitura):
18
+ ```
19
+ {base_path}/repo-1/ # repo principal (branch main/master)
20
+ {base_path}/repo-2/ # repo principal (branch main/master)
21
+ ```
22
+
23
+ **REGRA DE OURO**:
24
+ - ✅ Leia metaspecs e código dos repositórios principais (read-only)
25
+ - ✅ Crie `context.md` e `architecture.md` em `.sessions/<ISSUE-ID>/`
26
+ - ❌ NUNCA faça checkout nos repositórios principais
27
+ - ❌ NUNCA modifique código neste comando (use `/work` depois)
28
+
5
29
  ## 📚 Carregar MetaSpecs
6
30
 
7
31
  **Localizar MetaSpecs automaticamente**:
package/templates/commands/engineer/work.md CHANGED
@@ -6,12 +6,36 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
6
6
 
7
7
  Antes de executar, certifique-se de que:
8
8
  - Executou `/start` e `/plan` para ter o planejamento técnico
9
- - Está no workspace correto (verifique `diretório do workspace`)
9
+ - Está no workspace correto: `<orchestrator>/.sessions/<ISSUE-ID>/`
10
10
  - Tem os arquivos `.sessions/<ISSUE-ID>/` disponíveis:
11
11
  - `context.md` (imutável)
12
12
  - `architecture.md` (imutável)
13
13
  - `plan.md` (mutável)
14
14
 
15
+ ## 📍 IMPORTANTE: Entenda a Estrutura
16
+
17
+ **Workspace** (onde você trabalha):
18
+ ```
19
+ <orchestrator>/.sessions/<ISSUE-ID>/
20
+ ├── repo-1/ # worktree com branch feature/<ISSUE-ID>
21
+ ├── repo-2/ # worktree com branch feature/<ISSUE-ID>
22
+ ├── context.md # contexto (imutável)
23
+ ├── architecture.md # arquitetura (imutável)
24
+ └── plan.md # plano (mutável)
25
+ ```
26
+
27
+ **Repositórios principais** (NÃO tocar):
28
+ ```
29
+ {base_path}/repo-1/ # repo principal (branch main/master)
30
+ {base_path}/repo-2/ # repo principal (branch main/master)
31
+ ```
32
+
33
+ **REGRA DE OURO**:
34
+ - ✅ Trabalhe APENAS dentro de `<orchestrator>/.sessions/<ISSUE-ID>/`
35
+ - ✅ Faça commits nos worktrees dentro do workspace
36
+ - ❌ NUNCA faça checkout nos repositórios principais
37
+ - ❌ NUNCA navegue para `{base_path}/{repo-id}/`
38
+
15
39
  ## ⚠️ IMPORTANTE: Arquivos Imutáveis
16
40
 
17
41
  **Este comando deve LER mas NÃO MODIFICAR:**
@@ -55,6 +79,20 @@ Com base no plano técnico (`./.sessions/<ISSUE-ID>/plan.md`), identifique:
55
79
 
56
80
  ### 2. Implementação
57
81
 
82
+ **IMPORTANTE**: Trabalhe APENAS dentro do workspace em `.sessions/<ISSUE-ID>/`
83
+
84
+ Para cada repositório no workspace:
85
+
86
+ ```bash
87
+ # Navegue para o worktree dentro do workspace
88
+ cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
89
+
90
+ # Verifique que está na branch correta
91
+ git branch # deve mostrar * feature/<ISSUE-ID>
92
+
93
+ # Implemente o código aqui
94
+ ```
95
+
58
96
  Execute a implementação seguindo:
59
97
  - **Padrões do projeto**: Consulte guias de estilo e arquitetura
60
98
  - **Stack aprovada**: Use apenas tecnologias documentadas nas metaspecs
@@ -70,11 +108,16 @@ Antes de commitar:
70
108
 
71
109
  ### 4. Commit
72
110
 
73
- Para cada repositório modificado:
111
+ Para cada repositório modificado **dentro do workspace**:
74
112
 
75
113
  ```bash
76
- cd <repositório>
114
+ # Navegue para o worktree dentro do workspace
115
+ cd <orchestrator>/.sessions/<ISSUE-ID>/<repo-name>/
116
+
117
+ # Adicione as mudanças
77
118
  git add .
119
+
120
+ # Commit
78
121
  git commit -m "tipo: descrição concisa
79
122
 
80
123
  - Detalhe 1