context-first-cli 1.5.7 → 1.5.8

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 (15) hide show
  1. package/dist/templates/commands/engineer/plan.md +13 -1
  2. package/dist/templates/commands/engineer/start.md +13 -2
  3. package/dist/templates/commands/engineer/work.md +12 -1
  4. package/dist/templates/commands/products/check.md +10 -2
  5. package/dist/templates/commands/products/collect.md +11 -3
  6. package/dist/templates/commands/products/refine.md +20 -7
  7. package/dist/templates/commands/products/spec.md +13 -1
  8. package/package.json +1 -1
  9. package/templates/commands/engineer/plan.md +13 -1
  10. package/templates/commands/engineer/start.md +13 -2
  11. package/templates/commands/engineer/work.md +12 -1
  12. package/templates/commands/products/check.md +10 -2
  13. package/templates/commands/products/collect.md +11 -3
  14. package/templates/commands/products/refine.md +20 -7
  15. package/templates/commands/products/spec.md +13 -1
package/dist/templates/commands/engineer/plan.md CHANGED
@@ -6,7 +6,19 @@ Este comando cria o plano técnico detalhado para implementação da feature.
6
6
 
7
7
  - PRD criado via `/spec`
8
8
  - Análise inicial feita via `/start`
9
- - Contexto técnico carregado
9
+
10
+ ## 📚 Carregar MetaSpecs
11
+
12
+ **Localizar MetaSpecs automaticamente**:
13
+ 1. Leia `context-manifest.json` do orchestrator
14
+ 2. Encontre o repositório com `"role": "metaspecs"`
15
+ 3. Leia `ai.properties.md` para obter o `base_path`
16
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
17
+ 5. Leia os arquivos `index.md` relevantes para garantir conformidade com:
18
+ - Arquitetura do sistema
19
+ - Padrões de design e código
20
+ - Estrutura de pastas e arquivos
21
+ - Convenções de nomenclatura
10
22
 
11
23
  ## 🎯 Objetivo
12
24
 
package/dist/templates/commands/engineer/start.md CHANGED
@@ -2,12 +2,23 @@
2
2
 
3
3
  Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
4
4
 
5
+ ## 📚 Carregar MetaSpecs
6
+
7
+ **Localizar MetaSpecs automaticamente**:
8
+ 1. Leia `context-manifest.json` do orchestrator
9
+ 2. Encontre o repositório com `"role": "metaspecs"`
10
+ 3. Leia `ai.properties.md` para obter o `base_path`
11
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
12
+ 5. Leia os arquivos `index.md` relevantes:
13
+ - Contexto de negócio
14
+ - Stack, arquitetura e padrões técnicos
15
+ - Convenções do projeto
16
+
5
17
  ## 🎯 Contexto do Projeto
6
18
 
7
19
  Antes de iniciar, carregue o contexto consultando:
8
20
  - `context-manifest.json` - Estrutura de repositórios
9
- - `repositório de MetaSpecs (seção de negócio)index.md` - Contexto de negócio
10
- - `repositório de MetaSpecs (seção técnica)index.md` - Stack, arquitetura e padrões técnicos
21
+ - MetaSpecs (localizado acima) - Arquitetura e padrões
11
22
  - `diretório do workspace` - Informações do workspace atual
12
23
 
13
24
  ## ⚙️ Configuração Inicial
package/dist/templates/commands/engineer/work.md CHANGED
@@ -5,11 +5,22 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
5
5
  ## 📋 Pré-requisitos
6
6
 
7
7
  Antes de executar, certifique-se de que:
8
- - Executou `/warm-up` para carregar o contexto
9
8
  - Executou `/start` e `/plan` para ter o planejamento técnico
10
9
  - Está no workspace correto (verifique `diretório do workspace`)
11
10
  - Tem o arquivo `./.sessions/<ISSUE-ID>/plan.md` disponível
12
11
 
12
+ ## 📚 Carregar MetaSpecs
13
+
14
+ **Localizar MetaSpecs automaticamente**:
15
+ 1. Leia `context-manifest.json` do orchestrator
16
+ 2. Encontre o repositório com `"role": "metaspecs"`
17
+ 3. Leia `ai.properties.md` para obter o `base_path`
18
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
19
+ 5. Leia os arquivos `index.md` relevantes durante a implementação para:
20
+ - Seguir padrões de código
21
+ - Respeitar arquitetura definida
22
+ - Usar convenções corretas
23
+
13
24
  ## 🎯 Objetivo
