@bhargavvc/sdd-cc 1.30.1 → 1.35.0

package/README.pt-BR.md

@@ -1,20 +1,20 @@
 <div align="center">
 
-# GET SHIT DONE
+# SPEC-DRIVEN DEVELOPMENT
 
 [English](README.md) · **Português** · [简体中文](README.zh-CN.md) · [日本語](README.ja-JP.md)
 
-**Um sistema leve e poderoso de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificação para Claude Code, OpenCode, Gemini CLI, Codex, Copilot, Cursor e Antigravity.**
+**Um sistema leve e poderoso de meta-prompting, engenharia de contexto e desenvolvimento orientado a especificação para Claude Code, OpenCode, Gemini CLI, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae e Cline.**
 
 **Resolve context rot — a degradação de qualidade que acontece conforme o Claude enche a janela de contexto.**
 
 [![npm version](https://img.shields.io/npm/v/@bhargavvc/sdd-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@bhargavvc/sdd-cc)
 [![npm downloads](https://img.shields.io/npm/dm/@bhargavvc/sdd-cc?style=for-the-badge&logo=npm&logoColor=white&color=CB3837)](https://www.npmjs.com/package/@bhargavvc/sdd-cc)
-[![Tests](https://img.shields.io/github/actions/workflow/status/gsd-build/sdd/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/gsd-build/sdd/actions/workflows/test.yml)
-[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/sdd)
+[![Tests](https://img.shields.io/github/actions/workflow/status/bhargavvc/sdd-cc/test.yml?branch=main&style=for-the-badge&logo=github&label=Tests)](https://github.com/bhargavvc/sdd-cc/actions/workflows/test.yml)
+[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/mYgfVNfA2r)
 [![X (Twitter)](https://img.shields.io/badge/X-@sdd__foundation-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/sdd_foundation)
 [![$SDD Token](https://img.shields.io/badge/$SDD-Dexscreener-1C1C1C?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMjQiIGhlaWdodD0iMjQiIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj48Y2lyY2xlIGN4PSIxMiIgY3k9IjEyIiByPSIxMCIgZmlsbD0iIzAwRkYwMCIvPjwvc3ZnPg==&logoColor=00FF00)](https://dexscreener.com/solana/dwudwjvan7bzkw9zwlbyv6kspdlvhwzrqy6ebk8xzxkv)
-[![GitHub stars](https://img.shields.io/github/stars/gsd-build/sdd?style=for-the-badge&logo=github&color=181717)](https://github.com/gsd-build/sdd)
+[![GitHub stars](https://img.shields.io/github/stars/bhargavvc/sdd-cc?style=for-the-badge&logo=github&color=181717)](https://github.com/bhargavvc/sdd-cc)
 [![License](https://img.shields.io/badge/license-MIT-blue?style=for-the-badge)](LICENSE)
 
 <br>
@@ -71,6 +71,18 @@ O SDD corrige isso. É a camada de engenharia de contexto que torna o Claude Cod
 
 Para quem quer descrever o que precisa e receber isso construído do jeito certo — sem fingir que está rodando uma engenharia de 50 pessoas.
 
+Quality gates embutidos capturam problemas reais: detecção de schema drift sinaliza mudanças ORM sem migrations, segurança ancora verificação a modelos de ameaça, e detecção de redução de escopo impede o planner de descartar requisitos silenciosamente.
+
+### Destaques v1.32.0
+
+- **Gates de consistência STATE.md** — `state validate` detecta divergência entre STATE.md e o filesystem; `state sync` reconstrói a partir do estado real do projeto
+- **Flag `--to N`** — Para a execução autônoma após completar uma fase específica
+- **Research gate** — Bloqueia planejamento quando RESEARCH.md tem perguntas abertas não resolvidas
+- **Filtro de escopo do verificador** — Lacunas abordadas em fases posteriores são marcadas como "adiadas", não como lacunas
+- **Guard de leitura antes de edição** — Hook consultivo previne loops de retry infinitos em runtimes não-Claude
+- **Redução de contexto** — Truncamento de Markdown e ordenação de prompts cache-friendly para menor uso de tokens
+- **4 novos runtimes** — Trae, Kilo, Augment e Cline (12 runtimes no total)
+
 ---
 
 ## Primeiros passos
@@ -80,18 +92,20 @@ npx @bhargavvc/sdd-cc@latest
 ```
 
 O instalador pede:
-1. **Runtime** — Claude Code, OpenCode, Gemini, Codex, Copilot, Cursor, Antigravity, ou todos
+1. **Runtime** — Claude Code, OpenCode, Gemini, Kilo, Codex, Copilot, Cursor, Windsurf, Antigravity, Augment, Trae, Cline, ou todos
 2. **Local** — Global (todos os projetos) ou local (apenas projeto atual)
 
 Verifique com:
-- Claude Code / Gemini: `/sdd:help`
-- OpenCode: `/sdd-help`
+- Claude Code / Gemini / Copilot / Antigravity: `/sdd-help`
+- OpenCode / Kilo / Augment / Trae: `/sdd-help`
 - Codex: `$sdd-help`
-- Copilot: `/sdd:help`
-- Antigravity: `/sdd:help`
+- Cline: SDD instala via `.clinerules` — verifique se `.clinerules` existe
 
 > [!NOTE]
-> A instalação do Codex usa skills (`skills/sdd-*/SKILL.md`) em vez de prompts customizados.
+> Claude Code 2.1.88+ e Codex instalam como skills (`skills/sdd-*/SKILL.md`). Cline usa `.clinerules`. O instalador lida com todos os formatos automaticamente.
+
+> [!TIP]
+> Para instalação a partir do código-fonte ou ambientes sem npm, consulte **[docs/manual-update.md](docs/manual-update.md)**.
 
 ### Mantendo atualizado
 
@@ -113,6 +127,10 @@ npx @bhargavvc/sdd-cc --opencode --global
 # Gemini CLI
 npx @bhargavvc/sdd-cc --gemini --global
 
+# Kilo
+npx @bhargavvc/sdd-cc --kilo --global
+npx @bhargavvc/sdd-cc --kilo --local
+
 # Codex
 npx @bhargavvc/sdd-cc --codex --global
 npx @bhargavvc/sdd-cc --codex --local
@@ -129,12 +147,24 @@ npx @bhargavvc/sdd-cc --cursor --local
 npx @bhargavvc/sdd-cc --antigravity --global
 npx @bhargavvc/sdd-cc --antigravity --local
 
+# Augment
+npx @bhargavvc/sdd-cc --augment --global     # Install to ~/.augment/
+npx @bhargavvc/sdd-cc --augment --local      # Install to ./.augment/
+
+# Trae
+npx @bhargavvc/sdd-cc --trae --global        # Install to ~/.trae/
+npx @bhargavvc/sdd-cc --trae --local         # Install to ./.trae/
+
+# Cline
+npx @bhargavvc/sdd-cc --cline --global       # Install to ~/.cline/
+npx @bhargavvc/sdd-cc --cline --local        # Install to ./.clinerules
+
 # Todos
 npx @bhargavvc/sdd-cc --all --global
 ```
 
 Use `--global` (`-g`) ou `--local` (`-l`) para pular a pergunta de local.
-Use `--claude`, `--opencode`, `--gemini`, `--codex`, `--copilot`, `--cursor`, `--antigravity` ou `--all` para pular a pergunta de runtime.
+Use `--claude`, `--opencode`, `--gemini`, `--kilo`, `--codex`, `--copilot`, `--cursor`, `--windsurf`, `--antigravity`, `--augment`, `--trae`, `--cline` ou `--all` para pular a pergunta de runtime.
 
 </details>
 
@@ -151,12 +181,12 @@ claude --dangerously-skip-permissions
 
 ## Como funciona
 
-> **Já tem código?** Rode `/sdd:map-codebase` primeiro para analisar stack, arquitetura, convenções e riscos.
+> **Já tem código?** Rode `/sdd-map-codebase` primeiro para analisar stack, arquitetura, convenções e riscos.
 
 ### 1. Inicializar projeto
 
 ```
-/sdd:new-project
+/sdd-new-project
 ```
 
 O sistema:
@@ -170,7 +200,7 @@ O sistema:
 ### 2. Discutir fase
 
 ```
-/sdd:discuss-phase 1
+/sdd-discuss-phase 1
 ```
 
 Captura suas preferências de implementação antes do planejamento.
@@ -180,7 +210,7 @@ Captura suas preferências de implementação antes do planejamento.
 ### 3. Planejar fase
 
 ```
-/sdd:plan-phase 1
+/sdd-plan-phase 1
 ```
 
 1. Pesquisa abordagens
@@ -192,7 +222,7 @@ Captura suas preferências de implementação antes do planejamento.
 ### 4. Executar fase
 
 ```
-/sdd:execute-phase 1
+/sdd-execute-phase 1
 ```
 
 1. Executa planos em ondas
@@ -205,7 +235,7 @@ Captura suas preferências de implementação antes do planejamento.
 ### 5. Verificar trabalho
 
 ```
-/sdd:verify-work 1
+/sdd-verify-work 1
 ```
 
 Validação manual orientada para confirmar que a feature realmente funciona como esperado.
@@ -215,25 +245,25 @@ Validação manual orientada para confirmar que a feature realmente funciona com
 ### 6. Repetir -> Entregar -> Completar
 
 ```
-/sdd:discuss-phase 2
-/sdd:plan-phase 2
-/sdd:execute-phase 2
-/sdd:verify-work 2
-/sdd:ship 2
-/sdd:complete-milestone
-/sdd:new-milestone
+/sdd-discuss-phase 2
+/sdd-plan-phase 2
+/sdd-execute-phase 2
+/sdd-verify-work 2
+/sdd-ship 2
+/sdd-complete-milestone
+/sdd-new-milestone
 ```
 
 Ou deixe o SDD decidir:
 
 ```
-/sdd:next
+/sdd-next
 ```
 
 ### Modo rápido
 
 ```
-/sdd:quick
+/sdd-quick
 ```
 
 Para tarefas ad-hoc sem ciclo completo de planejamento.
@@ -289,36 +319,36 @@ Cada tarefa gera commit próprio, facilitando `git bisect`, rollback e rastreabi
 
 | Comando | O que faz |
 |---------|-----------|
-| `/sdd:new-project [--auto]` | Inicializa projeto completo |
-| `/sdd:discuss-phase [N] [--auto] [--analyze]` | Captura decisões antes do plano |
-| `/sdd:plan-phase [N] [--auto] [--reviews]` | Pesquisa + plano + validação |
-| `/sdd:execute-phase <N>` | Executa planos em ondas paralelas |
-| `/sdd:verify-work [N]` | UAT manual |
-| `/sdd:ship [N] [--draft]` | Cria PR da fase validada |
-| `/sdd:next` | Avança automaticamente para o próximo passo |
-| `/sdd:fast <text>` | Tarefas triviais sem planejamento |
-| `/sdd:complete-milestone` | Fecha o marco e marca release |
-| `/sdd:new-milestone [name]` | Inicia próximo marco |
+| `/sdd-new-project [--auto]` | Inicializa projeto completo |
+| `/sdd-discuss-phase [N] [--auto] [--analyze] [--chain]` | Captura decisões antes do plano (`--chain` encadeia automaticamente em plan+execute) |
+| `/sdd-plan-phase [N] [--auto] [--reviews]` | Pesquisa + plano + validação |
+| `/sdd-execute-phase <N>` | Executa planos em ondas paralelas |
+| `/sdd-verify-work [N]` | UAT manual |
+| `/sdd-ship [N] [--draft]` | Cria PR da fase validada |
+| `/sdd-next` | Avança automaticamente para o próximo passo |
+| `/sdd-fast <text>` | Tarefas triviais sem planejamento |
+| `/sdd-complete-milestone` | Fecha o marco e marca release |
+| `/sdd-new-milestone [name]` | Inicia próximo marco |
 
 ### Qualidade e utilidades
 
 | Comando | O que faz |
 |---------|-----------|
-| `/sdd:review` | Peer review com múltiplas IAs |
-| `/sdd:pr-branch` | Cria branch limpa para PR |
-| `/sdd:settings` | Configura perfis e agentes |
-| `/sdd:set-profile <profile>` | Troca perfil (quality/balanced/budget/inherit) |
-| `/sdd:quick [--full] [--discuss] [--research]` | Execução rápida com garantias do SDD |
-| `/sdd:health [--repair]` | Verifica e repara `.planning/` |
+| `/sdd-review` | Peer review com múltiplas IAs |
+| `/sdd-pr-branch` | Cria branch limpa para PR |
+| `/sdd-settings` | Configura perfis e agentes |
+| `/sdd-set-profile <profile>` | Troca perfil (quality/balanced/budget/inherit) |
+| `/sdd-quick [--full] [--discuss] [--research]` | Execução rápida com garantias do SDD (`--full` ativa todas as etapas, `--validate` ativa apenas verificação) |
+| `/sdd-health [--repair]` | Verifica e repara `.planning/` |
 
-> Para a lista completa de comandos e opções, use `/sdd:help`.
+> Para a lista completa de comandos e opções, use `/sdd-help`.
 
 ---
 
 ## Configuração
 
 As configurações do projeto ficam em `.planning/config.json`.
-Você pode configurar no `/sdd:new-project` ou ajustar depois com `/sdd:settings`.
+Você pode configurar no `/sdd-new-project` ou ajustar depois com `/sdd-settings`.
 
 ### Ajustes principais
 
@@ -338,7 +368,7 @@ Você pode configurar no `/sdd:new-project` ou ajustar depois com `/sdd:settings
 
 Troca rápida:
 ```
-/sdd:set-profile budget
+/sdd-set-profile budget
 ```
 
 ---
@@ -382,7 +412,7 @@ Adicione padrões sensíveis ao deny list do Claude Code:
 - Verifique se os arquivos foram instalados no diretório correto
 
 **Comandos não funcionam como esperado?**
-- Rode `/sdd:help`
+- Rode `/sdd-help`
 - Reinstale com `npx @bhargavvc/sdd-cc@latest`
 
 **Em Docker/container?**
@@ -399,26 +429,34 @@ CLAUDE_CONFIG_DIR=/home/youruser/.claude npx @bhargavvc/sdd-cc --global
 npx @bhargavvc/sdd-cc --claude --global --uninstall
 npx @bhargavvc/sdd-cc --opencode --global --uninstall
 npx @bhargavvc/sdd-cc --gemini --global --uninstall
+npx @bhargavvc/sdd-cc --kilo --global --uninstall
 npx @bhargavvc/sdd-cc --codex --global --uninstall
 npx @bhargavvc/sdd-cc --copilot --global --uninstall
 npx @bhargavvc/sdd-cc --cursor --global --uninstall
 npx @bhargavvc/sdd-cc --antigravity --global --uninstall
+npx @bhargavvc/sdd-cc --augment --global --uninstall
+npx @bhargavvc/sdd-cc --trae --global --uninstall
+npx @bhargavvc/sdd-cc --cline --global --uninstall
 
 # Instalações locais (projeto atual)
 npx @bhargavvc/sdd-cc --claude --local --uninstall
 npx @bhargavvc/sdd-cc --opencode --local --uninstall
 npx @bhargavvc/sdd-cc --gemini --local --uninstall
+npx @bhargavvc/sdd-cc --kilo --local --uninstall
 npx @bhargavvc/sdd-cc --codex --local --uninstall
 npx @bhargavvc/sdd-cc --copilot --local --uninstall
 npx @bhargavvc/sdd-cc --cursor --local --uninstall
 npx @bhargavvc/sdd-cc --antigravity --local --uninstall
+npx @bhargavvc/sdd-cc --augment --local --uninstall
+npx @bhargavvc/sdd-cc --trae --local --uninstall
+npx @bhargavvc/sdd-cc --cline --local --uninstall
 ```
 
 ---
 
 ## Community Ports
 
-OpenCode, Gemini CLI e Codex agora são suportados nativamente via `npx @bhargavvc/sdd-cc`.
+OpenCode, Gemini CLI, Kilo e Codex agora são suportados nativamente via `npx @bhargavvc/sdd-cc`.
 
 | Projeto | Plataforma | Descrição |
 |---------|------------|-----------|
@@ -429,11 +467,11 @@ OpenCode, Gemini CLI e Codex agora são suportados nativamente via `npx @bhargav
 
 ## Star History
 
-<a href="https://star-history.com/#gsd-build/sdd&Date">
+<a href="https://star-history.com/#bhargavvc/sdd-cc&Date">
  <picture>
-   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=gsd-build/sdd&type=Date&theme=dark" />
-   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=gsd-build/sdd&type=Date" />
-   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=gsd-build/sdd&type=Date" />
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=bhargavvc/sdd-cc&type=Date&theme=dark" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=bhargavvc/sdd-cc&type=Date" />
+   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=bhargavvc/sdd-cc&type=Date" />
  </picture>
 </a>