@bhargavvc/sdd-cc 1.30.1 → 1.42.3

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,20 @@ 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.39.0
+
+Lista completa nas [notas de release v1.39.0](https://github.com/bhargavvc/sdd-cc/releases/tag/v1.39.0).
+
+- **Perfil de instalação `--minimal`** — alias `--core-only`. Instala apenas os 6 skills do loop principal (`new-project`, `discuss-phase`, `plan-phase`, `execute-phase`, `help`, `update`) e nenhum subagente `sdd-*`. Reduz o overhead do system prompt no cold-start de ~12k para ~700 tokens (≥94% de redução). Útil para LLMs locais com contexto de 32K–128K e APIs cobradas por token.
+- **`/sdd-phase --edit`** — edita qualquer campo de uma fase existente em `ROADMAP.md` no lugar, sem alterar o número ou a posição. `--force` pula o diff de confirmação; referências em `depends_on` são validadas e o `STATE.md` é atualizado na escrita.
+- **Build & test gate pós-merge** — o passo 5.6 de `execute-phase` agora detecta automaticamente o comando de build em `workflow.build_command`, com fallback para Xcode (`.xcodeproj`), Makefile, Justfile, Cargo, Go, Python ou npm. Projetos Xcode/iOS rodam `xcodebuild build` e `xcodebuild test` automaticamente. Funciona em modo paralelo e serial.
+- **Modelo de review por runtime** — `review.models.<cli>` permite que cada CLI externa de review (codex, gemini, etc.) escolha seu próprio modelo, independente do perfil de planner/executor.
+- **Herança de configuração de workstream** — quando `SDD_WORKSTREAM` está definido, o `.planning/config.json` raiz é carregado primeiro e merge-deep com o config da workstream (workstream vence em conflito). Um `null` explícito no config da workstream sobrescreve corretamente o valor raiz.
+- **Workflow manual de canary release** — `.github/workflows/canary.yml` publica builds `{base}-canary.{N}` de `@bhargavvc/sdd-cc` e `@bhargavvc/sdk` na dist-tag `@canary` a partir de `dev`, sob demanda via `workflow_dispatch`.
+- **Consolidação de skills: 86 → 59** — 4 novos skills agrupados (`capture`, `phase`, `config`, `workspace`) absorvem 31 micro-skills. 6 skills pais existentes absorvem wrap-up e sub-operações como flags: `update --sync/--reapply`, `sketch --wrap-up`, `spike --wrap-up`, `map-codebase --fast/--query`, `code-review --fix`, `progress --do/--next`. Sem perda funcional.
+
 ---
 
 ## Primeiros passos
@@ -80,18 +94,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 +129,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 +149,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 +183,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 +202,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 +212,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 +224,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 +237,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 +247,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-progress --next
 ```
 
 ### Modo rápido
 
 ```
-/sdd:quick
+/sdd-quick
 ```
 
 Para tarefas ad-hoc sem ciclo completo de planejamento.
@@ -289,36 +321,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-progress --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-config --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 +370,7 @@ Você pode configurar no `/sdd:new-project` ou ajustar depois com `/sdd:settings
 
 Troca rápida:
 ```
-/sdd:set-profile budget
+/sdd-config --profile budget
 ```
 
 ---
@@ -382,7 +414,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 +431,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 +469,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>