specifica-br 1.2.2 → 1.5.0

package/README.md

@@ -34,10 +34,9 @@ specifica-br init
 ```
 
 **O que faz:**
-- Permite selecionar a convenção de diretórios (OpenCode ou Specifica-BR)
-- Cria os diretórios de comandos e templates baseados na seleção
-- Se OpenCode for selecionado, guia na escolha da ferramenta e modelo de IA
-- Copia os arquivos de templates necessários
+- Permite selecionar a ferramenta de IA (OpenCode, ClaudeCode, Cursor, Gemini CLI, Kiro)
+- Cria os diretórios de comandos, skills e templates baseados na ferramenta selecionada
+- Copia os 7 comandos do workflow SDD, 2 skills e 7 templates
 - Exibe informações sobre o workflow SDD
 
 **Exemplo de uso:**
@@ -45,15 +44,19 @@ specifica-br init
 $ specifica-br init
 Inicializando estrutura Spec Driven Development...
 
-Selecione a convenção de diretórios para comandos:
-❯ Recomendado (OpenCode)
-  Agnóstico (Specifica-BR)
-
 Selecione a ferramenta de IA:
 ❯ OpenCode
+  ClaudeCode
+  Cursor
+  Gemini CLI
+  Kiro
+
+Os seguintes diretórios serão criados:
+  Commands: .opencode/commands/ (7 arquivos)
+  Skills: .agents/skills/ (2 skills com referências)
+  Templates: specs/templates/ (7 arquivos)
 
-Selecione o modelo de IA:
-❯ GLM 4.7
+[?] Deseja continuar? Yes
 
 ✓ Estrutura SDD criada com sucesso!
 ```
@@ -80,17 +83,29 @@ specifica-br help --completo
 ```
 
 **O que faz:**
-- Mostra o fluxo completo de SDD em 5 passos
+- Mostra o fluxo completo de SDD em 7 passos
 - Explica cada etapa do workflow
+- Lista as ferramentas de IA suportadas
 - Lista os benefícios do SDD
 
 **Workflow SDD:**
 
 1. **Inicialização:** Cria estrutura de diretórios e templates
-2. **Geração de PRD:** Define requisitos funcionais e regras de negócio
-3. **Geração de Tech Spec:** Define arquitetura técnica e plano de implementação
-4. **Geração de Tarefas:** Decompõe o plano técnico em tarefas executáveis
-5. **Execução de Tarefas:** Implementa cada tarefa seguindo a especificação
+2. **Definição do Contexto:** Escolha baseada no tipo de projeto
+   - **Projeto Novo (Green Field):** Use `/gerar-visao` - Define Fundação (Contexto + Stack) - Role: Product Manager + Tech Lead - Foco: Visão macro
+   - **Projeto em Desenvolvimento (Brown Field):** Use `/gerar-contexto` - Analisa código e INFERE (Contexto + Stack) - Role: Engenheiro Senior + Arquiteto - Foco: Análise automática
+3. **Geração de PRD:** Define requisitos funcionais e regras de negócio
+4. **Geração de Tech Spec:** Define arquitetura técnica e plano de implementação
+5. **Geração de Tarefas:** Decompõe o plano técnico em tarefas executáveis
+6. **Execução de Tarefas:** Implementa cada tarefa seguindo a especificação
+7. **Code Review:** Realiza code review do código implementado
+
+**Ferramentas de IA suportadas:**
+- OpenCode
+- ClaudeCode
+- Cursor
+- Gemini CLI
+- Kiro
 
 ### `specifica-br upgrade`
 
@@ -315,7 +330,7 @@ Este sistema funciona nativamente em todos os sistemas operacionais:
 
 ## Workflow SDD Completo
 
-O workflow completo de Spec Driven Development é composto por 5 etapas:
+O workflow completo de Spec Driven Development é composto por 7 etapas:
 
 ### 1. Inicialização
 
@@ -325,7 +340,31 @@ specifica-br init
 
 Cria a estrutura de diretórios e templates no projeto.
 
-### 2. Geração de PRD
+### 2. Definição do Contexto
+
+Escolha o comando baseado no tipo do seu projeto:
+
+**Projeto Novo (Green Field):**
+```bash
+/gerar-visao [sua ideia]
+```
+
+Define a Fundação do projeto (Contexto + Stack Tecnológica).
+- **Role:** Product Manager + Tech Lead
+- **Foco:** Visão macro e estratégica
+- **Resultado:** `specs/core/product_vision.md` (visão de negócio) e `specs/core/architecture.md` (arquitetura técnica)
+
+**Projeto em Desenvolvimento (Brown Field):**
+```bash
+/gerar-contexto
+```
+
+Analisa o código existente e INFERE o contexto.
+- **Role:** Engenheiro Senior + Arquiteto
+- **Foco:** Análise automática do código base
+- **Resultado:** `specs/core/product_vision.md` (inferida do código) e `specs/core/architecture.md` (com níveis de confiança)
+
+### 3. Geração de PRD
 
 ```bash
 /gerar-prd [sua ideia]
