devsquad 1.0.0 → 1.1.0

package/bin/devsquad.js

@@ -1,9 +1,21 @@
 #!/usr/bin/env node
 import { parseArgs } from 'node:util';
 import { init } from '../src/init.js';
+import { update } from '../src/update.js';
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { join, dirname } from 'node:path';
 
-const { positionals } = parseArgs({
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+
+const { positionals, values } = parseArgs({
   args: process.argv.slice(2),
+  options: {
+    yes: { type: 'boolean', short: 'y', default: false },
+    version: { type: 'boolean', short: 'v', default: false },
+    help: { type: 'boolean', short: 'h', default: false },
+  },
   strict: false,
   allowPositionals: true,
 });
@@ -19,24 +31,38 @@ function showHelp() {
   ██████╔╝███████╗ ╚████╔╝ ███████║╚██████╔╝╚██████╔╝██║  ██║██████╔╝
   ╚═════╝ ╚══════╝  ╚═══╝  ╚══════╝ ╚══▀▀═╝  ╚═════╝ ╚═╝  ╚═╝╚═════╝
 
-  Agente especializado em inicializar e arquitetar sistemas profissionais
+  v${pkg.version} — Agente especializado em sistemas profissionais
   Stack: NestJS · React · React Native · Prisma · PostgreSQL · JWT
 
-  Comandos disponíveis:
-    npx devsquad init     Instala o DevSquad no projeto atual
+  Comandos:
+    npx devsquad init       Instala o DevSquad no projeto atual
+    npx devsquad update     Atualiza os arquivos do DevSquad
 
-  Uso:
-    npx devsquad init
+  Opções:
+    -y, --yes               Pula confirmações interativas
+    -v, --version           Exibe a versão
+    -h, --help              Exibe esta ajuda
 `);
 }
 
 try {
-  if (command === 'init') {
-    await init(process.cwd());
-  } else {
+  if (values.version) {
+    console.log(`devsquad v${pkg.version}`);
+  } else if (values.help || !command) {
     showHelp();
+  } else if (command === 'init') {
+    await init(process.cwd(), { yes: values.yes });
+  } else if (command === 'update') {
+    await update(process.cwd(), { yes: values.yes });
+  } else {
+    console.error(`\n  Comando desconhecido: "${command}"\n  Use --help para ver os comandos disponíveis.\n`);
+    process.exit(1);
   }
 } catch (err) {
-  console.error('\n❌ Erro:', err.message);
-  process.exit(1);
+  if (err.name === 'ExitPromptError') {
+    console.log('\n  Cancelado.\n');
+  } else {
+    console.error('\n  Erro:', err.message);
+    process.exit(1);
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devsquad",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Agente DevSquad para Claude Code — inicialize e arquitete sistemas profissionais com NestJS, React e React Native",
   "type": "module",
   "bin": {

package/src/init.js

@@ -24,7 +24,54 @@ function fileExists(targetDir, relPath) {
   return fs.existsSync(path.join(targetDir, relPath));
 }
 
-export async function init(targetDir) {
+function generateNextSteps() {
+  return `# Próximos passos com o DevSquad
+
+Bem-vindo! O DevSquad está instalado e pronto para uso no Claude Code.
+
+## Iniciar um novo projeto
+
+Abra o Claude Code neste diretório e execute:
+
+\`\`\`
+/devsquad init
+\`\`\`
+
+O DevSquad vai fazer 10 perguntas e gerar a estrutura completa do projeto.
+
+## Comandos disponíveis
+
+| Comando | O que faz |
+|---------|-----------|
+| \`/devsquad init\` | Onboarding completo — perguntas + estrutura do projeto |
+| \`/devsquad backend\` | Setup NestJS + Prisma + PostgreSQL + JWT |
+| \`/devsquad frontend\` | Setup React + TypeScript + TailwindCSS |
+| \`/devsquad mobile\` | Setup React Native + Expo + NativeWind |
+| \`/devsquad database\` | Modelagem Prisma + migrations + seed |
+| \`/devsquad git\` | Git Flow + Conventional Commits + Husky |
+| \`/devsquad security\` | Checklist OWASP Top 10 |
+| \`/devsquad testing\` | Jest + Vitest + Playwright |
+| \`/devsquad cicd\` | GitHub Actions (backend + frontend + mobile) |
+| \`/devsquad clickup\` | Estrutura de projeto + tasks no ClickUp |
+| \`/devsquad postman\` | Collections e environments de API |
+| \`/devsquad docs\` | README, ARCHITECTURE, CONTRIBUTING, SECURITY |
+| \`/devsquad figma\` | Tokens de design → Tailwind + handoff |
+
+## Atualizar o DevSquad
+
+\`\`\`bash
+npx devsquad update
+\`\`\`
+
+---
+
+Pode apagar este arquivo após ler.
+`;
+}
+
+export async function init(targetDir, options = {}) {
+  const { yes = false } = options;
+
   console.log(`
   ██████╗ ███████╗██╗   ██╗███████╗ ██████╗ ██╗   ██╗ █████╗ ██████╗
   ██╔══██╗██╔════╝██║   ██║██╔════╝██╔═══██╗██║   ██║██╔══██╗██╔══██╗
@@ -39,7 +86,7 @@ export async function init(targetDir) {
 
   // Verificar se já existe instalação
   const alreadyInstalled = fileExists(targetDir, 'CLAUDE.md') && fileExists(targetDir, '.claude');
-  if (alreadyInstalled) {
+  if (alreadyInstalled && !yes) {
     console.log('  ⚠️  Detectamos que o DevSquad já pode estar instalado neste projeto.\n');
     const overwrite = await confirm({
       message: 'Deseja reinstalar e sobrescrever os arquivos existentes?',
@@ -49,7 +96,7 @@ export async function init(targetDir) {
       console.log('\n  Instalação cancelada. Seu projeto não foi modificado.\n');
       return;
     }
-  } else {
+  } else if (!alreadyInstalled && !yes) {
     const proceed = await confirm({
       message: 'Instalar o DevSquad neste diretório?',
       default: true,
@@ -61,26 +108,25 @@ export async function init(targetDir) {
   }
 
   // Selecionar IDE
-  const ide = await select({
-    message: 'Qual IDE você usa?',
-    choices: [
-      { name: 'VS Code / Cursor', value: 'vscode' },
-      { name: 'Outro / Nenhum', value: 'other' },
-    ],
-  });
+  let ide = 'other';
+  if (!yes) {
+    ide = await select({
+      message: 'Qual IDE você usa?',
+      choices: [
+        { name: 'VS Code / Cursor', value: 'vscode' },
+        { name: 'Outro / Nenhum', value: 'other' },
+      ],
+    });
+  }
 
   console.log('\n  Instalando DevSquad...\n');
 
   // Copiar CLAUDE.md
-  const claudeMdSrc = path.join(templatesDir, 'CLAUDE.md');
-  const claudeMdDest = path.join(targetDir, 'CLAUDE.md');
-  fs.copyFileSync(claudeMdSrc, claudeMdDest);
+  fs.copyFileSync(path.join(templatesDir, 'CLAUDE.md'), path.join(targetDir, 'CLAUDE.md'));
   console.log('  ✅ CLAUDE.md');
 
   // Copiar .claude/
-  const claudeDirSrc = path.join(templatesDir, '.claude');
-  const claudeDirDest = path.join(targetDir, '.claude');
-  copyDir(claudeDirSrc, claudeDirDest);
+  copyDir(path.join(templatesDir, '.claude'), path.join(targetDir, '.claude'));
   console.log('  ✅ .claude/agents/');
   console.log('  ✅ .claude/skills/');
 
@@ -98,21 +144,19 @@ export async function init(targetDir) {
     }
   }
 
+  // Gerar NEXT_STEPS.md
+  fs.writeFileSync(path.join(targetDir, 'NEXT_STEPS.md'), generateNextSteps());
+  console.log('  ✅ NEXT_STEPS.md');
+
   console.log(`
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 
   🚀 DevSquad instalado com sucesso!
 
-  Próximos passos:
-    1. Abra este projeto no Claude Code
-    2. Use /devsquad init para iniciar um novo projeto
-    3. Ou use os comandos específicos:
-       • /devsquad backend   → Setup NestJS + Prisma
-       • /devsquad frontend  → Setup React + TailwindCSS
-       • /devsquad mobile    → Setup React Native + Expo
-       • /devsquad git       → Git Flow + Conventional Commits
-       • /devsquad database  → Prisma + PostgreSQL
-       • /devsquad security  → OWASP Top 10
+  Leia o NEXT_STEPS.md para começar.
+
+  Abra este projeto no Claude Code e execute:
+    /devsquad init
 
   ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
 `);

package/src/update.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { execSync } from 'node:child_process';
+import confirm from '@inquirer/confirm';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const templatesDir = path.join(__dirname, '..', 'templates');
+
+function copyDir(src, dest) {
+  fs.mkdirSync(dest, { recursive: true });
+  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function getInstalledVersion(targetDir) {
+  try {
+    const pkgPath = path.join(targetDir, 'node_modules', 'devsquad', 'package.json');
+    if (fs.existsSync(pkgPath)) {
+      return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version;
+    }
+  } catch {
+    // não instalado localmente
+  }
+  return null;
+}
+
+function getLatestVersion() {
+  try {
+    return execSync('npm show devsquad version', { encoding: 'utf8' }).trim();
+  } catch {
+    return null;
+  }
+}
+
+export async function update(targetDir) {
+  console.log('\n  Verificando atualizações do DevSquad...\n');
+
+  const localVersion = getInstalledVersion(targetDir);
+  const latestVersion = getLatestVersion();
+  const currentPkg = JSON.parse(
+    fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf8'),
+  );
+
+  console.log(`  Versão instalada:  ${localVersion ?? currentPkg.version}`);
+  console.log(`  Versão disponível: ${latestVersion ?? 'desconhecida'}\n`);
+
+  if (latestVersion && localVersion === latestVersion) {
+    console.log('  ✅ DevSquad já está na versão mais recente!\n');
+    return;
+  }
+
+  const proceed = await confirm({
+    message: latestVersion
+      ? `Atualizar para v${latestVersion}?`
+      : 'Atualizar os arquivos do DevSquad neste projeto?',
+    default: true,
+  });
+
+  if (!proceed) {
+    console.log('\n  Atualização cancelada.\n');
+    return;
+  }
+
+  console.log('\n  Atualizando arquivos...\n');
+
+  // Atualizar CLAUDE.md
+  const claudeMdSrc = path.join(templatesDir, 'CLAUDE.md');
+  const claudeMdDest = path.join(targetDir, 'CLAUDE.md');
+  fs.copyFileSync(claudeMdSrc, claudeMdDest);
+  console.log('  ✅ CLAUDE.md');
+
+  // Atualizar .claude/agents/ e .claude/skills/
+  const claudeDirSrc = path.join(templatesDir, '.claude');
+  const claudeDirDest = path.join(targetDir, '.claude');
+  copyDir(claudeDirSrc, claudeDirDest);
+  console.log('  ✅ .claude/agents/');
+  console.log('  ✅ .claude/skills/');
+
+  console.log(`
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  ✅ DevSquad atualizado com sucesso!
+
+  Suas configurações personalizadas (agent-memory,
+  settings.local.json) não foram modificadas.
+  ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+`);
+}

package/templates/.claude/skills/cicd/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: cicd
+description: CI/CD com GitHub Actions para NestJS + React + React Native. Use quando o desenvolvedor precisar configurar pipelines de integração contínua, deploy automatizado, validação de PRs ou publicação de builds.
+---
+
+# CI/CD — GitHub Actions
+
+Stack: GitHub Actions · Docker · Railway / Render / Fly.io (backend) · Vercel / Netlify (frontend) · EAS (mobile)
+
+## Estratégia de pipelines
+
+```
+Push para feature/  → lint + testes unitários (rápido, < 2min)
+PR para develop     → lint + testes + build + cobertura
+PR para main        → tudo acima + testes e2e
+Merge em main       → deploy automático (produção)
+Merge em develop    → deploy automático (staging)
+```
+
+## Arquivos desta skill
+
+- **backend-ci.md** — Pipeline NestJS: lint, testes, migrations, deploy
+- **frontend-ci.md** — Pipeline React: lint, testes, build, deploy Vercel
+- **mobile-ci.md** — Pipeline Expo: lint, build EAS, distribuição
+- **pr-checks.md** — Validações obrigatórias em todo PR
+
+## Setup inicial
+
+```bash
+mkdir -p .github/workflows
+```
+
+## Secrets necessários (GitHub → Settings → Secrets)
+
+```
+DATABASE_URL          ← banco de staging/produção
+JWT_SECRET            ← segredo JWT
+JWT_REFRESH_SECRET    ← segredo refresh
+RAILWAY_TOKEN         ← deploy backend (ou RENDER_API_KEY)
+VERCEL_TOKEN          ← deploy frontend
+VERCEL_ORG_ID         ← organização Vercel
+VERCEL_PROJECT_ID     ← projeto Vercel
+EXPO_TOKEN            ← build mobile EAS
+```
+
+Leia os arquivos de detalhe para implementar cada pipeline.

package/templates/.claude/skills/cicd/backend-ci.md

@@ -0,0 +1,114 @@
+# CI/CD — Backend NestJS
+
+## .github/workflows/backend.yml
+
+```yaml
+name: Backend CI
+
+on:
+  push:
+    branches: [main, develop]
+    paths: ['backend/**', '.github/workflows/backend.yml']
+  pull_request:
+    branches: [main, develop]
+    paths: ['backend/**']
+
+defaults:
+  run:
+    working-directory: backend
+
+jobs:
+  lint-and-test:
+    name: Lint + Testes
+    runs-on: ubuntu-latest
+
+    services:
+      postgres:
+        image: postgres:16-alpine
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: app_test
+        ports: ['5432:5432']
+        options: >-
+          --health-cmd pg_isready
+          --health-interval 10s
+          --health-timeout 5s
+          --health-retries 5
+
+    env:
+      DATABASE_URL: postgresql://test:test@localhost:5432/app_test
+      JWT_SECRET: ci-secret-do-not-use-in-prod
+      JWT_REFRESH_SECRET: ci-refresh-secret-do-not-use-in-prod
+      NODE_ENV: test
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: backend/package-lock.json
+
+      - name: Instalar dependências
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Rodar migrations de teste
+        run: npx prisma migrate deploy
+
+      - name: Testes unitários
+        run: npm run test:cov
+
+      - name: Testes de integração (e2e)
+        run: npm run test:e2e
+
+      - name: Upload cobertura
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          directory: backend/coverage
+
+  deploy-staging:
+    name: Deploy Staging
+    needs: lint-and-test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/develop' && github.event_name == 'push'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Deploy no Railway (staging)
+        uses: railway/railway-action@v2
+        with:
+          token: ${{ secrets.RAILWAY_TOKEN }}
+          service: backend-staging
+
+  deploy-production:
+    name: Deploy Produção
+    needs: lint-and-test
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+    environment: production
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Deploy no Railway (produção)
+        uses: railway/railway-action@v2
+        with:
+          token: ${{ secrets.RAILWAY_TOKEN }}
+          service: backend-production
+```
+
+## Checklist de CI backend
+
+- [ ] Banco de teste isolado via service container
+- [ ] Migrations rodam antes dos testes de integração
+- [ ] Secrets reais NUNCA no código — apenas em GitHub Secrets
+- [ ] Deploy de produção protegido por `environment: production` (aprovação manual)
+- [ ] Cobertura enviada ao Codecov ou similar
+- [ ] Cache de `node_modules` configurado para builds mais rápidos

package/templates/.claude/skills/cicd/frontend-ci.md

@@ -0,0 +1,97 @@
+# CI/CD — Frontend React + Vercel
+
+## .github/workflows/frontend.yml
+
+```yaml
+name: Frontend CI
+
+on:
+  push:
+    branches: [main, develop]
+    paths: ['frontend/**', '.github/workflows/frontend.yml']
+  pull_request:
+    branches: [main, develop]
+    paths: ['frontend/**']
+
+defaults:
+  run:
+    working-directory: frontend
+
+jobs:
+  lint-test-build:
+    name: Lint + Testes + Build
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Instalar dependências
+        run: npm ci
+
+      - name: Lint
+        run: npm run lint
+
+      - name: Testes com cobertura
+        run: npm run test:run -- --coverage
+
+      - name: Build
+        run: npm run build
+        env:
+          VITE_API_URL: ${{ secrets.VITE_API_URL_STAGING }}
+
+      - name: Upload cobertura
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  deploy-vercel:
+    name: Deploy Vercel
+    needs: lint-test-build
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push'
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Deploy no Vercel
+        uses: amondnet/vercel-action@v25
+        with:
+          vercel-token: ${{ secrets.VERCEL_TOKEN }}
+          vercel-org-id: ${{ secrets.VERCEL_ORG_ID }}
+          vercel-project-id: ${{ secrets.VERCEL_PROJECT_ID }}
+          vercel-args: ${{ github.ref == 'refs/heads/main' && '--prod' || '' }}
+          working-directory: frontend
+```
+
+## Preview automático em PRs
+
+```yaml
+# Adicionar ao job deploy-vercel para PRs
+- name: Comentar URL de preview no PR
+  uses: actions/github-script@v7
+  if: github.event_name == 'pull_request'
+  with:
+    script: |
+      github.rest.issues.createComment({
+        issue_number: context.issue.number,
+        owner: context.repo.owner,
+        repo: context.repo.repo,
+        body: `## Preview do Frontend\n🚀 Deploy disponível em: ${process.env.VERCEL_URL}`
+      })
+  env:
+    VERCEL_URL: ${{ steps.deploy.outputs.preview-url }}
+```
+
+## Checklist de CI frontend
+
+- [ ] Build de produção testado no CI antes do deploy
+- [ ] Variáveis de ambiente de staging separadas das de produção
+- [ ] Preview automático gerado em cada PR
+- [ ] Lint bloqueante — PR não pode ser mergeado com erros de lint
+- [ ] Testes bloqueantes — cobertura mínima configurada

package/templates/.claude/skills/clickup/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: clickup-tasks
+name: clickup
 description: Organização de projetos e criação de tasks no ClickUp vinculadas ao desenvolvimento. Use quando o desenvolvedor precisar estruturar o backlog, criar tasks para um novo projeto, definir sprints ou entender como nomear branches vinculadas a tasks.
 ---
 
@@ -14,6 +14,8 @@ Space: [Nome do Projeto]
 ├── Lista: 👥 [Módulo principal]
 ├── Lista: 🎨 Frontend
 ├── Lista: 📱 Mobile (se aplicável)
+├── Lista: 🧪 Testes & QA
+├── Lista: 🚀 CI/CD & DevOps
 ├── Lista: 📝 Documentação
 └── Lista: 🐛 Bugs
 ```
@@ -22,16 +24,21 @@ Space: [Nome do Projeto]
 
 ```
 🔧 Setup & Infraestrutura
-├── [ ] Inicializar repositório Git (DevSquad)       → chore/initial-setup
-├── [ ] Configurar banco de dados                    → chore/database-setup
-├── [ ] Criar .env.example                           → chore/environment-setup
-└── [ ] Configurar GitHub Actions básico             → ci/setup-actions
+├── [ ] Inicializar repositório Git                   → chore/initial-setup
+├── [ ] Configurar banco de dados + Prisma            → chore/database-setup
+├── [ ] Criar .env.example                            → chore/environment-setup
+├── [ ] Configurar GitHub Actions (lint + testes)     → ci/setup-actions
+└── [ ] Configurar Husky + Commitlint                 → chore/git-hooks
 
 🔐 Autenticação
-├── [ ] Implementar registro de usuário              → feature/CK-{id}-user-register
-├── [ ] Implementar login com JWT                    → feature/CK-{id}-jwt-login
-├── [ ] Implementar refresh token                    → feature/CK-{id}-refresh-token
-└── [ ] Implementar logout                           → feature/CK-{id}-logout
+├── [ ] Implementar registro de usuário               → feature/CK-{id}-user-register
+├── [ ] Implementar login com JWT                     → feature/CK-{id}-jwt-login
+├── [ ] Implementar refresh token (httpOnly cookie)   → feature/CK-{id}-refresh-token
+└── [ ] Implementar logout                            → feature/CK-{id}-logout
+
+🧪 Testes & QA
+├── [ ] Configurar Jest + Supertest (backend)         → chore/test-setup-backend
+└── [ ] Configurar Vitest + Testing Library (frontend)→ chore/test-setup-frontend
 ```
 
 ## Padrão de task
@@ -45,21 +52,37 @@ DESCRIÇÃO:
 [Por que essa task existe]
 
 ## Critérios de Aceitação
-- [ ] [critério verificável]
-- [ ] [critério verificável]
+- [ ] [critério verificável e testável]
+- [ ] [critério verificável e testável]
+- [ ] Testes escritos e passando
+- [ ] PR revisado e aprovado
 
 ## Branch Git
 feature/CK-{id}-{slug}
+
+## Estimativa
+[XS / S / M / L / XL]
 ```
 
+## Estimativas (T-Shirt sizing)
+
+| Tamanho | Horas | Exemplos |
+|---------|-------|---------|
+| XS | < 2h | Fix de bug simples, ajuste de UI |
+| S | 2-4h | CRUD simples, componente básico |
+| M | 4-8h | Feature com lógica de negócio |
+| L | 1-2d | Módulo completo (auth, pagamentos) |
+| XL | > 2d | Arquitetura, migração, refactor grande |
+
 ## Status do fluxo
 
 | Status | Significado |
 |--------|-------------|
 | Backlog | Definida, não iniciada |
-| Em andamento | Branch criada |
-| Em revisão | PR aberto |
-| Bloqueada | Dependência pendente |
+| Em andamento | Branch criada, dev trabalhando |
+| Em revisão | PR aberto, aguardando review |
+| Bloqueada | Dependência pendente — descrever o bloqueio |
+| QA | Em testes/validação |
 | Concluída | PR mergeado em develop |
 
 ## Vinculação Git ↔ ClickUp
@@ -73,3 +96,29 @@ git commit -m "feat(auth): implementar JWT login
 
 Closes CK-42"
 ```
+
+## Sprint Planning
+
+```
+Duração: 2 semanas
+Capacidade padrão: 60% do tempo total (40% para bugs/reuniões/imprevistos)
+
+Exemplo sprint de 2 semanas (1 dev):
+  80h totais × 60% = ~48h disponíveis
+  Tasks: 2L + 3M + 4S = 2×12h + 3×6h + 4×3h = 24+18+12 = 54h ≈ ok
+
+Daily standup (15min):
+  1. O que fiz ontem?
+  2. O que farei hoje?
+  3. Algum bloqueio?
+```
+
+## Checklist de task bem definida
+
+- [ ] Título começa com verbo no infinitivo
+- [ ] Contexto explica o "por quê"
+- [ ] Critérios de aceitação são verificáveis (não subjetivos)
+- [ ] Branch Git definida com ID da task
+- [ ] Estimativa de tamanho preenchida
+- [ ] Dependências mapeadas (se houver)
+- [ ] Inclui critério de teste passando