@dewtech/dare-cli 2.17.0 → 3.0.0

package/templates/ide/cursor/.cursor/commands/generate-design.md

@@ -1,35 +1,35 @@
-# Comando: /generate-design
-
-## Descrição
-Inicia o Método DARE (fase Design) gerando `DARE/DESIGN.md` a partir de uma ideia inicial.
-
-## Instruções para o Cursor Composer
-
-1. **Leia o contexto:** `package.json` / `Cargo.toml` / `composer.json` / `go.mod` / `requirements.txt` para identificar a stack atual. Leia `.cursorrules` para entender padrões do projeto. Se `DARE/DESIGN.md` já existir, não sobrescreva sem aprovação explícita.
-
-2. **Leia o template:** `templates/DESIGN-template.md` — siga a estrutura fielmente.
-
-3. **Gere `DARE/DESIGN.md` com as seções obrigatórias:**
-
-   - **Descrição** — 3 a 5 frases: o que é, qual problema resolve, quem usa
-   - **Objetivos e Métricas de Sucesso** — tabela numerada (O-01, O-02…) com métrica verificável e meta numérica
-   - **Stakeholders** — tabela: papel, time, interesse principal
-   - **Requisitos Funcionais** — tabela numerada (RF-01, RF-02…) com prioridade MUST/SHOULD/COULD e critério de aceite
-   - **Requisitos Não-Funcionais** — tabela numerada (RNF-01…): performance, disponibilidade, segurança, observabilidade, manutenibilidade
-   - **Requisitos de Segurança** — tabela numerada (RS-01…). **Sempre inclua:**
-     - RS-01: validação de entrada no servidor (OWASP A03)
-     - RS-02: hash de senhas / proteção de dados sensíveis (OWASP A02)
-     - RS-03: controle de acesso por recurso (OWASP A01)
-     - RS-04: auditoria de dependências sem CVE HIGH/CRITICAL (OWASP A06)
-     - RS-05: secrets via variáveis de ambiente — nunca em código
-     - Requisitos específicos do domínio do projeto
-   - **Stack Técnica** — tabela por camada com versões fixas
-   - **Integrações Externas** — tabela: sistema, tipo, protocolo, direção, dados, responsável
-   - **Restrições** — prazo, orçamento, técnicas, compliance
-   - **Fora do Escopo (v1)** — lista explícita
-   - **Riscos e Mitigações** — tabela com probabilidade, impacto e mitigação concreta
-   - **Checklist de Aprovação** — checkboxes para revisão humana
-
-4. **Qualidade:** O DESIGN.md deve responder claramente: O QUÊ, POR QUÊ, PARA QUEM, O QUE NÃO e QUAIS RISCOS. Use "[A definir]" para informações não disponíveis, mas nunca omita seções.
-
-5. **Salve** `DARE/DESIGN.md` e informe: _"DESIGN.md gerado. Revise as seções, especialmente os Requisitos de Segurança (RS-*) e Riscos. Quando aprovado, execute `/generate-blueprint`."_
+# Comando: /generate-design
+
+## Descrição
+Inicia o Método DARE (fase Design) gerando `DARE/DESIGN.md` a partir de uma ideia inicial.
+
+## Instruções para o Cursor Composer
+
+1. **Leia o contexto:** `package.json` / `Cargo.toml` / `composer.json` / `go.mod` / `requirements.txt` para identificar a stack atual. Leia `.cursorrules` para entender padrões do projeto. Se `DARE/DESIGN.md` já existir, não sobrescreva sem aprovação explícita.
+
+2. **Leia o template:** `templates/DESIGN-template.md` — siga a estrutura fielmente.
+
+3. **Gere `DARE/DESIGN.md` com as seções obrigatórias:**
+
+   - **Descrição** — 3 a 5 frases: o que é, qual problema resolve, quem usa
+   - **Objetivos e Métricas de Sucesso** — tabela numerada (O-01, O-02…) com métrica verificável e meta numérica
+   - **Stakeholders** — tabela: papel, time, interesse principal
+   - **Requisitos Funcionais** — tabela numerada (RF-01, RF-02…) com prioridade MUST/SHOULD/COULD e critério de aceite
+   - **Requisitos Não-Funcionais** — tabela numerada (RNF-01…): performance, disponibilidade, segurança, observabilidade, manutenibilidade
+   - **Requisitos de Segurança** — tabela numerada (RS-01…). **Sempre inclua:**
+     - RS-01: validação de entrada no servidor (OWASP A03)
+     - RS-02: hash de senhas / proteção de dados sensíveis (OWASP A02)
+     - RS-03: controle de acesso por recurso (OWASP A01)
+     - RS-04: auditoria de dependências sem CVE HIGH/CRITICAL (OWASP A06)
+     - RS-05: secrets via variáveis de ambiente — nunca em código
+     - Requisitos específicos do domínio do projeto
+   - **Stack Técnica** — tabela por camada com versões fixas
+   - **Integrações Externas** — tabela: sistema, tipo, protocolo, direção, dados, responsável
+   - **Restrições** — prazo, orçamento, técnicas, compliance
+   - **Fora do Escopo (v1)** — lista explícita
+   - **Riscos e Mitigações** — tabela com probabilidade, impacto e mitigação concreta
+   - **Checklist de Aprovação** — checkboxes para revisão humana
+
+4. **Qualidade:** O DESIGN.md deve responder claramente: O QUÊ, POR QUÊ, PARA QUEM, O QUE NÃO e QUAIS RISCOS. Use "[A definir]" para informações não disponíveis, mas nunca omita seções.
+
+5. **Salve** `DARE/DESIGN.md` e informe: _"DESIGN.md gerado. Revise as seções, especialmente os Requisitos de Segurança (RS-*) e Riscos. Quando aprovado, execute `/generate-blueprint`."_