@@ -333,7 +372,7 @@ Cria a estrutura de diretórios e templates no projeto.
 
 Define requisitos funcionais e regras de negócio da feature.
 
-### 3. Geração de Tech Spec
+### 4. Geração de Tech Spec
 
 ```bash
 /gerar-techspec [caminho do prd]
@@ -341,7 +380,7 @@ Define requisitos funcionais e regras de negócio da feature.
 
 Define arquitetura técnica, componentes e plano de implementação.
 
-### 4. Geração de Tarefas
+### 5. Geração de Tarefas
 
 ```bash
 /gerar-tasks [caminho do prd] [caminho do tech spec]
@@ -349,53 +388,84 @@ Define arquitetura técnica, componentes e plano de implementação.
 
 Decompõe o plano técnico em tarefas executáveis.
 
-### 5. Execução de Tarefas
+### 6. Execução de Tarefas
 
 ```bash
-/executar-task [caminho da task] [prd] [tech spec]
+/executar-task [caminho da task]
 ```
 
 Implementa cada tarefa individualmente seguindo a especificação.
 
-## Estrutura do Projeto
+### 7. Code Review
 
-Após executar `specifica-br init`, a estrutura do projeto depende da convenção selecionada:
+```bash
+/realizar-codereview
+```
 
-**Se opção 1 (OpenCode) for selecionada:**
+Realiza code review do código implementado.
 
-```
-seu-projeto/
-├── .opencode/
-│   └── commands/
-│       ├── gerar-prd.md
-│       ├── gerar-techspec.md
-│       ├── gerar-tasks.md
-│       └── executar-task.md
-└── specs/
-    └── templates/
-        ├── prd-template.md
-        ├── techspec-template.md
-        ├── task-template.md
-        └── tasks-template.md
-```
+## Estrutura do Projeto
 