14
25
 
15
26
  Implementar uma unidade de trabalho específica do plano, que pode envolver:
package/dist/templates/commands/products/check.md CHANGED
@@ -18,14 +18,22 @@ Execute este comando:
18
18
  - Durante `/work` - validar decisões de implementação
19
19
  - Antes de `/pr` - validação final
20
20
 
21
+ ## 📚 Carregar MetaSpecs
22
+
23
+ **Localizar MetaSpecs automaticamente**:
24
+ 1. Leia `context-manifest.json` do orchestrator
25
+ 2. Encontre o repositório com `"role": "metaspecs"`
26
+ 3. Leia `ai.properties.md` para obter o `base_path`
27
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
28
+
21
29
  ## 🔍 Processo de Validação
22
30
 
23
31
  ### 1. Identificar Metaspecs Disponíveis
24
32
 
25
- Navegue até o diretório do orchestrator e identifique quais metaspecs existem:
33
+ Navegue até o diretório de metaspecs e identifique quais metaspecs existem:
26
34
 
27
35
  ```bash
28
- ls -la repositório de MetaSpecs
36
+ ls -la {base_path}/{metaspecs-repo-id}/
29
37
  ```
30
38
 
31
39
  ### 2. Validação de Negócio
package/dist/templates/commands/products/collect.md CHANGED
@@ -18,9 +18,17 @@ Você é um especialista em produto responsável por coletar e documentar novas
18
18
  ## Contexto do Projeto
19
19
 
20
20
  Antes de iniciar, carregue o contexto consultando:
21
- - `context-manifest.json` do orchestrator - Estrutura do projeto
22
- - Repositório de MetaSpecs (definido no manifest) - Leia os arquivos `index.md` como referência
23
- - `README.md` dos repositórios envolvidos
21
+
22
+ 1. **Localizar MetaSpecs automaticamente**:
23
+ - Leia `context-manifest.json` do orchestrator
24
+ - Encontre o repositório com `"role": "metaspecs"`
25
+ - Leia `ai.properties.md` para obter o `base_path`
26
+ - O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
27
+ - Leia os arquivos `index.md` como referência
28
+
29
+ 2. **Estrutura do projeto**:
30
+ - `context-manifest.json` - Lista de repositórios e suas funções
31
+ - `README.md` dos repositórios envolvidos
24
32
 
25
33
  ## Seu Objetivo
26
34
 
package/dist/templates/commands/products/refine.md CHANGED
@@ -13,7 +13,7 @@ Este comando é para refinamento de requisitos, não implementação.
13
13
  ## 📋 Pré-requisitos
14
14
 
15
15
  - Issue já coletada via `/collect`
16
- - Contexto do projeto carregado (execute `/warm-up` se necessário)
16
+ - Contexto do projeto será carregado automaticamente (veja seção "Carregar MetaSpecs" abaixo)
17
17
 
18
18
  ## 🎯 Objetivo
19
19
 
@@ -42,7 +42,20 @@ Refinar a issue coletada, esclarecendo:
42
42
  - Leia `./.sessions/<ISSUE-ID>/collect.md`
43
43
  - Se o arquivo não existir, informe o erro ao usuário
44
44
 
45
- ### 2. Análise de Escopo
45
+ ### 2. Carregar MetaSpecs
46
+
47
+ **Localizar MetaSpecs automaticamente**:
48
+ 1. Leia `context-manifest.json` do orchestrator
49
+ 2. Encontre o repositório com `"role": "metaspecs"`
50
+ 3. Leia `ai.properties.md` para obter o `base_path`
51
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
52
+ 5. Leia os arquivos `index.md` relevantes para entender:
53
+ - Arquitetura do sistema
54
+ - Padrões de design
55
+ - Restrições técnicas
56
+ - Convenções do projeto
57
+
58
+ ### 3. Análise de Escopo
46
59
 
47
60
  Defina claramente:
48
61
 
@@ -56,7 +69,7 @@ Defina claramente:
56
69
  - Otimizações futuras
57
70
  - Features "nice to have"
58
71
 
59
- ### 3. Critérios de Aceitação
72
+ ### 4. Critérios de Aceitação
60
73
 
61
74
  Defina critérios mensuráveis e testáveis:
62
75
 