package/templates/ide/cursor/.cursor/commands/generate-tasks.md

@@ -1,184 +1,184 @@
-# Comando: /generate-tasks
-
-## Descrição
-Avança o Método DARE lendo o Blueprint aprovado e gerando os **três artefatos**
-da fase de execução: `TASKS.md` (visão humana), `dare-dag.yaml` (grafo
-executável pelo CLI) e `EXECUTION/task-<id>.md` (specs detalhadas por task).
-
-## Pré-requisitos
-
-- `DARE/BLUEPRINT.md` aprovado pelo usuário.
-- Você deve seguir as regras de construção do DAG definidas em
-  `.cursor/rules/skill-dag-runner.mdc` — leia antes de gerar.
-
-## Instruções para o Cursor Composer
-
-### 1. Ler o contexto
-
-- Leia `$ARGUMENTS` (geralmente `DARE/BLUEPRINT.md`).
-- Leia os templates: `templates/TASKS-template.md` e `templates/TASK-SPEC-template.md`.
-- Leia `.cursorrules` para convenções do projeto.
-- Leia a skill `skill-dag-runner.mdc` para regras de DAG (depends_on mínimo,
-  complexity, prompt self-contained, output cap 4000, parent context 2000).
-
-### 2. Decompor o Blueprint em tasks atômicas
-
-- Cada fase do Blueprint vira tasks pequenas o suficiente para um único prompt
-  do Composer.
-- Tarefas de segurança (FormRequests, middlewares, Bcrypt, rate limit) devem
-  ter tasks específicas ou estar explícitas nas tasks relevantes.
-- Atribua `complexity` a cada task: LOW / MED / HIGH.
-
-#### Regras inegociáveis de ordenação
-
-1. **A primeira task deve preparar o ambiente local** — Dockerfile +
-   `docker-compose.yml` + healthcheck. Sem isso o Ralph Loop não tem onde
-   rodar build/test/lint. Exceção: projeto que já vive em monorepo
-   containerizado.
-2. **Não crie task "Ralph Loop final" / "Hardening final"** — o Ralph Loop
-   roda automático em cada `dare execute --complete`. Não é uma task; é um
-   gate por task.
-3. **Tests devem ter assertions reais** desde a task que os escreve.
-   Placeholders (`assertTrue(true)` etc.) fazem o gate `test` falhar e a
-   task vai para FAILED.
-
-### 3. Gerar `DARE/TASKS.md` (visão humana)
-
-Tabela com todas as tasks e dependências em formato legível:
-
-```markdown
-| ID       | Título                    | Status      | Depends On       | Complexity |
-|----------|---------------------------|-------------|------------------|------------|
-| task-001 | Setup project structure   | ⏳ PENDING  | —                | LOW        |
-| task-002 | DB migrations             | ⏳ PENDING  | —                | MED        |
-| task-003 | Auth controllers          | ⏳ PENDING  | task-001, 002    | HIGH       |
-```
-
-Inclua: total de tasks, fases agrupadas, tempo estimado, próximos passos.
-
-### 4. Gerar `DARE/dare-dag.yaml` (grafo executável)
-
-Schema canônico (alinhado com `skill-dag-runner.mdc`):
-
-```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: "Setup project structure"
-    depends_on: []
-    complexity: LOW
-    spec_file: EXECUTION/task-001.md
-    subtask_prompt: |
-      Setup base project structure following DARE/BLUEPRINT.md.
-      Create directories: src/, tests/, docs/. Initialize package files.
-      No business logic yet. Validation gate: project builds.
-```
-
-**Regras inegociáveis:**
-- `id` em kebab-case e único.
-- `depends_on` mínimo — só adicione quando a task filha **literalmente** não
-  pode começar sem o output da pai (arquivo, schema, decisão exportada).
-- `subtask_prompt` totalmente self-contained (o subagente recebe só ele +
-  snippets de 2000 chars dos pais).
-- Pelo menos 2 tasks no rank 0 (com `depends_on: []`) para haver paralelismo
-  real.
-- Cadeia linear (`001 → 002 → 003 → ...`) é antipattern. Reanalise.
-
-### 5. Gerar `DARE/EXECUTION/task-<id>.md` (uma spec por task)
-
-Para CADA task em `dare-dag.yaml`, crie a spec correspondente seguindo
-`templates/TASK-SPEC-template.md`:
-
-- **Objetivo** claro
-- **Arquivos a criar/modificar**
-- **Validation Gates** (build, test, lint específicos da stack)
-- **Testes esperados**
-- **Considerações de segurança**
-- **Próxima task** sugerida
-
-O `subtask_prompt` no YAML pode referenciar a spec via
-`spec_file: EXECUTION/task-<id>.md` para que o subagente leia a spec na hora
-de executar.
-
-### 5.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 (`should_reject_duplicate_email_with_409`)
-
-**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 que executar a task 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?
-- ❌ Arquivos listados sem dizer **o que cada um contém**
-- ✅ "Implementar `POST /auth/login` retornando `{ token: string, refresh: string }` com 200 se credenciais válidas, 401 se inválidas, 429 se rate limit"
-
-### 6. Validar consistência dos 3 artefatos
-
-- Mesmos `id`s em `TASKS.md`, `dare-dag.yaml` e `EXECUTION/task-*.md`.
-- Mesmas `depends_on` em `TASKS.md` e `dare-dag.yaml`.
-- Mesmas `complexity`.
-- Sem ciclos.
-
-### 7. Regenerar a visualização do DAG
-
-Depois de salvar o `dare-dag.yaml`, rode:
-
-```bash
-dare dag viz -o DARE/dag-graph.mmd
-```
-
-Isso reescreve `DARE/dag-graph.mmd` (Mermaid) refletindo o grafo atualizado.
-O usuário pode abrir o arquivo no Cursor com a extensão Mermaid Preview.
-
-### 8. Mensagem final ao usuário
-
-> Gerados 4 artefatos da fase de execução:
-> - `DARE/TASKS.md` ([N] tasks, visão humana)
-> - `DARE/dare-dag.yaml` (grafo executável, [N] ranks paralelos)
-> - `DARE/EXECUTION/task-*.md` ([N] specs detalhadas)
-> - `DARE/dag-graph.mmd` (visualização Mermaid do DAG)
->
-> Revise (abra `dag-graph.mmd` para ver o grafo). Para executar:
-> `/run-dag` ou `dare execute --next`.
+# Comando: /generate-tasks
+
+## Descrição
+Avança o Método DARE lendo o Blueprint aprovado e gerando os **três artefatos**
+da fase de execução: `TASKS.md` (visão humana), `dare-dag.yaml` (grafo
+executável pelo CLI) e `EXECUTION/task-<id>.md` (specs detalhadas por task).
+
+## Pré-requisitos
+
+- `DARE/BLUEPRINT.md` aprovado pelo usuário.
+- Você deve seguir as regras de construção do DAG definidas em
+  `.cursor/rules/skill-dag-runner.mdc` — leia antes de gerar.
+
+## Instruções para o Cursor Composer
+
+### 1. Ler o contexto
+
+- Leia `$ARGUMENTS` (geralmente `DARE/BLUEPRINT.md`).
+- Leia os templates: `templates/TASKS-template.md` e `templates/TASK-SPEC-template.md`.
+- Leia `.cursorrules` para convenções do projeto.
+- Leia a skill `skill-dag-runner.mdc` para regras de DAG (depends_on mínimo,
+  complexity, prompt self-contained, output cap 4000, parent context 2000).
+
+### 2. Decompor o Blueprint em tasks atômicas
+
+- Cada fase do Blueprint vira tasks pequenas o suficiente para um único prompt
+  do Composer.
+- Tarefas de segurança (FormRequests, middlewares, Bcrypt, rate limit) devem
+  ter tasks específicas ou estar explícitas nas tasks relevantes.
+- Atribua `complexity` a cada task: LOW / MED / HIGH.
+
+#### Regras inegociáveis de ordenação
+
+1. **A primeira task deve preparar o ambiente local** — Dockerfile +
+   `docker-compose.yml` + healthcheck. Sem isso o Ralph Loop não tem onde
+   rodar build/test/lint. Exceção: projeto que já vive em monorepo
+   containerizado.
+2. **Não crie task "Ralph Loop final" / "Hardening final"** — o Ralph Loop
+   roda automático em cada `dare execute --complete`. Não é uma task; é um
+   gate por task.
+3. **Tests devem ter assertions reais** desde a task que os escreve.
+   Placeholders (`assertTrue(true)` etc.) fazem o gate `test` falhar e a
+   task vai para FAILED.
+
+### 3. Gerar `DARE/TASKS.md` (visão humana)
+
+Tabela com todas as tasks e dependências em formato legível:
+
+```markdown
+| ID       | Título                    | Status      | Depends On       | Complexity |
+|----------|---------------------------|-------------|------------------|------------|
+| task-001 | Setup project structure   | ⏳ PENDING  | —                | LOW        |
+| task-002 | DB migrations             | ⏳ PENDING  | —                | MED        |
+| task-003 | Auth controllers          | ⏳ PENDING  | task-001, 002    | HIGH       |
+```
+
+Inclua: total de tasks, fases agrupadas, tempo estimado, próximos passos.
+
+### 4. Gerar `DARE/dare-dag.yaml` (grafo executável)
+
+Schema canônico (alinhado com `skill-dag-runner.mdc`):
+
+```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: "Setup project structure"
+    depends_on: []
+    complexity: LOW
+    spec_file: EXECUTION/task-001.md
+    subtask_prompt: |
+      Setup base project structure following DARE/BLUEPRINT.md.
+      Create directories: src/, tests/, docs/. Initialize package files.
+      No business logic yet. Validation gate: project builds.
+```
+
+**Regras inegociáveis:**
+- `id` em kebab-case e único.
+- `depends_on` mínimo — só adicione quando a task filha **literalmente** não
+  pode começar sem o output da pai (arquivo, schema, decisão exportada).
+- `subtask_prompt` totalmente self-contained (o subagente recebe só ele +
+  snippets de 2000 chars dos pais).
+- Pelo menos 2 tasks no rank 0 (com `depends_on: []`) para haver paralelismo
+  real.
+- Cadeia linear (`001 → 002 → 003 → ...`) é antipattern. Reanalise.
+
+### 5. Gerar `DARE/EXECUTION/task-<id>.md` (uma spec por task)
+
+Para CADA task em `dare-dag.yaml`, crie a spec correspondente seguindo
+`templates/TASK-SPEC-template.md`:
+
+- **Objetivo** claro
+- **Arquivos a criar/modificar**
+- **Validation Gates** (build, test, lint específicos da stack)
+- **Testes esperados**
+- **Considerações de segurança**
+- **Próxima task** sugerida
+
+O `subtask_prompt` no YAML pode referenciar a spec via
+`spec_file: EXECUTION/task-<id>.md` para que o subagente leia a spec na hora
+de executar.
+
+### 5.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 (`should_reject_duplicate_email_with_409`)
+
+**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 que executar a task 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?
+- ❌ Arquivos listados sem dizer **o que cada um contém**
+- ✅ "Implementar `POST /auth/login` retornando `{ token: string, refresh: string }` com 200 se credenciais válidas, 401 se inválidas, 429 se rate limit"
+
+### 6. Validar consistência dos 3 artefatos
+
+- Mesmos `id`s em `TASKS.md`, `dare-dag.yaml` e `EXECUTION/task-*.md`.
+- Mesmas `depends_on` em `TASKS.md` e `dare-dag.yaml`.
+- Mesmas `complexity`.
+- Sem ciclos.
+
+### 7. Regenerar a visualização do DAG
+
+Depois de salvar o `dare-dag.yaml`, rode:
+
+```bash
+dare dag viz -o DARE/dag-graph.mmd
+```
+
+Isso reescreve `DARE/dag-graph.mmd` (Mermaid) refletindo o grafo atualizado.
+O usuário pode abrir o arquivo no Cursor com a extensão Mermaid Preview.
+
+### 8. Mensagem final ao usuário
+
+> Gerados 4 artefatos da fase de execução:
+> - `DARE/TASKS.md` ([N] tasks, visão humana)
+> - `DARE/dare-dag.yaml` (grafo executável, [N] ranks paralelos)
+> - `DARE/EXECUTION/task-*.md` ([N] specs detalhadas)
+> - `DARE/dag-graph.mmd` (visualização Mermaid do DAG)
+>
+> Revise (abra `dag-graph.mmd` para ver o grafo). Para executar:
+> `/run-dag` ou `dare execute --next`.

