@dewtech/dare-cli 2.16.0 → 3.0.0

package/templates/ide/claude/.claude/commands/dare-bugfix-design.md

@@ -0,0 +1,119 @@
+# /dare-bugfix-design
+
+Diagnostica bug em projeto existente e planeja correção cirúrgica via Método DARE. Gera `DARE/DESIGN-Bugfix-[Nome].md` com causa raiz, riscos de regressão e plano de ação mínimo.
+
+## Como usar
+
+```
+/dare-bugfix-design                                  # interativo: pede o relato
+/dare-bugfix-design "Login falha quando email tem +" # com descrição direta
+```
+
+## Quando usar
+
+- Usuário relata bug ou comportamento inesperado
+- Bug complexo precisa de planejamento antes de codar
+- Risco de regressão é não-trivial
+
+## O que fazer
+
+### 1. Entender o relato completo
+
+Antes de tocar em código, esclareça:
+- **Comportamento atual** — o que acontece de errado?
+- **Comportamento esperado** — o que deveria acontecer?
+- **Passos para reproduzir** — como você fez aparecer o bug?
+- **Logs/stack traces** — se houver, peça ao usuário
+
+### 2. Localizar a área afetada
+
+Identifique controllers, services, queries ou componentes envolvidos no fluxo. Use grep / IDE navigation para chegar nos arquivos mais prováveis.
+
+### 3. Encontrar a causa raiz (crítico)
+
+Não trate sintoma. Investigue o **porquê**:
+
+| Tipo de causa | Exemplos |
+|---|---|
+| Lógica de negócio | Condição incorreta, cálculo errado, off-by-one |
+| Banco de dados | N+1, deadlock, dados inconsistentes, índice ausente |
+| Validação | Input não validado, tipo incorreto, edge case (string vazia, NaN, negativo) |
+| Concorrência | Race condition, falta de lock, transação isolada errada |
+| Segurança | SQL injection, XSS, IDOR, broken auth |
+| Integração | Timeout, retry sem idempotência, API externa mudou contrato |
+
+### 4. Avaliar impacto e riscos
+
+- Quais arquivos precisam mudar?
+- Tem migração/script de DB?
+- O que mais essa correção pode quebrar?
+- Qual o blast radius?
+
+### 5. Gerar `DARE/DESIGN-Bugfix-[Nome].md`
+
+Estrutura obrigatória:
+
+```markdown
+# Bugfix Design: [Nome curto e descritivo]
+
+## Descrição do Problema
+- **Comportamento Atual:** [o que está acontecendo]
+- **Comportamento Esperado:** [o que deveria]
+- **Passos para Reproduzir:** [se conhecido]
+- **Severidade:** [Crítica / Alta / Média / Baixa]
+- **Reportado por:** [usuário / Sentry / monitoramento]
+
+## Diagnóstico da Causa Raiz
+[Explicação técnica detalhada do porquê o bug ocorre — referencie linhas de código específicas se possível]
+
+## Análise de Impacto
+- **Arquivos a Modificar:** [lista exata]
+- **Banco de Dados:** [migração necessária? script de fix de dados?]
+- **APIs externas:** [muda contrato com algum cliente/integrador?]
+- **Riscos de Regressão:** [o que pode quebrar ao consertar]
+
+## Plano de Ação (Correção Cirúrgica)
+1. [Passo 1: ajustar X em arquivo Y]
+2. [Passo 2: adicionar teste unitário que falha com o bug e passa com a correção]
+3. [Passo 3: validar comportamento em staging]
+
+## Testes Necessários
+- **Validation Gates:** [teste novo que reproduz o bug]
+- **Testes de Regressão:** [testes existentes a re-rodar]
+- **E2E:** [smoke test do fluxo afetado]
+
+## Rollback Plan
+[Se a correção quebrar produção, como reverter rapidamente?]
+
+## Próximas Etapas
+1. Revisar e aprovar este Bugfix Design
+2. Rodar `/dare-blueprint` se a correção for grande, ou ir direto para `/dare-tasks`
+3. Se for trivial (< 10 linhas), pular direto para `/dare-execute`
+```
+
+### 6. Pedir aprovação
+
+Apresente o documento ao usuário e peça aprovação antes de prosseguir. Bugfix sem diagnóstico aprovado vira chumbadeira.
+
+## Regras de ouro
+
+1. **Cirúrgico** — menor código possível, sem efeitos colaterais
+2. **Causa raiz, não sintoma** — se a raiz não for corrigida, o bug volta
+3. **Teste novo obrigatório** — se o bug ocorreu, faltava teste. Adicione um que falharia com o código antigo
+4. **Mapeie regressão** — sempre planeje o que pode quebrar e como detectar
+
+## Antipatterns
+
+| AP | Antipattern | Por quê |
+|---|---|---|
+| AP-01 | Tratar só o sintoma | Bug volta em variação diferente |
+| AP-02 | Corrigir sem reproduzir | Não tem como validar que sumiu |
+| AP-03 | Mudar arquivos não relacionados | Aumenta blast radius desnecessariamente |
+| AP-04 | Não adicionar teste | Bug pode reaparecer em regressão futura |
+| AP-05 | Pular aprovação humana | Bugfix mal planejado vira bug pior |
+
+$ARGUMENTS
+
+---
+
+Skill MIT — parte do DARE Method.