-**Se opção 2 (Specifica-BR) for selecionada:**
+Após executar `specifica-br init`, a estrutura do projeto depende da ferramenta selecionada:
+
+**Ferramentas de IA suportadas:**
+- **OpenCode:** comandos em `.opencode/commands/`, skills em `.agents/skills/`
+- **ClaudeCode:** comandos em `.claude/commands/`, skills em `.claude/skills/`
+- **Cursor:** comandos em `.cursor/commands/`, skills em `.cursor/skills/`
+- **Gemini CLI:** comandos em `.gemini/commands/`, skills em `.agents/skills/`
+- **Kiro:** comandos em `.kiro/commands/`, skills em `.kiro/skills/`
+
+**Exemplo de estrutura com OpenCode:**
 
 ```
 seu-projeto/
-├── specifica-br/
+├── .opencode/
 │   └── commands/
 │       ├── gerar-prd.md
 │       ├── gerar-techspec.md
 │       ├── gerar-tasks.md
-│       └── executar-task.md
+│       ├── executar-task.md
+│       ├── gerar-contexto.md
+│       ├── gerar-visao.md
+│       └── realizar-codereview.md
+├── .agents/
+│   └── skills/
+│       ├── product-manager/
+│       │   └── SKILL.md
+│       └── techspec-generator/
+│           └── SKILL.md
 └── specs/
     └── templates/
         ├── prd-template.md
         ├── techspec-template.md
         ├── task-template.md
-        └── tasks-template.md
-```
+        ├── tasks-template.md
+        ├── context-template.md
+        ├── visao-template.md
+        └── codereview-template.md
+```
+
+**Comandos disponíveis (7):**
+1. `/gerar-prd` - Gera Product Requirements Document
+2. `/gerar-techspec` - Gera Especificação Técnica
+3. `/gerar-tasks` - Gera lista de tarefas
+4. `/executar-task` - Executa uma tarefa específica
+5. `/gerar-contexto` - Gera contexto do projeto
+6. `/gerar-visao` - Gera visão estratégica
+7. `/realizar-codereview` - Realiza code review
+
+**Skills disponíveis (2):**
+1. `product-manager` - Skill especializada para criar PRDs, definindo requisitos funcionais, regras de negócio e critérios de aceitação
+2. `techspec-generator` - Skill especializada para criar Tech Specs, definindo arquitetura técnica, componentes e plano de implementação
+
+**Templates disponíveis (7):**
+1. `prd-template.md` - Template de PRD
+2. `techspec-template.md` - Template de Tech Spec
+3. `task-template.md` - Template de Task
+4. `tasks-template.md` - Template de Tasks
+5. `context-template.md` - Template de Contexto
+6. `visao-template.md` - Template de Visão
+7. `codereview-template.md` - Template de Code Review
 
 ## Opções Globais
 

package/dist/boilerplate/commands/executar-task.md

@@ -0,0 +1,133 @@
+<system_instructions>
+  Você é um Engenheiro de Software Sênior atuando como mentor técnico e executor.
+ Seu objetivo é executar os itens PENDENTES descritos no TASK_FILE, seguindo rigorosamente o fluxo  proposto.
+
+  <definicao_importante>
+  - Implementar significa criar ou modificar arquivos reais do projeto, não apenas descrever  código.
+  </definicao_importante>
+ 	
+  <input_files>
+  1. TASK_FILE (Estado atual e lista de tarefas):
+  {{content_of_task_XX_md}}
+ 
+  2. CONTEXTO DO USUÁRIO (Instrução extra ou correção para esta execução):
+  {{user_input_context}}
+  Se existir conteúdo aqui, trate como prioridade máxima.
+ 
+  3. PRD (Regras de Negócio):
+  {{[Link PRD]}} - VOCÊ DEVE OBRIGATORIAMENTE IMPORTAR TODO O CONTEUDO DO ARQUIVO PRD DA FEATURE E ADICIONAR EM SEU CONTEXTO.
+ 
+  4. TECH_SPEC (Especificação Técnica e Arquitetura):
+  {{[Link TECHSPEC]}} - VOCÊ DEVE OBRIGATORIAMENTE IMPORTAR TODO O CONTEUDO DO ARQUIVO TECHSPEC DA FEATURE E ADICIONAR EM SEU CONTEXTO.
+ 
+  5. PROJECT_RULES (Padrões do Projeto - AGENTS.md):
+  {{content_of_agents_md}}
+  </input_files>
+ 	
+  <execution_protocol>
+ 
+  Utilize raciocínio interno para planejar, mas NÃO exponha o raciocínio detalhado.
+ 
+ # PASSO 1: ANÁLISE DE ESTADO E ESCOPO
+  - Leia o TASK_FILE.
+  - Ignore itens marcados como [x].
+  - O escopo de trabalho são apenas os itens [ ].
+  - Se o CONTEXTO DO USUÁRIO solicitar correção, trate antes de qualquer implementação.
+ 
+  # PASSO 2: PLANO DE EXECUÇÃO
+  - Crie um plano simples e direto.
+  - Para cada critério de aceitação, declare explicitamente:
+  - Arquivos que precisam existir ou ser alterados
+  - Evidência objetiva que comprova a conclusão
+  - Liste todos os arquivos que serão criados ou editados.
+  - Se não for possível cumprir TODOS os critérios, declare isso explicitamente.
+ 
+  ## PASSO 2.1: CONTRATO DE EXECUÇÃO (OBRIGATÓRIO)
+  - Declare explicitamente:
+    - Arquivos finais esperados
+    - Critérios de aceitação que serão concluídos
+    - Se algum critério não puder ser atendido, ABORTE a execução.
+ 
+ # PASSO 3: IMPLEMENTAÇÃO (CODING)
+  - Crie ou edite apenas os arquivos declarados no contrato.
+  - Siga estritamente o PROJECT_RULES.
+  - Não refatore código fora do escopo.
+  - Todo código persistido DEVE estar listado explicitamente como arquivo.
+  - Código apenas descrito em texto NÃO é considerado implementação.
+ - Código comentado NÃO é considerado implementação.
+ 
+  # PASSO 4: VALIDAÇÃO
+   - Valide cada critério de aceitação usando evidências concretas.
+   - É PROIBIDO marcar critérios como concluídos sem evidência explícita.
+   - O critério "build" só pode ser marcado como concluído se:
+  	- Aplicação compilar sem erros
+  	- Todos os arquivos que deveriam ser implementados existirem
+  	- Não houver código incompleto, TODOs ou placeholders
+
+  # PASSO 5: ATUALIZAÇÃO DA TASK
+    - APOS concluir a implementacao e validacao interna, atualize a task marcando os itens concluidos
+    - Atualize o arquivo tasks.md marcando a task como concluida
+    - A task pode ser marcada como DONE apos:
+      - Aplicacao compilar sem erros
+      - Todos os arquivos que deveriam ser implementados existirem
+      - Nao houver codigo incompleto, TODOs ou placeholders
+
+  </execution_protocol>
+ 	
+  <constraints>
+  - Output deve ser em Markdown puro
+  - Atomicidade: resolver apenas o escopo da task
+  - Segurança: nunca gerar segredos hardcoded
+  - Consistência: Spec tem prioridade sobre Task (avisar se houver conflito)
+  - É proibido declarar sucesso sem artefatos reais
+  </constraints>
+ 	
+  <anti_patterns>
+  - Gerar apenas texto explicativo
+  - Declarar sucesso sem arquivos reais
+  - Marcar critérios sem evidência objetiva
+  - Assumir que código compila sem estrutura válida
+  **Se qualquer anti-pattern ocorrer, a execução é considerada inválida.** 
+ 
+  </anti_patterns>
+ 	
+  <output_format>
+    ## Resumo e Plano:
+     - Resumo do escopo
+     - Plano de execução
+     - Contrato de execução
+
+    ## Arquivos de Código (Persistidos no Projeto)
+     Para cada arquivo:
+     Arquivo: caminho/do/arquivo.ext
+     Conteúdo completo do arquivo
+
+    # Atualização da Task
+     - Arquivo: path_to_task_file
+     - Task com checkboxes atualizados
+     - Arquivo `tasks.md` com checkbox atualizado
+  </output_format>
+ 	
+  <critical>
+
+    # INICIE A EXECUÇÃO SOMENTE APÓS:
+     - Definir o contrato de execução
+     - Confirmar que todos os critérios podem ser atendidos
+
+    # ATUALIZAÇÃO DA TASK
+    - A task pode ser marcada como DONE apos:
+      - Aplicacao compilar sem erros
+      - Todos os arquivos que deveriam ser implementados existirem
+      - Nao houver codigo incompleto, TODOs ou placeholders
+    - Gere o conteúdo COMPLETO do arquivo da task.
+    - Marque com [x] apenas os critérios comprovadamente atendidos.
+    - Marque com [x] a task recém completada em {{tasks_file.md}}
+    - Critérios sem evidência devem permanecer [ ].
+
+     - **Para recorrer a documentações de linguagens, frameworks e bibliotecas, utilize o Context7**.
+
+  </critical>
+ 	
+ Command Version: 0.2.0
+ 
+</system_instructions>