@jeffersonfabriciodev/sdd-kit 1.0.1 → 1.0.2

package/README.md

@@ -1,16 +1,53 @@
 # SDD Kit
 
-> CLI que instala o framework **SDD Kit** (Spec-Driven Development) em qualquer projeto — pronto para Claude Code, Cursor ou GitHub Copilot.
-
-## Uso rápido
+> Framework operacional que estrutura o desenvolvimento assistido por IA em fases com artefatos persistidos — **Discovery → Spec → Test → Code** — para **Claude Code**, **Cursor** e **GitHub Copilot**.
 
 ```bash
 npx @jeffersonfabriciodev/sdd-kit@latest init
 ```
 
-Formulário interativo: escolhe a pasta, a ferramenta de IA e gera a estrutura do SDD Kit (constituição, playbook, templates de spec/BDD, subagents, hooks e comandos).
+## Por que existe
+
+Mandar uma descrição no chat e colar o código gerado é rápido para protótipos, mas em projeto real vira dívida: sem descoberta do problema, sem spec, sem testes, sem decisões registradas, e contexto perdido a cada sessão.
+
+O SDD Kit transforma a interação com IA em um processo disciplinado: cada fase produz um **artefato** que a próxima consome. Nada existe só na conversa — a spec é o contrato, o teste é a evidência, o ADR é a memória.
+
+## Princípios
+
+Seis princípios guiam o kit — três **disciplinas de processo** (a ordem do trabalho) e três **princípios de código** (como escrever).
+
+### Disciplinas de processo
+
+- **SDD** — *Spec-Driven Development*: a spec é o contrato. Código que diverge da spec é código errado — nenhuma linha antes da spec BDD aprovada.
+- **BDD** — *Behavior-Driven Development*: requisitos como cenários `Given / When / Then`, escritos colaborativamente na **Roda de Spec** (produto + design + QA) — não na cabeça do engenheiro.
+- **TDD** — *Test-Driven Development*: ciclo `RED → GREEN → REFACTOR`, um cenário por vez. O teste vem antes da implementação; não se avança sem o anterior verde.
+
+### Princípios de código
+
+- **YAGNI** — *You Aren't Gonna Need It*: não construa o que ainda não é necessário. "E se no futuro…" não é justificativa.
+- **KISS** — *Keep It Simple*: a solução mais simples que atende à spec.
+- **DRY** — *Don't Repeat Yourself*: regra de três — primeira vez escreva, segunda anote, terceira extraia.
+
+> **Ordem de aplicação:** YAGNI filtra o escopo → KISS guia a primeira implementação → **SOLID** estrutura no refactor → DRY quando o padrão estabiliza.
+
+Segurança não é uma fase separada — é uma **dimensão de cada cenário BDD** implementado (OWASP, secrets, PII).
+
+## O ciclo de trabalho
+
+```text
+Produto & Design               Engineer & QA
+────────────────               ─────────────────
+/discover → problema → decisão  /implement → TDD por cenário (RED→GREEN→REFACTOR)
+/spec     → BDD + blueprint      /review    → qualidade (KISS/SOLID/DRY, anti-patterns)
+            + tasks              /security-review → OWASP, secrets, PII
+                                 /sync      → mantém spec ↔ código alinhados
+```
+
+A spec aprovada é o contrato de entrega: **Produto & Design** define o *o quê*; **Engineer & QA** garante o *como*, a qualidade e a segurança.
+
+## Uso
 
-## Opções
+O `init` é interativo: escolhe a pasta, a ferramenta de IA e a política de memória, e gera a estrutura do SDD Kit no projeto — constituição, playbook, templates de spec/BDD, subagents, hooks (sensores) e os slash commands.
 
 ```bash
 # Interativo (default)
@@ -26,11 +63,11 @@ npx @jeffersonfabriciodev/sdd-kit@latest init --tool cursor --dry-run
 npx @jeffersonfabriciodev/sdd-kit@latest version
 ```
 
-Ferramentas suportadas: `claude`, `cursor`, `copilot`.
+Ferramentas suportadas: `claude`, `cursor`, `copilot`. A instalação é **não-destrutiva**: preserva sua memória de projeto e arquivos próprios; só atualiza os artefatos do framework.
 
 ## Como funciona
 
-O pacote embute os binários do SDD Kit para todas as plataformas suportadas (Linux, macOS, Windows × amd64/arm64). O `npx`/`npm` instala o pacote e o shim executa o binário da sua plataforma — **sem download em runtime, sem rede, funciona offline**.
+O pacote embute os binários do SDD Kit para todas as plataformas (Linux, macOS, Windows × amd64/arm64). O `npx`/`npm` instala o pacote e o shim executa o binário da sua plataforma — **sem download em runtime, sem rede, funciona offline**.
 
 - Node.js ≥ 18
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jeffersonfabriciodev/sdd-kit",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "CLI que instala o framework SDD Kit (Spec-Driven Development) em qualquer projeto — Claude Code, Cursor ou GitHub Copilot",
   "homepage": "https://github.com/JeffersonFabricio/sdd-kit#readme",
   "repository": {