@dewtech/dare-cli 2.16.0 → 3.0.0

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

@@ -0,0 +1,117 @@
+# /dare-dag-runner
+
+Wrapper agregador que cobre **todo o ciclo do DAG** num único comando:
+build do `dare-dag.yaml` (se necessário) → execução de todas as tasks via
+Ralph Loop → opcional visualização final em Excalidraw.
+
+Esta skill existe por **paridade conceitual** com Antigravity e Cursor, que
+consolidam build + run numa única skill chamada `dare-dag-runner`. No Claude
+você também tem os comandos granulares `/dare-dag-build`, `/dare-dag-run` e
+`/dare-dag-viz` caso prefira controle fino.
+
+> **Sem API keys.** Você (Claude Code) usa o plano da IDE/CLI em que o
+> usuário já está autenticado. O CLI `dare` apenas coordena estado, monta
+> prompts e atualiza canvas.
+
+## Como usar
+
+```
+/dare-dag-runner                 # build + run completo, com viz opcional ao final
+/dare-dag-runner --skip-build    # pula build, executa o yaml atual
+/dare-dag-runner --skip-run      # só (re)gera o yaml, não executa
+/dare-dag-runner --viz           # ao final, gera dag-graph.excalidraw
+/dare-dag-runner --task task-003 # executa apenas uma task específica
+```
+
+## Quando usar
+
+- Você quer rodar **todo o ciclo** sem se preocupar com comandos separados
+- Está começando a fase EXECUTE pela primeira vez num projeto
+- Quer paridade com o fluxo do Antigravity/Cursor (1 skill = ciclo completo)
+
+## Quando NÃO usar
+
+- Você quer **só** regerar o yaml (sem executar) → use `/dare-dag-build`
+- Você quer **só** executar o yaml atual (sem regerar) → use `/dare-dag-run`
+- Você quer **só** o diagrama Excalidraw → use `/dare-dag-viz`
+- O BLUEPRINT está desatualizado → atualize primeiro com `/dare-blueprint`
+
+## Pré-requisitos
+
+- `DARE/BLUEPRINT.md` existe e está aprovado (a fase build precisa dele)
+- `dare` disponível no PATH (`npm i -g @dewtech/dare-cli`)
+
+## O que fazer
+
+### Fase 1 — BUILD (se aplicável)
+
+Se o yaml não existe ou está stale (BLUEPRINT mais novo que o yaml),
+execute o procedimento completo de `/dare-dag-build`:
+
+1. Ler `DARE/BLUEPRINT.md`
+2. Ler `DARE/dare-dag.yaml` atual (preservar `id`s)
+3. Gerar o novo `dare-dag.yaml` obedecendo:
+   - `id` em kebab-case e único
+   - `depends_on` mínimo
+   - `subtask_prompt` self-contained
+   - Pelo menos **2 tasks no rank 0**
+   - Cadeia linear é antipattern
+   - `complexity` honesta
+   - ANTI-STUB CONTRACT em cada spec (ver `/dare-dag-build` para detalhes)
+4. Atualizar `DARE/TASKS.md`
+5. **Pedir aprovação ao usuário antes de executar.**
+
+Se `--skip-build` foi passado, pule esta fase.
+
+### Fase 2 — RUN
+
+Executa o procedimento completo de `/dare-dag-run`:
+
+1. Validar pré-condições (yaml existe, sem ciclos, ids únicos)
+2. Sugerir abrir `DARE/.canvas.md` em outra aba
+3. Loop até `✅ All tasks resolved`:
+   - `dare execute --next` para pegar tasks ready do rank atual
+   - Para cada task: ler spec → implementar (sem mock fora de tests, sem TODOs) → Ralph Loop (build/test/lint) → `dare execute --complete <id> --output "..."` ou `--fail <id> --reason "..."`
+4. Pós-execução: `dare execute --status` para sumário final
+
+Se `--skip-run` foi passado, pule esta fase.
+
+### Fase 3 — VIZ (opcional)
+
+Se `--viz` foi passado, ao final gere `DARE/dag-graph.excalidraw` via
+`/dare-dag-viz`: retângulos coloridos por complexidade, swim lanes por
+rank, setas para `depends_on`, status visual (DONE/RUNNING/FAILED).
+
+## Comandos do orquestrador `dare`
+
+| 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 + sumário |
+
+## Mensagem final ao usuário
+
+> Ciclo DAG completo:
+> - Build: N tasks geradas em M ranks (ou "pulado" se --skip-build)
+> - Run: X DONE / Y FAILED / Z SKIPPED
+> - Viz: `DARE/dag-graph.excalidraw` (se --viz)
+>
+> Para retentar falhas: `/dare-dag-run` (ou comando granular).
+
+## Equivalência entre IDEs
+
+| Operação | Antigravity | Claude | Cursor |
+|----------|-------------|--------|--------|
+| Ciclo completo | `dare-dag-runner` | `/dare-dag-runner` (este) | `skill-dag-runner` rule |
+| Só build | `dare-dag-build` | `/dare-dag-build` | `skill-dag-build` rule |
+| Só run | `dare-dag-run` | `/dare-dag-run` | `skill-dag-run` rule + `/run-dag` |
+| Visualizar | `dare-dag-viz` | `/dare-dag-viz` | `/dag-viz` |
+
+## Licença
+
+Esta skill é parte do DARE Method e está sob licença MIT (D-001).
+
+$ARGUMENTS

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