package/templates/ide/cursor/.cursor/commands/refine-task.md

@@ -1,107 +1,107 @@
-# Comando: /refine-task
-
-## Descrição
-
-Analisa a complexidade de uma task e, quando alta, **quebra em sub-tasks menores** com escopo bem delimitado. Pode ser chamada:
-
-- Automaticamente pela skill `/generate-tasks` após gerar o DAG (para cada task ≥ MED)
-- Manualmente pelo dev: `/refine-task task-034`
-- Após mudança de escopo: quando o BLUEPRINT mudou e uma task ficou grande
-
-A camada determinística (heurística de complexidade) é feita pelo CLI: `dare refine <id>`. Este comando adiciona a camada **semântica** — você lê a spec, decide se a quebra é necessária e produz sub-tasks coerentes.
-
-## Instruções para o Cursor Composer
-
-### 1. Rodar a heurística determinística
-
-```bash
-dare refine $ARGUMENTS --split --format json > .dare/refine-$ARGUMENTS.json
-```
-
-Esse JSON traz:
-- `report.score`, `report.level` (LOW/MED/HIGH/CRITICAL)
-- `report.signals` — explica a pontuação
-- `report.recommendsSplit` — true se HIGH/CRITICAL
-- `proposal.subtasks` — quebra inicial coarse (por diretório)
-
-### 2. Decidir se vale quebrar
-
-**Quebrar quando:**
-- `recommendsSplit: true` (HIGH/CRITICAL)
-- Mais de 6 arquivos a criar/modificar
-- Mistura responsabilidades (modelo + controller + teste + migration)
-- Inclui refactor + feature juntos
-- Keyword "pesada" (refactor/migrate/integrate) + score MED+
-
-**Manter inteira quando:**
-- LOW ou MED baixo
-- Todos arquivos no mesmo módulo
-- Cabe em uma conversa do Composer (15–60 min)
-
-### 3. Se quebrar — eixos de split
-
-| Eixo | Quando |
-|---|---|
-| **Por camada** | Modelo / Controller / Service / Test separados |
-| **Por endpoint** | 4 endpoints REST → 4 sub-tasks |
-| **Por feature** | Auth = register + login + refresh → split por verbo |
-| **Refactor + feature** | "1. refactor X" + "2. feature Y em cima" |
-| **Migration + código** | "1. migration + seeds" + "2. código novo" |
-
-Cada sub-task precisa de:
-- `subtask_prompt` auto-suficiente (Anti-Stub Contract!)
-- spec própria em `DARE/EXECUTION/<sub-id>.md`
-- `depends_on` mínimo mas correto
-- complexity honesta — se sub ainda for HIGH, quebrar de novo
-
-### 4. Emitir verdito
-
-`.dare/refine-verdict-$ARGUMENTS.json`:
-
-```json
-{
-  "manageable": false,
-  "reasons": ["Score 18 (HIGH) — 7 endpoints + migration", "Mistura refactor com features novas"],
-  "proposedSubtasks": [
-    {
-      "id": "task-034a",
-      "title": "Refactor UserService",
-      "files": ["src/services/UserService.ts", "tests/services/UserService.test.ts"],
-      "rationale": "Refactor isolado antes da feature",
-      "estimatedLevel": "MED"
-    }
-  ]
-}
-```
-
-Se manuseável:
-
-```json
-{
-  "manageable": true,
-  "reasons": ["Score 7 (MED), 4 arquivos mesmo módulo, 6 testes"]
-}
-```
-
-### 5. Aplicar o split
-
-1. Edite `DARE/dare-dag.yaml` substituindo a task pelas sub-tasks
-2. Crie as specs em `DARE/EXECUTION/<sub-id>.md` (template + Anti-Stub Contract)
-3. Atualize `DARE/TASKS.md` (visão humana)
-4. Regenere Mermaid: `dare dag viz -o DARE/dag-graph.mmd`
-5. Marque a task original como SPLIT no TASKS.md
-
-### 6. Mensagem ao usuário
-
-Manuseável:
-> ✅ Task `$ARGUMENTS` está bem-dimensionada (score X, level Y). Sem split.
-
-Quebrada:
-> 🪓 Task `$ARGUMENTS` quebrada em N sub-tasks: [lista]. Revise com `dare validate` e `dare dag viz`.
-
-## Regras inegociáveis
-
-- Não quebrar tasks LOW
-- Não inventar dependências falsas
-- Cada sub-task testável independentemente
-- Anti-Stub Contract aplica em cada sub-task
+# Comando: /refine-task
+
+## Descrição
+
+Analisa a complexidade de uma task e, quando alta, **quebra em sub-tasks menores** com escopo bem delimitado. Pode ser chamada:
+
+- Automaticamente pela skill `/generate-tasks` após gerar o DAG (para cada task ≥ MED)
+- Manualmente pelo dev: `/refine-task task-034`
+- Após mudança de escopo: quando o BLUEPRINT mudou e uma task ficou grande
+
+A camada determinística (heurística de complexidade) é feita pelo CLI: `dare refine <id>`. Este comando adiciona a camada **semântica** — você lê a spec, decide se a quebra é necessária e produz sub-tasks coerentes.
+
+## Instruções para o Cursor Composer
+
+### 1. Rodar a heurística determinística
+
+```bash
+dare refine $ARGUMENTS --split --format json > .dare/refine-$ARGUMENTS.json
+```
+
+Esse JSON traz:
+- `report.score`, `report.level` (LOW/MED/HIGH/CRITICAL)
+- `report.signals` — explica a pontuação
+- `report.recommendsSplit` — true se HIGH/CRITICAL
+- `proposal.subtasks` — quebra inicial coarse (por diretório)
+
+### 2. Decidir se vale quebrar
+
+**Quebrar quando:**
+- `recommendsSplit: true` (HIGH/CRITICAL)
+- Mais de 6 arquivos a criar/modificar
+- Mistura responsabilidades (modelo + controller + teste + migration)
+- Inclui refactor + feature juntos
+- Keyword "pesada" (refactor/migrate/integrate) + score MED+
+
+**Manter inteira quando:**
+- LOW ou MED baixo
+- Todos arquivos no mesmo módulo
+- Cabe em uma conversa do Composer (15–60 min)
+
+### 3. Se quebrar — eixos de split
+
+| Eixo | Quando |
+|---|---|
+| **Por camada** | Modelo / Controller / Service / Test separados |
+| **Por endpoint** | 4 endpoints REST → 4 sub-tasks |
+| **Por feature** | Auth = register + login + refresh → split por verbo |
+| **Refactor + feature** | "1. refactor X" + "2. feature Y em cima" |
+| **Migration + código** | "1. migration + seeds" + "2. código novo" |
+
+Cada sub-task precisa de:
+- `subtask_prompt` auto-suficiente (Anti-Stub Contract!)
+- spec própria em `DARE/EXECUTION/<sub-id>.md`
+- `depends_on` mínimo mas correto
+- complexity honesta — se sub ainda for HIGH, quebrar de novo
+
+### 4. Emitir verdito
+
+`.dare/refine-verdict-$ARGUMENTS.json`:
+
+```json
+{
+  "manageable": false,
+  "reasons": ["Score 18 (HIGH) — 7 endpoints + migration", "Mistura refactor com features novas"],
+  "proposedSubtasks": [
+    {
+      "id": "task-034a",
+      "title": "Refactor UserService",
+      "files": ["src/services/UserService.ts", "tests/services/UserService.test.ts"],
+      "rationale": "Refactor isolado antes da feature",
+      "estimatedLevel": "MED"
+    }
+  ]
+}
+```
+
+Se manuseável:
+
+```json
+{
+  "manageable": true,
+  "reasons": ["Score 7 (MED), 4 arquivos mesmo módulo, 6 testes"]
+}
+```
+
+### 5. Aplicar o split
+
+1. Edite `DARE/dare-dag.yaml` substituindo a task pelas sub-tasks
+2. Crie as specs em `DARE/EXECUTION/<sub-id>.md` (template + Anti-Stub Contract)
+3. Atualize `DARE/TASKS.md` (visão humana)
+4. Regenere Mermaid: `dare dag viz -o DARE/dag-graph.mmd`
+5. Marque a task original como SPLIT no TASKS.md
+
+### 6. Mensagem ao usuário
+
+Manuseável:
+> ✅ Task `$ARGUMENTS` está bem-dimensionada (score X, level Y). Sem split.
+
+Quebrada:
+> 🪓 Task `$ARGUMENTS` quebrada em N sub-tasks: [lista]. Revise com `dare validate` e `dare dag viz`.
+
+## Regras inegociáveis
+
+- Não quebrar tasks LOW
+- Não inventar dependências falsas
+- Cada sub-task testável independentemente
+- Anti-Stub Contract aplica em cada sub-task