{"_id":"@acaldas12/kspec","_rev":"4-625608a49a57bd33c34a0a79f07a1428","name":"@acaldas12/kspec","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@acaldas12/kspec","version":"1.0.0","keywords":["sdd","spec-driven-development","ddd","lean-inception","claude-code","claude","codex","agents-md","cursor","copilot","gemini","windsurf","scaffold","boilerplate","agent-skills"],"author":{"name":"igoruehara"},"license":"MIT","_id":"@acaldas12/kspec@1.0.0","maintainers":[{"name":"acaldas12","email":"acaldas12@gmail.com"}],"homepage":"https://github.com/igoruehara/spec-driven#readme","bugs":{"url":"https://github.com/igoruehara/spec-driven/issues"},"bin":{"kspec":"bin/cli.mjs","spec-driven":"bin/cli.mjs"},"dist":{"shasum":"7ca8b95083e7e17ed3bc4c3290356da8f3230630","tarball":"https://registry.npmjs.org/@acaldas12/kspec/-/kspec-1.0.0.tgz","fileCount":70,"integrity":"sha512-jrlPLhnY63qMNxAOErj4DRkMyiYtterya4hZTo+ZJsXcT0dbkNHBqAGfoCzMOlrkVz7mxKmMedZ0KKaYIK4tVw==","signatures":[{"sig":"MEYCIQDVYJnzhPiPrDlF7N+I9U/G0fBqMQeZDeX4sM/mvHyxwAIhANZdB+02AOMcoHd+AWZQ/yMgUSao49eYRBQCwvuh8wsP","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":277392},"type":"module","engines":{"node":">=18"},"gitHead":"03d8e8bfcf2f4540e0dd2e925fe7a318d2835138","scripts":{"ui":"node bin/cli.mjs ui","dev":"node bin/cli.mjs ui","pack:check":"npm pack --dry-run","test:scaffold":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test","prepublishOnly":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test"},"_npmUser":{"name":"acaldas12","email":"acaldas12@gmail.com"},"repository":{"url":"git+https://github.com/igoruehara/spec-driven.git","type":"git"},"_npmVersion":"10.8.2","description":"KSpec SDD OS — Scaffold e Interface Visual de Spec-Driven Development (SDD) com Harness Master e integração a CLIs de IA (Claude Code, Gemini CLI, Codex, Cursor).","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/kspec_1.0.0_1788320717872_0.9847034382876412","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@acaldas12/kspec","version":"1.0.1","keywords":["sdd","spec-driven-development","ddd","lean-inception","claude-code","claude","codex","agents-md","cursor","copilot","gemini","windsurf","scaffold","boilerplate","agent-skills"],"author":{"name":"igoruehara"},"license":"MIT","_id":"@acaldas12/kspec@1.0.1","maintainers":[{"name":"acaldas12","email":"acaldas12@gmail.com"}],"homepage":"https://github.com/igoruehara/spec-driven#readme","bugs":{"url":"https://github.com/igoruehara/spec-driven/issues"},"bin":{"kspec":"bin/cli.mjs","spec-driven":"bin/cli.mjs"},"dist":{"shasum":"d30c90fadfe7040e8eeb864698563403d82bc606","tarball":"https://registry.npmjs.org/@acaldas12/kspec/-/kspec-1.0.1.tgz","fileCount":70,"integrity":"sha512-Unidf4wjRfL7TzIKujJ9pcncHRJdgxkDLwaFcbXh/G2jiZsRijnMO5Ghvl6BbYuQoMEAUaU+1aTS/08CplYsIw==","signatures":[{"sig":"MEQCIHzfDR5P1bU9ShCneNkHJF6zSaVtWOeGy/e+oNsBVFyQAiAXOVf/qtwNIRoilNMSlWACxRSRE9sg1sFd667mLWat/A==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":283635},"type":"module","engines":{"node":">=18"},"gitHead":"02bf17ece7128acf02c397aa9869bdce1fbc233f","scripts":{"ui":"node bin/cli.mjs ui","dev":"node bin/cli.mjs ui","pack:check":"npm pack --dry-run","test:scaffold":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test","prepublishOnly":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test"},"_npmUser":{"name":"acaldas12","email":"acaldas12@gmail.com"},"repository":{"url":"git+https://github.com/igoruehara/spec-driven.git","type":"git"},"_npmVersion":"10.8.2","description":"KSpec SDD OS — Scaffold e Interface Visual de Spec-Driven Development (SDD) com Harness Master e integração a CLIs de IA (Claude Code, Gemini CLI, Codex, Cursor).","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/kspec_1.0.1_1788353815156_0.5189988606723013","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@acaldas12/kspec","version":"1.0.2","keywords":["sdd","spec-driven-development","ddd","lean-inception","claude-code","claude","codex","agents-md","cursor","copilot","gemini","windsurf","scaffold","boilerplate","agent-skills"],"author":{"name":"igoruehara"},"license":"MIT","_id":"@acaldas12/kspec@1.0.2","maintainers":[{"name":"acaldas12","email":"acaldas12@gmail.com"}],"homepage":"https://github.com/igoruehara/spec-driven#readme","bugs":{"url":"https://github.com/igoruehara/spec-driven/issues"},"bin":{"kspec":"bin/cli.mjs","spec-driven":"bin/cli.mjs"},"dist":{"shasum":"18cffe6ca7fe6d4c2e72346ab81686cac45c8aac","tarball":"https://registry.npmjs.org/@acaldas12/kspec/-/kspec-1.0.2.tgz","fileCount":70,"integrity":"sha512-DkTvbQCq7JjO+I3CIqJb9nlU3J5cANPGdAQPIhjVG5XYxUljhewT1XXOu7LpaUXWMI50j5dTtJ3u8lKKCps8sQ==","signatures":[{"sig":"MEYCIQDjEUysTgoyezktfUB3EqPFT8nZnsjSkxxtzmOJwb48dAIhAJA7OXneVe4CcKcERbDEAe8fguUu2CKlfu/JbeCqoNVi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":283680},"type":"module","engines":{"node":">=18"},"gitHead":"02bf17ece7128acf02c397aa9869bdce1fbc233f","scripts":{"ui":"node bin/cli.mjs ui","dev":"node bin/cli.mjs ui","pack:check":"npm pack --dry-run","test:scaffold":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test","prepublishOnly":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test"},"_npmUser":{"name":"acaldas12","email":"acaldas12@gmail.com"},"repository":{"url":"git+https://github.com/igoruehara/spec-driven.git","type":"git"},"_npmVersion":"10.8.2","description":"KSpec SDD OS — Scaffold e Interface Visual de Spec-Driven Development (SDD) com Harness Master e integração a CLIs de IA (Claude Code, Gemini CLI, Codex, Cursor).","directories":{},"_nodeVersion":"20.20.2","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/kspec_1.0.2_1788354939021_0.3436359018295474","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@acaldas12/kspec","version":"1.0.3","description":"KSpec SDD OS — Scaffold e Interface Visual de Spec-Driven Development (SDD) com Harness Master e integração a CLIs de IA (Claude Code, Gemini CLI, Codex, Cursor).","type":"module","bin":{"kspec":"bin/cli.mjs","spec-driven":"bin/cli.mjs"},"engines":{"node":">=18"},"keywords":["sdd","spec-driven-development","ddd","lean-inception","claude-code","claude","codex","agents-md","cursor","copilot","gemini","windsurf","scaffold","boilerplate","agent-skills"],"author":{"name":"igoruehara"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/igoruehara/spec-driven.git"},"bugs":{"url":"https://github.com/igoruehara/spec-driven/issues"},"homepage":"https://github.com/igoruehara/spec-driven#readme","publishConfig":{"access":"public"},"scripts":{"ui":"node bin/cli.mjs ui","dev":"node bin/cli.mjs ui","pack:check":"npm pack --dry-run","test:scaffold":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test","prepublishOnly":"node bin/cli.mjs .tmp-scaffold-test --all --force --yes && rm -rf .tmp-scaffold-test"},"_id":"@acaldas12/kspec@1.0.3","gitHead":"0eda95cc18eac3c541df22a34dade9dd7c328c15","_nodeVersion":"20.20.2","_npmVersion":"10.8.2","dist":{"integrity":"sha512-bi9re3E+R49LAKO0h5V3ra2A3pv6tHFIn1e+LJX8ANPZLwEFj6Yme6QnK1EZfCq7oeouovk4JQDoJSyz7ODuhw==","shasum":"57e7f00343be843d404bfba5a4c72e8a15b14892","tarball":"https://registry.npmjs.org/@acaldas12/kspec/-/kspec-1.0.3.tgz","fileCount":70,"unpackedSize":301258,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID9seS/jj5pXAsEEKTi4QW+4yjGomN9I9FVEB7EYN/1/AiAJqkTBPm1vryQ1JqLJs5YsJndC00WuIJcJBnHQHGJDzQ=="}]},"_npmUser":{"name":"acaldas12","email":"acaldas12@gmail.com"},"directories":{},"maintainers":[{"name":"acaldas12","email":"acaldas12@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/kspec_1.0.3_1788356705020_0.5160364126256785"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-02T03:45:17.669Z","modified":"2026-09-02T13:45:05.420Z","1.0.0":"2026-09-02T03:45:18.036Z","1.0.1":"2026-09-02T12:56:55.322Z","1.0.2":"2026-09-02T13:15:39.170Z","1.0.3":"2026-09-02T13:45:05.226Z"},"bugs":{"url":"https://github.com/igoruehara/spec-driven/issues"},"author":{"name":"igoruehara"},"license":"MIT","homepage":"https://github.com/igoruehara/spec-driven#readme","keywords":["sdd","spec-driven-development","ddd","lean-inception","claude-code","claude","codex","agents-md","cursor","copilot","gemini","windsurf","scaffold","boilerplate","agent-skills"],"repository":{"type":"git","url":"git+https://github.com/igoruehara/spec-driven.git"},"description":"KSpec SDD OS — Scaffold e Interface Visual de Spec-Driven Development (SDD) com Harness Master e integração a CLIs de IA (Claude Code, Gemini CLI, Codex, Cursor).","maintainers":[{"name":"acaldas12","email":"acaldas12@gmail.com"}],"readme":"# KSpec SDD OS (`kspec`)\n\nPlataforma e Scaffold de **Spec-Driven Development (SDD)** para agentes de IA — [Claude Code](https://claude.com/claude-code), [Codex](https://developers.openai.com/codex/), Cursor, GitHub Copilot, Gemini CLI e Windsurf.\n\nInclui **Interface Visual Interativa (BuildX SDD OS)** com Kanban, Spec Editor e **Harness Master** integrados diretamente aos CLIs de LLMs instaladas na sua máquina, com **persistência 100% orientada a arquivos (Zero Database)**.\n\n```bash\n# 🚀 Iniciar a interface visual interativa (Kanban + Spec Editor + Projetos)\nnpx kspec ui\n\n# ou no diretório do seu projeto para scaffoldar a esteira SDD\nnpx kspec\n\n# ou criando numa pasta nova\nnpx kspec meu-projeto\n\n# não-interativo: escolha os clientes pela flag (ao menos um é obrigatório)\nnpx kspec --agent=claude,cursor   # Claude + Cursor\n```\n\n## Clientes suportados\n\nO **Claude é a fonte canônica** do conteúdo (formato mais rico), mas é um **cliente escolhível\ncomo qualquer outro** — nenhum entra por padrão e é obrigatório selecionar ao menos um. Os demais\nclientes são **views geradas a partir do mesmo conteúdo** — escolha quais no menu interativo ou via `--agent`.\n\n| Cliente | Instruções | Skills / commands |\n|---|---|---|\n| **Claude Code** | `CLAUDE.md` | `.claude/skills/*/SKILL.md` (+ hook `SessionStart`) |\n| **Codex** | `AGENTS.md` | `.agents/skills/*/SKILL.md` |\n| **Cursor** | `.cursor/rules/sdd.mdc` | `.cursor/commands/*.md` |\n| **GitHub Copilot** | `.github/copilot-instructions.md` | `.github/prompts/*.prompt.md` |\n| **Gemini CLI** | `GEMINI.md` | `.gemini/commands/*.toml` |\n| **Windsurf** | `.windsurf/rules/sdd.md` | `.windsurf/workflows/*.md` |\n\n> O `AGENTS.md` do Codex também é lido nativamente por Cursor, Copilot, Gemini e Windsurf —\n> então ele já cobre a camada de instruções de quase todo o ecossistema. As views nativas de\n> cada cliente são geradas só quando você as pede.\n\n## Em que se baseia\n\n| Prática | Sentido aqui | O que aporta à esteira |\n|---|---|---|\n| **Lean Inception** | workshop de descoberta (Paulo Caroli) | visão, personas e MVP — *o que construir primeiro* |\n| **DDD** | Domain-Driven Design (Eric Evans) | linguagem ubíqua e bounded contexts — *o modelo do negócio* |\n| **TDD** | Technical Design Doc / RFC | design antes de codar, com alternativas — *como no nível de sistema* |\n| **SDD** | Spec-Driven Development | a spec é a fonte da verdade — *o contrato que dirige a implementação* |\n\nEncadeadas: **Lean Inception** (descobrir) → **DDD** (modelar) → **TDD** (desenhar) → **SDD** (especificar e implementar).\n\n## O que ele instala\n\n```\nseu-projeto/\n├── CLAUDE.md                  # convenções que o agente segue (verificação de conhecimento, camadas, DoD)\n├── README.md                  # o manual da esteira SDD\n├── .claude/skills/            # 15 skills (ver abaixo) — + as views dos clientes extras escolhidos\n├── .spec-driven/manifest.json # quais clientes foram gerados (usado pelo update)\n├── .github/workflows/         # esteira.yml — gate de conformidade na CI\n├── scripts/                   # audit-esteira.mjs + validate-mermaid.mjs + eval-spec-fidelity.mjs\n├── docs/\n│   ├── glossary.md · STATE.md\n│   ├── product/               # vision · stakeholders · journeys · features · mvp-canvas · roadmap\n│   ├── architecture/          # overview (5 eixos) · context-map · diagrams · assessment · adr/\n│   └── engineering/           # TESTING · metrics · integrations · agentic-layer (+ _templates)\n├── specs/                     # uma pasta por feature (0001-…) + quick/ + _templates/\n└── src/                       # estrutura em camadas DDD\n```\n\n## As skills\n\n| Skill | Responsabilidade |\n|---|---|\n| `/kickoff` | orquestra a constituição do projeto (greenfield ou brownfield) |\n| `/integracoes` | ferramentas do time + MCPs (read-first, trava de conta/workspace) |\n| `/mapear` | mapeia um codebase existente → `assessment.md` |\n| `/diagramar` | arquitetura de alto nível em Mermaid → `diagrams.md` |\n| `/roadmap` | constrói/revisa o roadmap com o time |\n| `/camada-agentica` | gera rules, subagents, skills e workflows/CI |\n| `/nova-feature` | abre uma feature no padrão SDD (tier → spec → tasks) |\n| `/clarificar` | sabatina: entrevista implacável (uma pergunta por vez) que afia spec/design ambíguos antes de construir |\n| `/validar` | UAT: gates, AC→teste, SPEC_DEVIATION, DoD |\n| `/revisar-pr` | gate de conformidade SDD no PR/MR |\n| `/setup-ci` | pipeline CI/CD que materializa os gates |\n| `/metricas` | Lead Time, Throughput e maturidade de Continuous Delivery/Deployment |\n| `/auditar` | valida a conformidade da esteira (frontmatter, links, rastreabilidade) |\n| `/evals` | mede fidelidade spec→código (AC cobertos por task/teste, SPEC_DEVIATION) |\n| `/handoff` | pausa/retoma a sessão via `docs/STATE.md` |\n\n## Exemplo completo\n\n[`examples/pulse/`](examples/pulse/) é um produto fictício levado pela esteira **ponta a ponta** —\ndiscovery (vision/features) → spec (AC) → tasks → código → testes — com **audit e eval verdes** e\nos testes passando. A prova de que o fluxo fecha, não só artefatos soltos.\n\n## Uso\n\n```bash\nnpx @igoruehara/spec-driven [diretório-alvo] [opções]\n```\n\n### Exemplos\n\n```bash\nnpx @igoruehara/spec-driven                # scaffolda no diretório atual\nnpx @igoruehara/spec-driven meu-projeto    # cria/usa a pasta ./meu-projeto\nnpx @igoruehara/spec-driven . --force      # sobrescreve arquivos existentes\nnpx @igoruehara/spec-driven update         # atualiza só a esteira, preserva seus docs\n```\n\n### Comandos\n\n| Comando  | O que faz |\n|----------|-----------|\n| *(init)* | scaffolda a esteira completa. Arquivos existentes são **mantidos** (use `--force`). |\n| `update` | atualiza só a **maquinaria** (skills, hooks, `_templates`, scripts, CI). **Preserva** seus docs/specs e mostra o diff antes de aplicar. |\n\n### Opções\n\n| Opção             | O que faz                                                              |\n|-------------------|-----------------------------------------------------------------------|\n| `--agent=a,b`     | clientes a gerar (`claude,codex,cursor,copilot,gemini,windsurf`); pula o menu; exige ≥ 1 |\n| `--all`           | gera as views de **todos** os clientes suportados (inclui Claude)     |\n| `--force`         | sobrescreve arquivos que já existem                                   |\n| `--yes`, `-y`     | pula a confirmação interativa (exige `--agent=` ou `--all` p/ saber os clientes) |\n\n> No `update`, `--agent=` **adiciona** um cliente novo a um projeto já existente (ex.:\n> `npx @igoruehara/spec-driven update --agent=codex` materializa o Codex e o mantém atualizado).\n\n> 🔒 **Seguro em projeto existente:** no init, arquivos existentes são **mantidos** (nada sobrescrito\n> sem `--force`). No `update`, só a maquinaria da esteira é refeita — seus docs e specs ficam intactos.\n\n## Depois de scaffoldar\n\n1. `git init` (se ainda não for um repo).\n2. No Claude Code, **aprove o hook de contexto** na 1ª sessão — um `SessionStart`\n   (`.claude/settings.json`) que carrega o contexto base (STATE, vision, roadmap) automaticamente.\n   Requer Node na máquina.\n3. Rode `/integracoes` (se já conhece o ferramental) → `/kickoff`.\n4. Comece a primeira feature com `/nova-feature`.\n\n## Licença\n\nMIT\n","readmeFilename":"README.md"}