@@ -77,7 +90,7 @@ Defina critérios mensuráveis e testáveis:
77
90
  - [ ] Documentação atualizada
78
91
  ```
79
92
 
80
- ### 4. Análise de Impacto
93
+ ### 5. Análise de Impacto
81
94
 
82
95
  Para cada repositório afetado:
83
96
 
@@ -97,7 +110,7 @@ Para cada repositório afetado:
97
110
  - **Riscos**: [riscos específicos]
98
111
  ```
99
112
 
100
- ### 5. Dependências e Restrições
113
+ ### 6. Dependências e Restrições
101
114
 
102
115
  Identifique:
103
116
  - Dependências entre repositórios
@@ -106,7 +119,7 @@ Identifique:
106
119
  - Restrições de negócio
107
120
  - Bloqueadores conhecidos
108
121
 
109
- ### 6. Estimativa Inicial
122
+ ### 7. Estimativa Inicial
110
123
 
111
124
  Forneça estimativa de esforço:
112
125
  - **Pequeno**: < 1 dia
@@ -114,7 +127,7 @@ Forneça estimativa de esforço:
114
127
  - **Grande**: 3-5 dias
115
128
  - **Muito Grande**: > 5 dias (considere quebrar em issues menores)
116
129
 
117
- ### 7. Perguntas Pendentes
130
+ ### 8. Perguntas Pendentes
118
131
 
119
132
  Liste perguntas que ainda precisam ser respondidas antes de iniciar a implementação.
120
133
 
package/dist/templates/commands/products/spec.md CHANGED
@@ -13,9 +13,21 @@ Este comando é para documentação de requisitos, não implementação.
13
13
  ## 📋 Pré-requisitos
14
14
 
15
15
  - Issue refinada via `/refine`
16
- - Contexto do projeto carregado
17
16
  - Aprovação para prosseguir com a feature
18
17
 
18
+ ## 📚 Carregar MetaSpecs
19
+
20
+ **Localizar MetaSpecs automaticamente**:
21
+ 1. Leia `context-manifest.json` do orchestrator
22
+ 2. Encontre o repositório com `"role": "metaspecs"`
23
+ 3. Leia `ai.properties.md` para obter o `base_path`
24
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
25
+ 5. Leia os arquivos `index.md` relevantes para garantir conformidade com:
26
+ - Arquitetura do sistema
27
+ - Padrões de design
28
+ - Restrições técnicas
29
+ - Convenções do projeto
30
+
19
31
  ## 🎯 Objetivo
20
32
 
21
33
  Criar um PRD completo que servirá como fonte única de verdade para a implementação.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "context-first-cli",
3
- "version": "1.5.7",
3
+ "version": "1.5.8",
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
@@ -6,7 +6,19 @@ Este comando cria o plano técnico detalhado para implementação da feature.
6
6
 
7
7
  - PRD criado via `/spec`
8
8
  - Análise inicial feita via `/start`
9
- - Contexto técnico carregado
9
+
10
+ ## 📚 Carregar MetaSpecs
11
+
12
+ **Localizar MetaSpecs automaticamente**:
13
+ 1. Leia `context-manifest.json` do orchestrator
14
+ 2. Encontre o repositório com `"role": "metaspecs"`
15
+ 3. Leia `ai.properties.md` para obter o `base_path`
16
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
17
+ 5. Leia os arquivos `index.md` relevantes para garantir conformidade com:
18
+ - Arquitetura do sistema
19
+ - Padrões de design e código
20
+ - Estrutura de pastas e arquivos
21
+ - Convenções de nomenclatura
10
22
 
11
23
  ## 🎯 Objetivo
12
24
 
package/templates/commands/engineer/start.md CHANGED
@@ -2,12 +2,23 @@
2
2
 
3
3
  Este comando inicia o desenvolvimento de uma funcionalidade no workspace atual.
4
4
 
5
+ ## 📚 Carregar MetaSpecs
6
+
7
+ **Localizar MetaSpecs automaticamente**:
8
+ 1. Leia `context-manifest.json` do orchestrator
9
+ 2. Encontre o repositório com `"role": "metaspecs"`
10
+ 3. Leia `ai.properties.md` para obter o `base_path`
11
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
12
+ 5. Leia os arquivos `index.md` relevantes:
13
+ - Contexto de negócio
14
+ - Stack, arquitetura e padrões técnicos
15
+ - Convenções do projeto
16
+
5
17
  ## 🎯 Contexto do Projeto