@@ -1,197 +1,197 @@
-# /dare-dag-viz — Visualizar DAG com Excalidraw
-
-Gera diagrama interativo `.excalidraw` a partir do `dare-dag.yaml` atual, com cores semânticas por complexidade e status visual das tasks.
-
-## O que faz
-
-1. **Lê** `DARE/dare-dag.yaml` (grafo de tasks + dependências)
-2. **Mapeia** cada task para um retângulo Excalidraw com:
-   - Cor baseada em `complexity` (LOW=azul, MED=laranja, HIGH=rosa)
-   - Status visual (PENDING/RUNNING/DONE/FAILED)
-   - ID + nome da task
-3. **Agrupa** tasks por `rank` em colunas verticais (swim lanes)
-4. **Cria** setas para cada dependência (`depends_on`)
-5. **Salva** em `DARE/dag-graph.excalidraw`
-
-Output é um arquivo **editável e interativo** — abre direto em https://excalidraw.com.
-
-## Convenções visuais
-
-Referência: `/docs/DESIGN-TOKENS-EXCALIDRAW.md`
-
-**Cores por complexidade:**
-- 🔵 **Azul** (#e3f2fd) = LOW
-- 🟠 **Laranja** (#fff3e0) = MEDIUM
-- 🔴 **Rosa** (#fce4ec) = HIGH
-
-**Status:**
-- ⏳ PENDING = cinza, stroke normal
-- ⚙️ RUNNING = azul, stroke pontilhado
-- ✅ DONE = verde
-- ❌ FAILED = vermelho
-
-**Posicionamento:**
-- Cada task ocupa 120×60px
-- Tasks no mesmo rank ficam lado a lado (swim lane)
-- Setas conectam dependências
-
-## Exemplo de output
-
-Arquivo `DARE/dag-graph.excalidraw` com estrutura:
-
-```
-Rank 1
-├── task-001 (LOW, DONE)
-├── task-002 (HIGH, PENDING)
-
-Rank 2
-├── task-003 (MEDIUM, RUNNING) ← depende de task-001
-├── task-004 (LOW, PENDING) ← depende de task-001
-
-Rank 3
-└── task-005 (HIGH, PENDING) ← depende de task-003 e task-004
-```
-
-## Como usar
-
-### Primeira vez
-
-```bash
-/dare-dag-viz
-```
-
-Claude Code vai:
-1. Ler `DARE/dare-dag.yaml`
-2. Gerar JSON `.excalidraw`
-3. Salvar em `DARE/dag-graph.excalidraw`
-4. Output: "✅ DAG gerado — abra em https://excalidraw.com"
-
-### Atualizar após mudanças
-
-Sempre que você atualiza `dare-dag.yaml`:
-
-```bash
-/dare-dag-viz
-```
-
-Isso regenera o diagrama com as novas tasks/dependências.
-
-### Abrir e editar
-
-1. Acesse https://excalidraw.com
-2. File → Open → selecione `DARE/dag-graph.excalidraw`
-3. Edite livremente:
-   - Mova elementos
-   - Customize cores/textos
-   - Adicione anotações
-4. Salve no mesmo arquivo
-
-Dica: Se editou manualmente e quer regenerar com `dare-dag-viz` de novo, faça backup antes.
-
-## Detalhes técnicos
-
-### Estrutura do JSON gerado
-
-```json
-{
-  "elements": [
-    {
-      "id": "task-001",
-      "type": "rectangle",
-      "x": 20, "y": 20,
-      "width": 120, "height": 60,
-      "backgroundColor": "#e3f2fd",
-      "stroke": "#1976d2",
-      "text": "task-001\nSetup Auth\n[LOW]",
-      "fontSize": 12,
-      "roundness": { "type": 2, "value": 6 }
-    },
-    {
-      "type": "arrow",
-      "startBinding": { "elementId": "task-001" },
-      "endBinding": { "elementId": "task-003" },
-      "stroke": "#999"
-    }
-  ],
-  "appState": {
-    "gridMode": "grid",
-    "gridSize": 20
-  }
-}
-```
-
-### Algoritmo de posicionamento
-
-1. **Calcular ranks** — depth-first do DAG
-   ```
-   rank = 1 + max(rank of dependencies)
-   ```
-
-2. **Agrupar por rank**
-   ```
-   Rank 1: [task-001, task-002]
-   Rank 2: [task-003, task-004]
-   ```
-
-3. **Posicionar**
-   ```
-   x = 20 + (taskIndex * 140)
-   y = 20 + (rank - 1) * 160
-   ```
-
-4. **Desenhar setas**
-   ```
-   Para cada depends_on: arrow(source → target)
-   ```
-
-## Campos esperados em dare-dag.yaml
-
-```yaml
-tasks:
-  task-001:
-    name: "Setup Auth"
-    complexity: "LOW"           # ← determina cor
-    rank: 1                     # ← se não existir, é calculado
-    depends_on: []              # ← usada para setas
-    status: "DONE"              # ← determina stroke/fill
-    subtask_prompt: "..."       # ← (opcional)
-```
-
-**Campos obrigatórios:** `name`, `complexity`  
-**Campos opcionais:** `rank` (calculado), `status` (default PENDING), `depends_on` (default [])
-
-## Troubleshooting
-
-### "File not found: DARE/dare-dag.yaml"
-Certifique-se de que está em um projeto DARE. Se não, rode:
-```bash
-dare discover
-```
-
-### "JSON inválido"
-Valide seu `dare-dag.yaml`:
-```bash
-dare dag validate
-```
-
-### Diagrama muito grande/pequeno
-Abra em Excalidraw e ajuste com Ctrl+Mouse ou pinch zoom.
-
-## Próximos passos
-
-- 🎨 Customize as cores em `docs/DESIGN-TOKENS-EXCALIDRAW.md`
-- 📤 Exporte para PNG com botão "Export to Image" no Excalidraw
-- 🔄 Atualize após cada `dare design` ou `dare execute`
-- 📊 Compartilhe com stakeholders (Excalidraw é colaborativo)
-
-## Referência de design
-
-Ver `/docs/DESIGN-TOKENS-EXCALIDRAW.md` para detalhes de cores, fonts, tamanhos, e créditos.
-
-## Licença
-
-Esta skill é parte do DARE CLI e está sob AGPL v3.
-
-Você pode usar, modificar e compartilhar — mas contribuições voltam ao DARE.
-
-Créditos: Inspiração na [Excalidraw Diagram Skill](https://github.com/coleam00/excalidraw-diagram-skill) por Cole Medin.
+# /dare-dag-viz — Visualizar DAG com Excalidraw
+
+Gera diagrama interativo `.excalidraw` a partir do `dare-dag.yaml` atual, com cores semânticas por complexidade e status visual das tasks.
+
+## O que faz
+
+1. **Lê** `DARE/dare-dag.yaml` (grafo de tasks + dependências)
+2. **Mapeia** cada task para um retângulo Excalidraw com:
+   - Cor baseada em `complexity` (LOW=azul, MED=laranja, HIGH=rosa)
+   - Status visual (PENDING/RUNNING/DONE/FAILED)
+   - ID + nome da task
+3. **Agrupa** tasks por `rank` em colunas verticais (swim lanes)
+4. **Cria** setas para cada dependência (`depends_on`)
+5. **Salva** em `DARE/dag-graph.excalidraw`
+
+Output é um arquivo **editável e interativo** — abre direto em https://excalidraw.com.
+
+## Convenções visuais
+
+Referência: `/docs/DESIGN-TOKENS-EXCALIDRAW.md`
+
+**Cores por complexidade:**
+- 🔵 **Azul** (#e3f2fd) = LOW
+- 🟠 **Laranja** (#fff3e0) = MEDIUM
+- 🔴 **Rosa** (#fce4ec) = HIGH
+
+**Status:**
+- ⏳ PENDING = cinza, stroke normal
+- ⚙️ RUNNING = azul, stroke pontilhado
+- ✅ DONE = verde
+- ❌ FAILED = vermelho
+
+**Posicionamento:**
+- Cada task ocupa 120×60px
+- Tasks no mesmo rank ficam lado a lado (swim lane)
+- Setas conectam dependências
+
+## Exemplo de output
+
+Arquivo `DARE/dag-graph.excalidraw` com estrutura:
+
+```
+Rank 1
+├── task-001 (LOW, DONE)
+├── task-002 (HIGH, PENDING)
+
+Rank 2
+├── task-003 (MEDIUM, RUNNING) ← depende de task-001
+├── task-004 (LOW, PENDING) ← depende de task-001
+
+Rank 3
+└── task-005 (HIGH, PENDING) ← depende de task-003 e task-004
+```
+
+## Como usar
+
+### Primeira vez
+
+```bash
+/dare-dag-viz
+```
+
+Claude Code vai:
+1. Ler `DARE/dare-dag.yaml`
+2. Gerar JSON `.excalidraw`
+3. Salvar em `DARE/dag-graph.excalidraw`
+4. Output: "✅ DAG gerado — abra em https://excalidraw.com"
+
+### Atualizar após mudanças
+
+Sempre que você atualiza `dare-dag.yaml`:
+
+```bash
+/dare-dag-viz
+```
+
+Isso regenera o diagrama com as novas tasks/dependências.
+
+### Abrir e editar
+
+1. Acesse https://excalidraw.com
+2. File → Open → selecione `DARE/dag-graph.excalidraw`
+3. Edite livremente:
+   - Mova elementos
+   - Customize cores/textos
+   - Adicione anotações
+4. Salve no mesmo arquivo
+
+Dica: Se editou manualmente e quer regenerar com `dare-dag-viz` de novo, faça backup antes.
+
+## Detalhes técnicos
+
+### Estrutura do JSON gerado
+
+```json
+{
+  "elements": [
+    {
+      "id": "task-001",
+      "type": "rectangle",
+      "x": 20, "y": 20,
+      "width": 120, "height": 60,
+      "backgroundColor": "#e3f2fd",
+      "stroke": "#1976d2",
+      "text": "task-001\nSetup Auth\n[LOW]",
+      "fontSize": 12,
+      "roundness": { "type": 2, "value": 6 }
+    },
+    {
+      "type": "arrow",
+      "startBinding": { "elementId": "task-001" },
+      "endBinding": { "elementId": "task-003" },
+      "stroke": "#999"
+    }
+  ],
+  "appState": {
+    "gridMode": "grid",
+    "gridSize": 20
+  }
+}
+```
+
+### Algoritmo de posicionamento
+
+1. **Calcular ranks** — depth-first do DAG
+   ```
+   rank = 1 + max(rank of dependencies)
+   ```
+
+2. **Agrupar por rank**
+   ```
+   Rank 1: [task-001, task-002]
+   Rank 2: [task-003, task-004]
+   ```
+
+3. **Posicionar**
+   ```
+   x = 20 + (taskIndex * 140)
+   y = 20 + (rank - 1) * 160
+   ```
+
+4. **Desenhar setas**
+   ```
+   Para cada depends_on: arrow(source → target)
+   ```
+
+## Campos esperados em dare-dag.yaml
+
+```yaml
+tasks:
+  task-001:
+    name: "Setup Auth"
+    complexity: "LOW"           # ← determina cor
+    rank: 1                     # ← se não existir, é calculado
+    depends_on: []              # ← usada para setas
+    status: "DONE"              # ← determina stroke/fill
+    subtask_prompt: "..."       # ← (opcional)
+```
+
+**Campos obrigatórios:** `name`, `complexity`  
+**Campos opcionais:** `rank` (calculado), `status` (default PENDING), `depends_on` (default [])
+
+## Troubleshooting
+
+### "File not found: DARE/dare-dag.yaml"
+Certifique-se de que está em um projeto DARE. Se não, rode:
+```bash
+dare discover
+```
+
+### "JSON inválido"
+Valide seu `dare-dag.yaml`:
+```bash
+dare dag validate
+```
+
+### Diagrama muito grande/pequeno
+Abra em Excalidraw e ajuste com Ctrl+Mouse ou pinch zoom.
+
+## Próximos passos
+
+- 🎨 Customize as cores em `docs/DESIGN-TOKENS-EXCALIDRAW.md`
+- 📤 Exporte para PNG com botão "Export to Image" no Excalidraw
+- 🔄 Atualize após cada `dare design` ou `dare execute`
+- 📊 Compartilhe com stakeholders (Excalidraw é colaborativo)
+
+## Referência de design
+
+Ver `/docs/DESIGN-TOKENS-EXCALIDRAW.md` para detalhes de cores, fonts, tamanhos, e créditos.
+
+## Licença
+
+Esta skill é parte do DARE CLI e está sob licença MIT (D-001).
+
+Você pode usar, modificar, compartilhar e distribuir livremente.
+
+Créditos: Inspiração na [Excalidraw Diagram Skill](https://github.com/coleam00/excalidraw-diagram-skill) por Cole Medin.

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

@@ -1,69 +1,69 @@
-# /dare-design
-
-Gera ou atualiza o `DARE/DESIGN.md` a partir de uma descrição do projeto ou feature.
-
-## Como usar
-
-```
-/dare-design Quero uma API REST de autenticação com JWT e refresh token
-/dare-design Adicionar módulo de pagamentos com Stripe e webhook
-```
-
-## O que fazer
-
-### 1. Leia o contexto atual do projeto
-
-- `package.json` / `composer.json` / `Cargo.toml` / `go.mod` / `requirements.txt` — stack atual
-- Estrutura de pastas existente
-- `DARE/DESIGN.md` se já existir — não sobrescreva sem aprovação explícita do usuário
-
-### 2. Gere `DARE/DESIGN.md` com as seguintes seções obrigatórias
-
-**2.1 Descrição** — 3 a 5 frases claras: o que é, qual problema resolve, quem usa.
-
-**2.2 Objetivos e Métricas de Sucesso** — tabela numerada (O-01, O-02…) com métrica verificável e meta numérica para cada objetivo. Evite objetivos vagos como "melhorar performance" — use "p99 < 200 ms".
-
-**2.3 Stakeholders** — tabela: papel, nome/time, interesse principal.
-
-**2.4 Requisitos Funcionais** — tabela numerada (RF-01, RF-02…) com prioridade MUST/SHOULD/COULD e critério de aceite verificável para cada um.
-
-**2.5 Requisitos Não-Funcionais** — tabela numerada (RNF-01…) cobrindo: performance, disponibilidade, segurança (autenticação, rate limiting, segredos), observabilidade, manutenibilidade.
-
-**2.6 Requisitos de Segurança** — tabela numerada (RS-01…). Inclua **sempre**:
-- RS-01: validação de entrada (OWASP A03)
-- RS-02: proteção de dados sensíveis / hash de senhas (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
-- Adicione requisitos específicos do domínio do projeto
-
-**2.7 Stack Técnica** — tabela por camada com tecnologia e versão.
-
-**2.8 Integrações Externas** — tabela: sistema, tipo, protocolo, direção, dados trocados, responsável. Inclua apenas integrações confirmadas; marque incertas como "A confirmar".
-
-**2.9 Restrições** — prazo, orçamento de infra, limitações técnicas, compliance regulatório.
-
-**2.10 Fora do Escopo (v1)** — lista explícita do que NÃO será feito e o motivo.
-
-**2.11 Riscos e Mitigações** — tabela: risco, probabilidade (Alta/Média/Baixa), impacto (Alto/Médio/Baixo), mitigação concreta.
-
-**2.12 Checklist de Aprovação** — checkboxes para o usuário revisar antes de avançar ao `/dare-blueprint`.
-
-### 3. Use o template em `templates/DESIGN-template.md`
-
-Siga o template fielmente. Não omita seções — use "[A definir]" se a informação não estiver disponível ainda, mas deixe a seção explícita para o usuário preencher.
-
-### 4. Qualidade esperada
-
-O DESIGN.md gerado deve permitir que qualquer engenheiro novo no projeto entenda:
-- **O QUÊ** vai ser construído (requisitos funcionais)
-- **POR QUÊ** (objetivos e métricas)
-- **PARA QUEM** (stakeholders e personas)
-- **O QUE NÃO** vai ser feito (escopo)
-- **QUAIS RISCOS** existem (com mitigação)
-
-### 5. Confirme com o usuário antes de prosseguir
-
-Após gerar o DESIGN.md, apresente um resumo das seções geradas e pergunte se o usuário quer ajustar algo antes de rodar `/dare-blueprint`.
-
-$ARGUMENTS
+# /dare-design
+
+Gera ou atualiza o `DARE/DESIGN.md` a partir de uma descrição do projeto ou feature.
+
+## Como usar
+
+```
+/dare-design Quero uma API REST de autenticação com JWT e refresh token
+/dare-design Adicionar módulo de pagamentos com Stripe e webhook
+```
+
+## O que fazer
+
+### 1. Leia o contexto atual do projeto
+
+- `package.json` / `composer.json` / `Cargo.toml` / `go.mod` / `requirements.txt` — stack atual
+- Estrutura de pastas existente
+- `DARE/DESIGN.md` se já existir — não sobrescreva sem aprovação explícita do usuário
+
+### 2. Gere `DARE/DESIGN.md` com as seguintes seções obrigatórias
+
+**2.1 Descrição** — 3 a 5 frases claras: o que é, qual problema resolve, quem usa.
+
+**2.2 Objetivos e Métricas de Sucesso** — tabela numerada (O-01, O-02…) com métrica verificável e meta numérica para cada objetivo. Evite objetivos vagos como "melhorar performance" — use "p99 < 200 ms".
+
+**2.3 Stakeholders** — tabela: papel, nome/time, interesse principal.
+
+**2.4 Requisitos Funcionais** — tabela numerada (RF-01, RF-02…) com prioridade MUST/SHOULD/COULD e critério de aceite verificável para cada um.
+
+**2.5 Requisitos Não-Funcionais** — tabela numerada (RNF-01…) cobrindo: performance, disponibilidade, segurança (autenticação, rate limiting, segredos), observabilidade, manutenibilidade.
+
+**2.6 Requisitos de Segurança** — tabela numerada (RS-01…). Inclua **sempre**:
+- RS-01: validação de entrada (OWASP A03)
+- RS-02: proteção de dados sensíveis / hash de senhas (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
+- Adicione requisitos específicos do domínio do projeto
+
+**2.7 Stack Técnica** — tabela por camada com tecnologia e versão.
+
+**2.8 Integrações Externas** — tabela: sistema, tipo, protocolo, direção, dados trocados, responsável. Inclua apenas integrações confirmadas; marque incertas como "A confirmar".
+
+**2.9 Restrições** — prazo, orçamento de infra, limitações técnicas, compliance regulatório.
+
+**2.10 Fora do Escopo (v1)** — lista explícita do que NÃO será feito e o motivo.
+
+**2.11 Riscos e Mitigações** — tabela: risco, probabilidade (Alta/Média/Baixa), impacto (Alto/Médio/Baixo), mitigação concreta.
+
+**2.12 Checklist de Aprovação** — checkboxes para o usuário revisar antes de avançar ao `/dare-blueprint`.
+
+### 3. Use o template em `templates/DESIGN-template.md`
+
+Siga o template fielmente. Não omita seções — use "[A definir]" se a informação não estiver disponível ainda, mas deixe a seção explícita para o usuário preencher.
+
+### 4. Qualidade esperada
+
+O DESIGN.md gerado deve permitir que qualquer engenheiro novo no projeto entenda:
+- **O QUÊ** vai ser construído (requisitos funcionais)
+- **POR QUÊ** (objetivos e métricas)
+- **PARA QUEM** (stakeholders e personas)
+- **O QUE NÃO** vai ser feito (escopo)
+- **QUAIS RISCOS** existem (com mitigação)
+
+### 5. Confirme com o usuário antes de prosseguir
+
+Após gerar o DESIGN.md, apresente um resumo das seções geradas e pergunte se o usuário quer ajustar algo antes de rodar `/dare-blueprint`.
+
+$ARGUMENTS