package/templates/ide/claude/.claude/commands/dare-dag-build.md

@@ -1,110 +1,151 @@
-# /dare-dag-build
-
-Regenera **apenas** o `DARE/dare-dag.yaml` a partir do `DARE/BLUEPRINT.md` já
-existente, sem refazer o blueprint nem as specs. Útil quando o BLUEPRINT
-mudou pouco mas você precisa que o grafo reflita o novo estado.
-
-## Quando usar
-
-- O BLUEPRINT foi ajustado e o grafo precisa refletir
-- Você quer experimentar uma decomposição diferente sem refazer o blueprint
-- O `dare-dag.yaml` ficou inconsistente com `EXECUTION/task-*.md`
-- Precisa adicionar/remover/reordenar tasks no grafo
-
-## Pré-requisitos
-
-- `DARE/BLUEPRINT.md` existe e está aprovado
-- (Opcional) `DARE/EXECUTION/task-*.md` específicas serão preservadas se não
-  forem mencionadas
-
-## O que fazer
-
-### 1. Ler `DARE/BLUEPRINT.md`
-
-Obrigatório. Se faltar, peça `/dare-blueprint` antes.
-
-### 2. Ler `DARE/dare-dag.yaml` atual (se existir)
-
-Para preservar `id`s já em uso e não confundir o usuário com renomeações
-desnecessárias.
-
-### 3. Gerar o novo `dare-dag.yaml`
-
-Schema canônico:
-
-```yaml
-title: "<Nome do Projeto> - Development Tasks"
-version: "1.0.0"
-
-limits:
-  parent_context_chars: 2000
-  task_output_chars: 4000
-  timeout_seconds: 600
-
-models:
-  cursor:      { HIGH: gpt-5.3-codex,     MED: composer-2,       LOW: auto-low }
-  claude:      { HIGH: claude-sonnet-4-5, MED: claude-haiku-4,   LOW: claude-haiku-4 }
-  antigravity: { HIGH: gemini-2.5-pro,    MED: gemini-2.5-flash, LOW: gemini-2.5-flash }
-
-tasks:
-  - id: task-001
-    title: "..."
-    depends_on: []
-    complexity: LOW
-    spec_file: EXECUTION/task-001.md
-    subtask_prompt: |
-      <self-contained>
-```
-
-**Regras inegociáveis:**
-
-- `id` em kebab-case e único
-- `depends_on` mínimo — só quando filha *literalmente* precisa do output
-- `subtask_prompt` self-contained
-- Pelo menos 2 tasks no rank 0
-- Cadeia linear é antipattern
-- `complexity` honesta
-
-### 4. Validar consistência com `EXECUTION/task-*.md`
-
-Se uma spec existe em `DARE/EXECUTION/task-<id>.md`:
-- Mantenha o mesmo `id` no YAML
-- Aponte `spec_file: EXECUTION/task-<id>.md`
-- Se a `complexity` ou `depends_on` mudou, atualize **também** a spec e o
-  `TASKS.md`
-
-Se uma task nova entrou no YAML mas não tem spec:
-- Crie a spec correspondente em `EXECUTION/task-<id>.md`
-
-Se uma task saiu do YAML mas a spec ficou:
-- Pergunte ao usuário: arquivar (mover para `EXECUTION/_archived/`) ou
-  apagar?
-
-### 5. Validar grafo
-
-- Sem ciclos
-- Todos os `depends_on` apontam para `id`s existentes
-- `id`s únicos
-- Pelo menos 2 tasks no rank 0
-
-### 6. Atualizar `DARE/TASKS.md`
-
-Reflita o novo grafo na tabela master.
-
-### 7. Mensagem ao usuário
-
-> `dare-dag.yaml` regenerado:
-> - Total de tasks: N
-> - Ranks paralelos: N
-> - Adicionadas: [...]
-> - Removidas: [...]
-> - Modificadas: [...]
->
-> Revise e aprove. Para executar: `/dare-dag-run`.
-
-## Quando NÃO usar
-
-- Se você nunca rodou `/dare-blueprint` antes — use `/dare-blueprint` primeiro
-- Se o BLUEPRINT está desatualizado — atualize o BLUEPRINT primeiro
-
-$ARGUMENTS
+# /dare-dag-build
+
+Regenera **apenas** o `DARE/dare-dag.yaml` a partir do `DARE/BLUEPRINT.md` já
+existente, sem refazer o blueprint nem as specs. Útil quando o BLUEPRINT
+mudou pouco mas você precisa que o grafo reflita o novo estado.
+
+## Quando usar
+
+- O BLUEPRINT foi ajustado e o grafo precisa refletir
+- Você quer experimentar uma decomposição diferente sem refazer o blueprint
+- O `dare-dag.yaml` ficou inconsistente com `EXECUTION/task-*.md`
+- Precisa adicionar/remover/reordenar tasks no grafo
+
+## Pré-requisitos
+
+- `DARE/BLUEPRINT.md` existe e está aprovado
+- (Opcional) `DARE/EXECUTION/task-*.md` específicas serão preservadas se não
+  forem mencionadas
+
+## O que fazer
+
+### 1. Ler `DARE/BLUEPRINT.md`
+
+Obrigatório. Se faltar, peça `/dare-blueprint` antes.
+
+### 2. Ler `DARE/dare-dag.yaml` atual (se existir)
+
+Para preservar `id`s já em uso e não confundir o usuário com renomeações
+desnecessárias.
+
+### 3. Gerar o novo `dare-dag.yaml`
+
+Schema canônico:
+
+```yaml
+title: "<Nome do Projeto> - Development Tasks"
+version: "1.0.0"
+
+limits:
+  parent_context_chars: 2000
+  task_output_chars: 4000
+  timeout_seconds: 600
+
+models:
+  cursor:      { HIGH: gpt-5.3-codex,     MED: composer-2,       LOW: auto-low }
+  claude:      { HIGH: claude-sonnet-4-5, MED: claude-haiku-4,   LOW: claude-haiku-4 }
+  antigravity: { HIGH: gemini-2.5-pro,    MED: gemini-2.5-flash, LOW: gemini-2.5-flash }
+
+tasks:
+  - id: task-001
+    title: "..."
+    depends_on: []
+    complexity: LOW
+    spec_file: EXECUTION/task-001.md
+    subtask_prompt: |
+      <self-contained>
+```
+
+**Regras inegociáveis:**
+
+- `id` em kebab-case e único
+- `depends_on` mínimo — só quando filha *literalmente* precisa do output
+- `subtask_prompt` self-contained
+- Pelo menos 2 tasks no rank 0
+- Cadeia linear é antipattern
+- `complexity` honesta
+
+### 3.1 ANTI-STUB CONTRACT (inegociável)
+
+> Tasks geradas com `subtask_prompt` ou spec genéricos forçam o agente a inventar — e ele vai produzir mock, stub ou esqueleto. **Não é negociável**. O comando `dare review <task-id>` (v2.17+) detecta isso e marca a task como FAILED.
+
+Cada `subtask_prompt` e `EXECUTION/task-<id>.md` deve atender este contrato:
+
+**O `subtask_prompt` deve ser auto-suficiente**
+
+O subagente recebe **apenas** o `subtask_prompt` + snippets de 2000 chars dos pais. Tudo que ele precisa para implementar **sem inventar** deve estar ali ou na `spec_file`. Inclua:
+
+- Caminho exato dos arquivos a criar/modificar
+- Assinaturas exatas das funções/endpoints (`fn name(params: T) -> R`)
+- Schema de request/response com tipos
+- Validações específicas (não "validar input" — `email: regex /^.../`, `senha: ≥ 8 chars + 1 maiúscula + 1 dígito`)
+- Edge cases enumerados (input vazio, duplicado, expirado, sem permissão)
+- Lista de testes esperados com nome + comportamento
+
+**A `spec_file` (`EXECUTION/task-<id>.md`) deve ter Definition of Done anti-stub:**
+
+```markdown
+## Definition of Done (ANTI-STUB)
+
+- [ ] Nenhum `TODO`, `FIXME`, `XXX` ou `HACK` em arquivos modificados
+- [ ] Nenhuma função vazia (`fn x() {}`, `def x(): pass`, `function x() {}`)
+- [ ] Nenhum `throw new Error('not implemented')`, `unimplemented!()`, `todo!()`, `NotImplementedError`
+- [ ] Nenhum `return null` / `return undefined` / `return {}` como única statement de função pública
+- [ ] Mocks **somente** dentro de `*.test.*`, `*.spec.*`, `__tests__/`, `tests/`, `spec/` — NUNCA em código de produção
+- [ ] Todos os endpoints declarados na seção 3 retornam dados reais (não fixos / hardcoded)
+- [ ] Cada validação da spec produz erro real com status code correto (testado)
+- [ ] Cada edge case da spec tem teste unitário ou integração demonstrando comportamento
+```
+
+**Verificação automatizável:** o agente vai rodar `dare review <id>` antes de marcar DONE. Se a review falhar, a task volta para revisão.
+
+**Sinais de spec rasa** (auto-validar antes de salvar):
+
+- ❌ "Implementar X" — sem assinatura, sem retorno, sem validações
+- ❌ "Tratar erros adequadamente" — quais erros? como? que código?
+- ❌ "Adicionar validações" — quais regras?
+- ✅ "Implementar `POST /auth/login` retornando `{ token: string, refresh: string }` com 200 se credenciais válidas, 401 se inválidas, 429 se rate limit"
+
+### 4. Validar consistência com `EXECUTION/task-*.md`
+
+Se uma spec existe em `DARE/EXECUTION/task-<id>.md`:
+- Mantenha o mesmo `id` no YAML
+- Aponte `spec_file: EXECUTION/task-<id>.md`
+- Se a `complexity` ou `depends_on` mudou, atualize **também** a spec e o
+  `TASKS.md`
+
+Se uma task nova entrou no YAML mas não tem spec:
+- Crie a spec correspondente em `EXECUTION/task-<id>.md`
+
+Se uma task saiu do YAML mas a spec ficou:
+- Pergunte ao usuário: arquivar (mover para `EXECUTION/_archived/`) ou
+  apagar?
+
+### 5. Validar grafo
+
+- Sem ciclos
+- Todos os `depends_on` apontam para `id`s existentes
+- `id`s únicos
+- Pelo menos 2 tasks no rank 0
+
+### 6. Atualizar `DARE/TASKS.md`
+
+Reflita o novo grafo na tabela master.
+
+### 7. Mensagem ao usuário
+
+> `dare-dag.yaml` regenerado:
+> - Total de tasks: N
+> - Ranks paralelos: N
+> - Adicionadas: [...]
+> - Removidas: [...]
+> - Modificadas: [...]
+>
+> Revise e aprove. Para executar: `/dare-dag-run`.
+
+## Quando NÃO usar
+
+- Se você nunca rodou `/dare-blueprint` antes — use `/dare-blueprint` primeiro
+- Se o BLUEPRINT está desatualizado — atualize o BLUEPRINT primeiro
+
+$ARGUMENTS