6
18
 
7
19
  Antes de iniciar, carregue o contexto consultando:
8
20
  - `context-manifest.json` - Estrutura de repositórios
9
- - `repositório de MetaSpecs (seção de negócio)index.md` - Contexto de negócio
10
- - `repositório de MetaSpecs (seção técnica)index.md` - Stack, arquitetura e padrões técnicos
21
+ - MetaSpecs (localizado acima) - Arquitetura e padrões
11
22
  - `diretório do workspace` - Informações do workspace atual
12
23
 
13
24
  ## ⚙️ Configuração Inicial
package/templates/commands/engineer/work.md CHANGED
@@ -5,11 +5,22 @@ Este comando executa uma unidade de trabalho no workspace atual, implementando p
5
5
  ## 📋 Pré-requisitos
6
6
 
7
7
  Antes de executar, certifique-se de que:
8
- - Executou `/warm-up` para carregar o contexto
9
8
  - Executou `/start` e `/plan` para ter o planejamento técnico
10
9
  - Está no workspace correto (verifique `diretório do workspace`)
11
10
  - Tem o arquivo `./.sessions/<ISSUE-ID>/plan.md` disponível
12
11
 
12
+ ## 📚 Carregar MetaSpecs
13
+
14
+ **Localizar MetaSpecs automaticamente**:
15
+ 1. Leia `context-manifest.json` do orchestrator
16
+ 2. Encontre o repositório com `"role": "metaspecs"`
17
+ 3. Leia `ai.properties.md` para obter o `base_path`
18
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
19
+ 5. Leia os arquivos `index.md` relevantes durante a implementação para:
20
+ - Seguir padrões de código
21
+ - Respeitar arquitetura definida
22
+ - Usar convenções corretas
23
+
13
24
  ## 🎯 Objetivo
14
25
 
15
26
  Implementar uma unidade de trabalho específica do plano, que pode envolver:
package/templates/commands/products/check.md CHANGED
@@ -18,14 +18,22 @@ Execute este comando:
18
18
  - Durante `/work` - validar decisões de implementação
19
19
  - Antes de `/pr` - validação final
20
20
 
21
+ ## 📚 Carregar MetaSpecs
22
+
23
+ **Localizar MetaSpecs automaticamente**:
24
+ 1. Leia `context-manifest.json` do orchestrator
25
+ 2. Encontre o repositório com `"role": "metaspecs"`
26
+ 3. Leia `ai.properties.md` para obter o `base_path`
27
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
28
+
21
29
  ## 🔍 Processo de Validação
22
30
 
23
31
  ### 1. Identificar Metaspecs Disponíveis
24
32
 
25
- Navegue até o diretório do orchestrator e identifique quais metaspecs existem:
33
+ Navegue até o diretório de metaspecs e identifique quais metaspecs existem:
26
34
 
27
35
  ```bash
28
- ls -la repositório de MetaSpecs
36
+ ls -la {base_path}/{metaspecs-repo-id}/
29
37
  ```
30
38
 
31
39
  ### 2. Validação de Negócio
package/templates/commands/products/collect.md CHANGED
@@ -18,9 +18,17 @@ Você é um especialista em produto responsável por coletar e documentar novas
18
18
  ## Contexto do Projeto
19
19
 
20
20
  Antes de iniciar, carregue o contexto consultando:
21
- - `context-manifest.json` do orchestrator - Estrutura do projeto
22
- - Repositório de MetaSpecs (definido no manifest) - Leia os arquivos `index.md` como referência
23
- - `README.md` dos repositórios envolvidos
21
+
22
+ 1. **Localizar MetaSpecs automaticamente**:
23
+ - Leia `context-manifest.json` do orchestrator
24
+ - Encontre o repositório com `"role": "metaspecs"`
25
+ - Leia `ai.properties.md` para obter o `base_path`
26
+ - O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
27
+ - Leia os arquivos `index.md` como referência
28
+
29
+ 2. **Estrutura do projeto**:
30
+ - `context-manifest.json` - Lista de repositórios e suas funções
31
+ - `README.md` dos repositórios envolvidos
24
32
 
25
33
  ## Seu Objetivo
26
34
 
package/templates/commands/products/refine.md CHANGED
@@ -13,7 +13,7 @@ Este comando é para refinamento de requisitos, não implementação.
13
13
  ## 📋 Pré-requisitos
