@dewtech/dare-cli 2.4.0 → 2.5.0

package/dist/utils/stack-bootstrap.js

@@ -0,0 +1,334 @@
+/**
+ * Stack bootstrap — runs the official scaffold for the chosen backend /
+ * frontend / MCP stack. Called by `dare init` BEFORE the DARE artifacts are
+ * copied on top.
+ *
+ * No fallbacks: if the required tool (composer / npm / cargo / python) is not
+ * on PATH, this module throws a clear error pointing to install instructions.
+ * Generating a fake skeleton is what got us into trouble before — we don't
+ * do that anymore.
+ */
+import { spawn } from 'node:child_process';
+import path from 'node:path';
+import fs from 'fs-extra';
+import chalk from 'chalk';
+// ─── Public API ─────────────────────────────────────────────────────────────
+export async function bootstrapBackend(opts) {
+    switch (opts.stack) {
+        case 'php-laravel':
+            return bootstrapPhpLaravel(opts.dir, opts.projectName);
+        case 'node-nestjs':
+            return bootstrapNodeNestjs(opts.dir, opts.projectName);
+        case 'python-fastapi':
+            return bootstrapPythonFastapi(opts.dir);
+        case 'rust-axum':
+            return bootstrapRustAxum(opts.dir, opts.projectName);
+        case 'go-gin':
+            return bootstrapGoGin(opts.dir, opts.projectName);
+        default:
+            throw new Error(`Unknown backend stack: ${opts.stack}`);
+    }
+}
+export async function bootstrapFrontend(opts) {
+    switch (opts.stack) {
+        case 'react':
+            return bootstrapVite(opts.dir, 'react-ts');
+        case 'vue':
+            return bootstrapVite(opts.dir, 'vue-ts');
+        default:
+            throw new Error(`Unknown frontend stack: ${opts.stack}`);
+    }
+}
+export async function bootstrapMcp(opts) {
+    switch (opts.language) {
+        case 'node-ts':
+            return bootstrapMcpNode(opts.dir, opts.projectName);
+        case 'python':
+            return bootstrapMcpPython(opts.dir);
+        default:
+            throw new Error(`Unknown MCP language: ${opts.language}`);
+    }
+}
+// ─── Per-stack scaffolds ────────────────────────────────────────────────────
+async function bootstrapPhpLaravel(dir, projectName) {
+    await ensureCommand('composer', 'Install Composer: https://getcomposer.org/download/');
+    banner(`Bootstrapping Laravel 11 in ${dir}`);
+    await runCmd('composer', [
+        'create-project',
+        'laravel/laravel:^11',
+        '.',
+        '--no-interaction',
+        '--prefer-dist',
+    ], dir);
+    await runCmd('composer', ['require', 'laravel/sanctum', 'tymon/jwt-auth', '--no-interaction'], dir);
+    await runCmd('composer', [
+        'require',
+        '--dev',
+        'laravel/pint',
+        'larastan/larastan',
+        '--no-interaction',
+    ], dir);
+    // Best-effort: rename app to projectName in composer.json
+    await tryRenameComposerProject(dir, projectName);
+}
+async function bootstrapNodeNestjs(dir, projectName) {
+    await ensureCommand('npx', 'Install Node.js (includes npx): https://nodejs.org/');
+    banner(`Bootstrapping NestJS in ${dir}`);
+    await runCmd('npx', [
+        '-y',
+        '@nestjs/cli@latest',
+        'new',
+        '.',
+        '--skip-git',
+        '--strict',
+        '--package-manager',
+        'npm',
+        '--directory',
+        '.',
+    ], dir);
+    await tryRenameNpmProject(dir, projectName);
+}
+async function bootstrapPythonFastapi(dir) {
+    await ensureCommand('python', 'Install Python 3.11+ from https://www.python.org/downloads/');
+    banner(`Bootstrapping FastAPI in ${dir}`);
+    // Create virtualenv
+    await runCmd('python', ['-m', 'venv', '.venv'], dir);
+    // Write a starter requirements.txt + main.py if not present (since FastAPI
+    // has no official scaffold). The DARE template copy will overwrite later
+    // only if we left placeholders here.
+    const reqPath = path.join(dir, 'requirements.txt');
+    if (!(await fs.pathExists(reqPath))) {
+        await fs.writeFile(reqPath, [
+            'fastapi>=0.115',
+            'uvicorn[standard]>=0.30',
+            'pydantic-settings>=2.4',
+            'sqlalchemy>=2.0',
+            'alembic>=1.13',
+            'asyncpg>=0.29',
+            'python-jose[cryptography]>=3.3',
+            'passlib[bcrypt]>=1.7',
+            'pytest>=8.0',
+            'pytest-asyncio>=0.23',
+            'ruff>=0.6',
+            '',
+        ].join('\n'));
+    }
+    // pip install
+    const pip = path.join(dir, '.venv', process.platform === 'win32' ? 'Scripts\\pip.exe' : 'bin/pip');
+    await runCmd(pip, ['install', '--upgrade', 'pip'], dir);
+    await runCmd(pip, ['install', '-r', 'requirements.txt'], dir);
+}
+async function bootstrapRustAxum(dir, projectName) {
+    await ensureCommand('cargo', 'Install Rust toolchain: https://www.rust-lang.org/tools/install');
+    banner(`Bootstrapping Rust + Axum in ${dir}`);
+    await runCmd('cargo', ['init', '--name', sanitizeCrateName(projectName)], dir);
+    // Replace generated Cargo.toml with axum-ready dependencies.
+    const cargoToml = path.join(dir, 'Cargo.toml');
+    await fs.writeFile(cargoToml, [
+        `[package]`,
+        `name = "${sanitizeCrateName(projectName)}"`,
+        `version = "0.1.0"`,
+        `edition = "2021"`,
+        ``,
+        `[dependencies]`,
+        `axum = "0.7"`,
+        `tokio = { version = "1.40", features = ["full"] }`,
+        `tower = "0.5"`,
+        `tower-http = { version = "0.6", features = ["cors", "trace"] }`,
+        `serde = { version = "1.0", features = ["derive"] }`,
+        `serde_json = "1.0"`,
+        `tracing = "0.1"`,
+        `tracing-subscriber = { version = "0.3", features = ["env-filter"] }`,
+        `thiserror = "1.0"`,
+        `anyhow = "1.0"`,
+        `uuid = { version = "1.10", features = ["v4", "serde"] }`,
+        `sqlx = { version = "0.8", features = ["runtime-tokio", "postgres", "uuid", "chrono"] }`,
+        ``,
+        `[dev-dependencies]`,
+        `tokio = { version = "1.40", features = ["macros", "rt-multi-thread"] }`,
+        ``,
+    ].join('\n'));
+    // Pre-fetch dependencies so first build is faster.
+    await runCmd('cargo', ['fetch'], dir);
+}
+async function bootstrapGoGin(dir, projectName) {
+    await ensureCommand('go', 'Install Go 1.22+: https://go.dev/dl/');
+    banner(`Bootstrapping Go + Gin in ${dir}`);
+    const moduleName = sanitizeGoModule(projectName);
+    // 1) Initialize module
+    await runCmd('go', ['mod', 'init', moduleName], dir);
+    // 2) Add core deps
+    await runCmd('go', ['get', 'github.com/gin-gonic/gin@latest'], dir);
+    await runCmd('go', ['get', 'github.com/joho/godotenv@latest'], dir);
+    // 3) Lay down a working starter so go build / go test / go vet have
+    //    something to compile against. Without this, `go vet ./...` would
+    //    succeed trivially with zero packages and the Ralph Loop would be
+    //    a no-op until the agent writes code.
+    await fs.ensureDir(path.join(dir, 'cmd', 'api'));
+    await fs.ensureDir(path.join(dir, 'internal', 'handlers'));
+    await fs.ensureDir(path.join(dir, 'internal', 'middleware'));
+    await fs.writeFile(path.join(dir, 'cmd', 'api', 'main.go'), `package main
+
+import (
+\t"log"
+\t"os"
+
+\t"github.com/gin-gonic/gin"
+\t"${moduleName}/internal/handlers"
+)
+
+func main() {
+\tr := gin.Default()
+
+\tr.GET("/healthz", handlers.Health)
+
+\tv1 := r.Group("/api/v1")
+\t{
+\t\tv1.GET("/", func(c *gin.Context) {
+\t\t\tc.JSON(200, gin.H{"message": "API v1"})
+\t\t})
+\t}
+
+\tport := os.Getenv("PORT")
+\tif port == "" {
+\t\tport = "8080"
+\t}
+\tif err := r.Run(":" + port); err != nil {
+\t\tlog.Fatal(err)
+\t}
+}
+`);
+    await fs.writeFile(path.join(dir, 'internal', 'handlers', 'health.go'), `package handlers
+
+import (
+\t"net/http"
+
+\t"github.com/gin-gonic/gin"
+)
+
+// Health returns 200 with a small status payload.
+func Health(c *gin.Context) {
+\tc.JSON(http.StatusOK, gin.H{"status": "ok"})
+}
+`);
+    await fs.writeFile(path.join(dir, 'internal', 'handlers', 'health_test.go'), `package handlers
+
+import (
+\t"net/http"
+\t"net/http/httptest"
+\t"testing"
+
+\t"github.com/gin-gonic/gin"
+)
+
+func TestHealth(t *testing.T) {
+\tgin.SetMode(gin.TestMode)
+\tr := gin.New()
+\tr.GET("/healthz", Health)
+
+\treq := httptest.NewRequest(http.MethodGet, "/healthz", nil)
+\trec := httptest.NewRecorder()
+\tr.ServeHTTP(rec, req)
+
+\tif rec.Code != http.StatusOK {
+\t\tt.Fatalf("expected 200, got %d", rec.Code)
+\t}
+}
+`);
+    // 4) Tidy go.mod and resolve transitive deps
+    await runCmd('go', ['mod', 'tidy'], dir);
+}
+async function bootstrapVite(dir, template) {
+    await ensureCommand('npm', 'Install Node.js: https://nodejs.org/');
+    banner(`Bootstrapping Vite (${template}) in ${dir}`);
+    // `npm create vite@latest . -- --template react-ts` requires the directory
+    // to be empty. We're being called from `dare init`, which created an empty
+    // directory, so this is fine.
+    await runCmd('npm', ['create', 'vite@latest', '.', '--', '--template', template], dir);
+    await runCmd('npm', ['install'], dir);
+}
+async function bootstrapMcpNode(dir, projectName) {
+    await ensureCommand('npm', 'Install Node.js: https://nodejs.org/');
+    banner(`Bootstrapping MCP server (TypeScript) in ${dir}`);
+    await runCmd('npm', ['init', '-y'], dir);
+    await runCmd('npm', ['install', '@modelcontextprotocol/sdk'], dir);
+    await runCmd('npm', ['install', '--save-dev', 'typescript', '@types/node', 'tsx', 'vitest'], dir);
+    await tryRenameNpmProject(dir, projectName);
+}
+async function bootstrapMcpPython(dir) {
+    await ensureCommand('python', 'Install Python 3.11+: https://www.python.org/downloads/');
+    banner(`Bootstrapping MCP server (Python) in ${dir}`);
+    await runCmd('python', ['-m', 'venv', '.venv'], dir);
+    const pip = path.join(dir, '.venv', process.platform === 'win32' ? 'Scripts\\pip.exe' : 'bin/pip');
+    await runCmd(pip, ['install', '--upgrade', 'pip'], dir);
+    await runCmd(pip, ['install', 'mcp[cli]', 'pytest', 'ruff'], dir);
+}
+// ─── Helpers ────────────────────────────────────────────────────────────────
+function banner(msg) {
+    console.log(chalk.blue.bold(`\n📦 ${msg}\n`));
+}
+async function ensureCommand(cmd, hint) {
+    const exists = await hasCommand(cmd);
+    if (!exists) {
+        throw new Error(`Required tool not found on PATH: ${cmd}\n  ${hint}\n` +
+            `dare init requires a working ${cmd} to scaffold the chosen stack.`);
+    }
+}
+async function hasCommand(cmd) {
+    return new Promise((resolve) => {
+        const probe = spawn(cmd, ['--version'], { shell: true, stdio: 'ignore' });
+        probe.on('error', () => resolve(false));
+        probe.on('close', (code) => resolve(code === 0));
+    });
+}
+async function runCmd(cmd, args, cwd) {
+    console.log(chalk.gray(`  $ ${cmd} ${args.join(' ')}`));
+    await new Promise((resolve, reject) => {
+        const proc = spawn(cmd, args, {
+            cwd,
+            stdio: 'inherit',
+            shell: true,
+        });
+        proc.on('error', (err) => reject(err));
+        proc.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${cmd} ${args.join(' ')} exited with code ${code}`));
+        });
+    });
+}
+function sanitizeCrateName(name) {
+    return name.toLowerCase().replace(/[^a-z0-9_]+/g, '_').replace(/^_+|_+$/g, '') || 'app';
+}
+function sanitizeGoModule(name) {
+    // Go module path: lowercase, hyphens allowed, no spaces or symbols.
+    return name.toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/^-+|-+$/g, '') || 'app';
+}
+async function tryRenameComposerProject(dir, projectName) {
+    const cj = path.join(dir, 'composer.json');
+    if (!(await fs.pathExists(cj)))
+        return;
+    try {
+        const data = await fs.readJson(cj);
+        data.name = `dare/${projectName.toLowerCase().replace(/[^a-z0-9-]+/g, '-')}`;
+        await fs.writeJson(cj, data, { spaces: 4 });
+    }
+    catch {
+        // non-critical
+    }
+}
+async function tryRenameNpmProject(dir, projectName) {
+    const pj = path.join(dir, 'package.json');
+    if (!(await fs.pathExists(pj)))
+        return;
+    try {
+        const data = await fs.readJson(pj);
+        data.name = projectName.toLowerCase().replace(/[^a-z0-9-]+/g, '-');
+        await fs.writeJson(pj, data, { spaces: 2 });
+    }
+    catch {
+        // non-critical
+    }
+}
+//# sourceMappingURL=stack-bootstrap.js.map

package/dist/utils/stack-bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-bootstrap.js","sourceRoot":"","sources":["../../src/utils/stack-bootstrap.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dewtech/dare-cli",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "description": "DARE Framework - CLI, GraphRAG engine, MCP server and shared types in a single package",
   "type": "module",
   "main": "./dist/index.js",

package/templates/ide/antigravity/.agents/skills/dare-dag-runner/SKILL.md

@@ -81,12 +81,20 @@ tasks:
 2. Para cada prompt:
      - leia spec_file se houver
      - implemente
-     - rode build/test/lint (Ralph Loop)
 3. dare execute --complete <id> --output "<resumo + arquivos tocados>"
-   (ou --fail <id> --reason "..." se falhou)
+     ↓ o CLI roda o RALPH LOOP automático (build → test → lint)
+     ↓ se passar: task vira DONE
+     ↓ se falhar: task vira FAILED com stderr capturado; corrija e retente
 4. Volte ao passo 1 até não haver mais tasks ready
 ```
 
+> **Ralph Loop é AUTOMÁTICO e OBRIGATÓRIO.** Você NÃO roda build/test/lint
+> manualmente — o `dare execute --complete` faz isso. Se algum gate falhar,
+> a task NÃO vai para DONE; vai para FAILED. Corrija e retente.
+>
+> **Não existe flag para pular o Ralph Loop.** Toda task passa pelos 3 gates
+> da stack do projeto.
+
 Comandos úteis:
 
 ```bash
@@ -164,6 +172,23 @@ O CLI reescreve a cada `--complete`/`--fail`:
 | Tudo em rank 0 | Adicione deps reais quando há contenção |
 | Cadeia linear | Reveja se as deps são necessárias |
 
+## Antipatterns que você NÃO deve criar
+
+- ❌ Task **"Ralph Loop final"** / **"Hardening"** / **"QA"** — gate é por task
+- ❌ Tests com `assertTrue(true)` — o gate `test` roda de verdade
+- ❌ "Setup project structure" antes de containerizar o app
+
+## Ordem recomendada das primeiras tasks
+
+1. **Containerize app** (Dockerfile + docker-compose + healthcheck)
+2. **Database schema** (migrations + factories)
+3. **Core endpoints / componentes**
+4. **Auth / autorização**
+5. **Test suite real** (assertions de verdade)
+
+A task de container/compose pode estar em outra ordem para projetos sem
+DB ou em monorepo já containerizado. Mas quase sempre é uma das primeiras.
+
 ## Checklist antes de aprovar
 
 - [ ] Pelo menos 2 tasks no rank 0
@@ -172,4 +197,7 @@ O CLI reescreve a cada `--complete`/`--fail`:
 - [ ] `complexity` reflete o esforço real
 - [ ] `id` em kebab-case e único
 - [ ] Sem ciclos
+- [ ] **Sem task de "Ralph Loop final"** — gate é por task
+- [ ] **Tests com assertions reais** — placeholder quebra o gate
+- [ ] Container/runtime resolvido cedo
 - [ ] Os 3 artefatos consistentes

package/templates/ide/antigravity/.agents/skills/dare-tasks/SKILL.md

@@ -182,14 +182,28 @@ Antes de entregar, confirme:
 - [ ] Pelo menos 2 tasks no rank 0
 - [ ] Cada `subtask_prompt` é executável sem contexto adicional
 
-### Passo 7: Pedir aprovação
+### Passo 7: Regenerar a visualização do DAG
 
-> Gerados os 3 artefatos da fase de execução:
+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 Antigravity para visualizar o grafo
+estático com cores por status antes de executar.
+
+### Passo 8: Pedir aprovação
+
+> Gerados os 4 artefatos da fase de execução:
 > - `DARE/TASKS.md` ([N] tasks)
 > - `DARE/dare-dag.yaml` ([N] ranks paralelos)
 > - `DARE/EXECUTION/task-*.md` ([N] specs)
+> - `DARE/dag-graph.mmd` (visualização Mermaid do DAG)
 >
-> Revise. Quando aprovar, execute: `dare execute --parallel --runner antigravity`.
+> Revise (abra `dag-graph.mmd` para ver o grafo). Quando aprovar:
+> `dare execute --next` para iniciar a execução.
 
 ## Boas práticas
 

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

@@ -71,6 +71,12 @@ tasks:
 - `complexity` honesta: `HIGH` só para lógica crítica/segurança
 - Output cap de 4000 chars: se a task gera muito, escreva em arquivo e
   retorne só resumo + caminhos
+- **A primeira task deve containerizar a aplicação** (Dockerfile + compose
+  + healthcheck) — sem isso o Ralph Loop automático não tem onde rodar
+- **NÃO crie task "Ralph Loop final" / "Hardening" / "QA final"** — o
+  Ralph Loop roda em CADA `dare execute --complete`, automaticamente
+- **Tests com assertions reais** — `assertTrue(true)` quebra o gate `test`
+  e a task vai para FAILED
 
 ### 4. Gerar `DARE/TASKS.md` (visão humana)
 
@@ -115,9 +121,22 @@ Antes de entregar:
 - [ ] Pelo menos 2 tasks no rank 0
 - [ ] Cada `subtask_prompt` executável sem contexto adicional
 
-### 7. Aguardar aprovação humana
+### 7. Regenerar a visualização do DAG
 
-**Não execute nenhuma task** até o usuário revisar e aprovar os 4 artefatos.
+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 no editor com Markdown Preview Mermaid para ver o
+grafo estático com cores por status antes de executar.
+
+### 8. Aguardar aprovação humana
+
+**Não execute nenhuma task** até o usuário revisar e aprovar os 5 artefatos
+(BLUEPRINT, TASKS, dare-dag.yaml, EXECUTION/task-*, dag-graph.mmd).
 
 ## Templates disponíveis
 

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

@@ -29,6 +29,19 @@ executável pelo CLI) e `EXECUTION/task-<id>.md` (specs detalhadas por task).
   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:
@@ -106,12 +119,24 @@ de executar.
 - Mesmas `complexity`.
 - Sem ciclos.
 
-### 7. Mensagem final ao usuário
+### 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 3 artefatos da fase de execução:
+> 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. Para executar tudo em paralelo: `/run-dag` ou `dare execute --parallel`.
-> Para uma task isolada: `/execute-task task-001`.
+> Revise (abra `dag-graph.mmd` para ver o grafo). Para executar:
+> `/run-dag` ou `dare execute --next`.

package/templates/ide/cursor/.cursor/rules/skill-dag-runner.mdc

@@ -76,12 +76,22 @@ tasks:
 2. Para cada prompt:
      - leia spec_file se houver
      - implemente
-     - rode build/test/lint (Ralph Loop)
 3. dare execute --complete <id> --output "<resumo + arquivos tocados>"
-   (ou --fail <id> --reason "..." se falhou)
+     ↓ o CLI roda o RALPH LOOP automático (build → test → lint)
+     ↓ se passar: task vira DONE
+     ↓ se falhar: task vira FAILED com stderr capturado; corrija e retente
 4. Volte ao passo 1 até não haver mais tasks ready
 ```
 
+> **Ralph Loop é AUTOMÁTICO e OBRIGATÓRIO.** Você NÃO roda build/test/lint
+> manualmente — o `dare execute --complete` faz isso. Se algum gate falhar,
+> a task NÃO vai para DONE; vai para FAILED. Você corrige o código e tenta
+> de novo (`dare execute --complete <id>` outra vez, ou `--reset` antes se
+> precisar zerar histórico).
+>
+> **Não existe flag para pular o Ralph Loop.** Toda task passa pelos 3 gates
+> da stack do projeto.
+
 Comandos úteis:
 
 ```bash
@@ -175,6 +185,28 @@ nada; o CLI cuida do cascade.
 | Tudo em rank 0 | Conflito de escrita no mesmo arquivo | Adicione `depends_on` quando há contenção |
 | Cadeia linear longa | Sem ganho de paralelismo | Reveja se as deps são reais |
 
+## Antipatterns que você NÃO deve criar
+
+- ❌ Task chamada **"Ralph Loop final"**, **"Hardening final"**, **"QA final"**
+  — Ralph Loop roda automaticamente em cada `--complete`. Não é uma task.
+- ❌ Tests com `assertTrue(true)` ou equivalentes — o gate `test` vai rodar
+  de verdade. Placeholder não engana o CLI; só atrasa o ciclo.
+- ❌ "Setup project structure" como primeira task quando o ambiente ainda
+  não foi containerizado — sem container/runtime, o Ralph Loop não roda.
+
+## Ordem recomendada das primeiras tasks
+
+1. **Containerize app** (Dockerfile + docker-compose + healthcheck) — sem
+   isso o Ralph Loop não tem onde rodar
+2. **Database schema** (migrations + factories)
+3. **Core endpoints / componentes**
+4. **Auth / autorização**
+5. **Test suite real** (com assertions de verdade)
+
+A task de container/compose pode estar em **outra ordem** se o projeto já
+vive em um container do monorepo, ou se a stack não precisa de DB. Mas
+quase sempre é uma das primeiras — nunca a última.
+
 ## Checklist antes de aprovar um DAG
 
 - [ ] Pelo menos 2 tasks no rank 0
@@ -183,4 +215,7 @@ nada; o CLI cuida do cascade.
 - [ ] `complexity` reflete o esforço real (não tudo HIGH)
 - [ ] `id` em kebab-case e único
 - [ ] Sem ciclos
+- [ ] **Sem task de "Ralph Loop final"** — Ralph Loop é gate por task
+- [ ] **Tests com assertions reais** — placeholder quebra o gate `test`
+- [ ] Container/runtime resolvido cedo, não na última task
 - [ ] `TASKS.md` + `dare-dag.yaml` + `EXECUTION/task-*.md` consistentes