package/templates/ide/claude/.claude/commands/dare-dag-run.md

@@ -1,109 +1,109 @@
-# /dare-dag-run
-
-Executa o grafo de tasks definido em `DARE/dare-dag.yaml` usando **Claude
-Code como executor** e o CLI `dare` como orquestrador. O canvas ao vivo fica
-em `DARE/.canvas.md`.
-
-> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
-> usuário já está autenticado. O CLI apenas coordena estado, monta prompts
-> e atualiza canvas.
-
-## Pré-requisitos
-
-- `DARE/dare-dag.yaml` existe e foi aprovado
-- Specs em `DARE/EXECUTION/task-<id>.md` geradas
-- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
-
-## Como usar
-
-```
-/dare-dag-run
-/dare-dag-run --task task-003    # executar só uma task específica
-```
-
-## O que fazer
-
-### 1. Validar pré-condições
-
-- Confirme que `DARE/dare-dag.yaml` existe. Se não, oriente
-  `/dare-blueprint` ou `/dare-dag-build`
-- Leia o YAML e verifique sem ciclos, ids únicos, ranks paralelizáveis
-
-### 2. Pegar próximas tasks
-
-```bash
-dare execute --next
-```
-
-O CLI imprime as tasks ready do rank atual com o prompt completo (snippets
-de até 2000 chars dos outputs dos pais já costurados). Use esses prompts.
-
-### 3. Sugerir abrir o canvas
-
-Antes de começar, peça ao usuário abrir `DARE/.canvas.md` em outra aba.
-
-### 4. Executar cada task
-
-Para cada task ready:
-
-1. Leia `spec_file` se houver
-2. Implemente conforme o prompt
-3. Rode Ralph Loop: build → test → lint
-4. Registre o resultado:
-
-```bash
-# Sucesso
-dare execute --complete task-001 --output "Resumo + arquivos criados (paths)"
-
-# Falha
-dare execute --fail task-002 --reason "Mensagem clara da falha"
-```
-
-### 5. Avançar de rank
-
-```bash
-dare execute --next
-```
-
-Se aparece `✅ All tasks resolved`, todas terminaram. Caso contrário, continue.
-
-### 6. Pós-execução
-
-```bash
-dare execute --status
-```
-
-Para retentar tasks FAILED:
-
-```bash
-dare execute --reset task-002
-dare execute --next
-```
-
-## Comandos do orquestrador
-
-| Comando | Função |
-|---------|--------|
-| `dare execute --next` | Próximas tasks ready com prompts compostos |
-| `dare execute --complete <id> --output "…"` | Marca DONE |
-| `dare execute --fail <id> --reason "…"` | Marca FAILED + cascade-skip |
-| `dare execute --reset <id>` | Volta para PENDING |
-| `dare execute --status` | Snapshot do canvas + sumário |
-
-## Erros comuns
-
-| Sintoma | Causa | Correção |
-|---------|-------|----------|
-| `dare-dag.yaml not found` | Não foi gerado | `/dare-blueprint` ou `/dare-dag-build` |
-| Cascata de SKIPPED | Pai falhou | Corrija pai → `--reset` → `--next` |
-| Output truncado | Cap de 4000 chars | Escreva em arquivo, retorne resumo |
-| Spec inconsistente | TASKS.md ≠ dare-dag.yaml | Re-gere com `/dare-dag-build` |
-
-## Referências
-
-- Schema: `DARE/dare-dag.yaml`
-- Canvas: `DARE/.canvas.md`
-- Specs: `DARE/EXECUTION/task-*.md`
-- Status: `DARE/TASKS.md`
-
-$ARGUMENTS
+# /dare-dag-run
+
+Executa o grafo de tasks definido em `DARE/dare-dag.yaml` usando **Claude
+Code como executor** e o CLI `dare` como orquestrador. O canvas ao vivo fica
+em `DARE/.canvas.md`.
+
+> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
+> usuário já está autenticado. O CLI apenas coordena estado, monta prompts
+> e atualiza canvas.
+
+## Pré-requisitos
+
+- `DARE/dare-dag.yaml` existe e foi aprovado
+- Specs em `DARE/EXECUTION/task-<id>.md` geradas
+- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
+
+## Como usar
+
+```
+/dare-dag-run
+/dare-dag-run --task task-003    # executar só uma task específica
+```
+
+## O que fazer
+
+### 1. Validar pré-condições
+
+- Confirme que `DARE/dare-dag.yaml` existe. Se não, oriente
+  `/dare-blueprint` ou `/dare-dag-build`
+- Leia o YAML e verifique sem ciclos, ids únicos, ranks paralelizáveis
+
+### 2. Pegar próximas tasks
+
+```bash
+dare execute --next
+```
+
+O CLI imprime as tasks ready do rank atual com o prompt completo (snippets
+de até 2000 chars dos outputs dos pais já costurados). Use esses prompts.
+
+### 3. Sugerir abrir o canvas
+
+Antes de começar, peça ao usuário abrir `DARE/.canvas.md` em outra aba.
+
+### 4. Executar cada task
+
+Para cada task ready:
+
+1. Leia `spec_file` se houver
+2. Implemente conforme o prompt
+3. Rode Ralph Loop: build → test → lint
+4. Registre o resultado:
+
+```bash
+# Sucesso
+dare execute --complete task-001 --output "Resumo + arquivos criados (paths)"
+
+# Falha
+dare execute --fail task-002 --reason "Mensagem clara da falha"
+```
+
+### 5. Avançar de rank
+
+```bash
+dare execute --next
+```
+
+Se aparece `✅ All tasks resolved`, todas terminaram. Caso contrário, continue.
+
+### 6. Pós-execução
+
+```bash
+dare execute --status
+```
+
+Para retentar tasks FAILED:
+
+```bash
+dare execute --reset task-002
+dare execute --next
+```
+
+## Comandos do orquestrador
+
+| Comando | Função |
+|---------|--------|
+| `dare execute --next` | Próximas tasks ready com prompts compostos |
+| `dare execute --complete <id> --output "…"` | Marca DONE |
+| `dare execute --fail <id> --reason "…"` | Marca FAILED + cascade-skip |
+| `dare execute --reset <id>` | Volta para PENDING |
+| `dare execute --status` | Snapshot do canvas + sumário |
+
+## Erros comuns
+
+| Sintoma | Causa | Correção |
+|---------|-------|----------|
+| `dare-dag.yaml not found` | Não foi gerado | `/dare-blueprint` ou `/dare-dag-build` |
+| Cascata de SKIPPED | Pai falhou | Corrija pai → `--reset` → `--next` |
+| Output truncado | Cap de 4000 chars | Escreva em arquivo, retorne resumo |
+| Spec inconsistente | TASKS.md ≠ dare-dag.yaml | Re-gere com `/dare-dag-build` |
+
+## Referências
+
+- Schema: `DARE/dare-dag.yaml`
+- Canvas: `DARE/.canvas.md`
+- Specs: `DARE/EXECUTION/task-*.md`
+- Status: `DARE/TASKS.md`
+
+$ARGUMENTS