14
14
 
15
15
  - Issue já coletada via `/collect`
16
- - Contexto do projeto carregado (execute `/warm-up` se necessário)
16
+ - Contexto do projeto será carregado automaticamente (veja seção "Carregar MetaSpecs" abaixo)
17
17
 
18
18
  ## 🎯 Objetivo
19
19
 
@@ -42,7 +42,20 @@ Refinar a issue coletada, esclarecendo:
42
42
  - Leia `./.sessions/<ISSUE-ID>/collect.md`
43
43
  - Se o arquivo não existir, informe o erro ao usuário
44
44
 
45
- ### 2. Análise de Escopo
45
+ ### 2. Carregar MetaSpecs
46
+
47
+ **Localizar MetaSpecs automaticamente**:
48
+ 1. Leia `context-manifest.json` do orchestrator
49
+ 2. Encontre o repositório com `"role": "metaspecs"`
50
+ 3. Leia `ai.properties.md` para obter o `base_path`
51
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
52
+ 5. Leia os arquivos `index.md` relevantes para entender:
53
+ - Arquitetura do sistema
54
+ - Padrões de design
55
+ - Restrições técnicas
56
+ - Convenções do projeto
57
+
58
+ ### 3. Análise de Escopo
46
59
 
47
60
  Defina claramente:
48
61
 
@@ -56,7 +69,7 @@ Defina claramente:
56
69
  - Otimizações futuras
57
70
  - Features "nice to have"
58
71
 
59
- ### 3. Critérios de Aceitação
72
+ ### 4. Critérios de Aceitação
60
73
 
61
74
  Defina critérios mensuráveis e testáveis:
62
75
 
@@ -77,7 +90,7 @@ Defina critérios mensuráveis e testáveis:
77
90
  - [ ] Documentação atualizada
78
91
  ```
79
92
 
80
- ### 4. Análise de Impacto
93
+ ### 5. Análise de Impacto
81
94
 
82
95
  Para cada repositório afetado:
83
96
 
@@ -97,7 +110,7 @@ Para cada repositório afetado:
97
110
  - **Riscos**: [riscos específicos]
98
111
  ```
99
112
 
100
- ### 5. Dependências e Restrições
113
+ ### 6. Dependências e Restrições
101
114
 
102
115
  Identifique:
103
116
  - Dependências entre repositórios
@@ -106,7 +119,7 @@ Identifique:
106
119
  - Restrições de negócio
107
120
  - Bloqueadores conhecidos
108
121
 
109
- ### 6. Estimativa Inicial
122
+ ### 7. Estimativa Inicial
110
123
 
111
124
  Forneça estimativa de esforço:
112
125
  - **Pequeno**: < 1 dia
@@ -114,7 +127,7 @@ Forneça estimativa de esforço:
114
127
  - **Grande**: 3-5 dias
115
128
  - **Muito Grande**: > 5 dias (considere quebrar em issues menores)
116
129
 
117
- ### 7. Perguntas Pendentes
130
+ ### 8. Perguntas Pendentes
118
131
 
119
132
  Liste perguntas que ainda precisam ser respondidas antes de iniciar a implementação.
120
133
 
package/templates/commands/products/spec.md CHANGED
@@ -13,9 +13,21 @@ Este comando é para documentação de requisitos, não implementação.
13
13
  ## 📋 Pré-requisitos
14
14
 
15
15
  - Issue refinada via `/refine`
16
- - Contexto do projeto carregado
17
16
  - Aprovação para prosseguir com a feature
18
17
 
18
+ ## 📚 Carregar MetaSpecs
19
+
20
+ **Localizar MetaSpecs automaticamente**:
21
+ 1. Leia `context-manifest.json` do orchestrator
22
+ 2. Encontre o repositório com `"role": "metaspecs"`
23
+ 3. Leia `ai.properties.md` para obter o `base_path`
24
+ 4. O metaspecs está em: `{base_path}/{metaspecs-repo-id}/`
25
+ 5. Leia os arquivos `index.md` relevantes para garantir conformidade com:
26
+ - Arquitetura do sistema
27
+ - Padrões de design
28
+ - Restrições técnicas
29
+ - Convenções do projeto
30
+
19
31
  ## 🎯 Objetivo
20
32
 
21
33
  Criar um PRD completo que servirá como fonte única de verdade para a implementação.