spec-first-claude 0.5.0-beta.3 → 0.5.0-beta.4

package/lib/init.js

@@ -62,8 +62,8 @@ function init({ name, templatesDir, targetDir }) {
   console.log(`\nDone! Project "${name}" is ready.`);
   console.log('\nNext steps:');
   console.log(`  1. cd ${name}`);
-  console.log('  2. Add your input files to workspace/Input/setup_projeto/');
-  console.log('  3. Run /setup-projeto to start the pipeline');
+  console.log('  2. Create a folder in workspace/Input/ with your project files (e.g. workspace/Input/my_app/)');
+  console.log('  3. Run /new-project <folder-name> to start the pipeline');
   console.log('');
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-claude",
-  "version": "0.5.0-beta.3",
+  "version": "0.5.0-beta.4",
   "description": "Spec-first workflow kit for Claude Code — AI-driven development with specs, not guesswork",
   "bin": {
     "spec-first-claude": "bin/cli.js"

package/templates/.claude/commands/new-project.md

@@ -0,0 +1,72 @@
+# /new-project <nome>
+
+Orquestrador de bootstrap técnico do projeto.
+Cria contexto TRD a partir dos insumos em `workspace/Input/{nome}/`, chama /extract e para no checkpoint de aprovação.
+
+Simétrico ao `/feature <nome>` — a diferença é que gera TRD (perfil técnico) em vez de PRD (perfil de produto).
+
+## Argumento
+
+`<nome>` = nome do item no Input. O usuário nomeia livremente (ex: `app_barbearia`, `meu_sistema`, `api_pagamentos`). O agent busca `workspace/Input/{nome}/` — se não existir, para com erro.
+
+## Execução
+
+Siga EXATAMENTE os passos da skill em ordem. Leia o arquivo completo antes de agir.
+
+### Pré-condições — validar TODAS antes de prosseguir
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | `workspace/Input/{nome}/` existe | Parar → "Crie a pasta workspace/Input/{nome}/ e adicione seus insumos" |
+| 2 | Pasta contém pelo menos 1 arquivo (ignorar .gitkeep) | Parar → "Adicione insumos na pasta (aceitos: .md, .txt, .sql, .xml, .html, .json, .csv, .png, .jpg, .pdf — qualquer formato)" |
+| 3 | `workspace/Output/{nome}/.context.md` não existe ou status é `not_started` | Parar → "Este escopo já está em andamento. Verifique o status em .context.md" |
+
+### Passos
+
+1. Criar `workspace/Output/{nome}/` se não existir
+
+2. Criar `.context.md`:
+```yaml
+---
+nome: "{nome}"
+tipo: "project"
+documento: "TRD"
+pm_path: "workspace/Input/{nome}/"
+status: "not_started"
+ultima_skill: "/new-project"
+atualizado_em: "{{ISO_DATETIME}}"
+---
+```
+
+3. Sugerir /discovery (RECOMENDADO):
+```
+Recomendo rodar /discovery antes da extração para análise profunda dos insumos.
+Quer rodar /discovery workspace/Input/{nome}/ agora? (s/n)
+```
+Se SIM → rodar discovery, salvar discovery.md em workspace/Output/{nome}/
+Se NÃO → pular direto para extract
+
+4. Executar /extract {nome} (seguir o command /extract)
+
+5. CHECKPOINT — Parar e informar:
+```
+TRD gerado em workspace/Output/{nome}/TRD.md
+
+Revise o documento. Quando estiver satisfeito, execute:
+  /design {nome}
+
+Se precisar adicionar mais insumos, coloque na pasta workspace/Input/{nome}/
+e execute:
+  /extract {nome}
+```
+
+**O orquestrador encerra aqui.** Próximos passos do usuário:
+1. `/design {nome}` (pergunta aprovação → gera SDD + docs/ + projetos.yaml)
+2. `/plan {nome}` (gera tasks com campo Repo por task)
+3. `/dev {nome}` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
+
+### Notas
+- docs/ é gerado pelo /design (passo 3), não por tasks DOC
+- `projetos.yaml` é gerado pelo /design (passo 3b) — mapeia serviços para repos
+- Repos são criados/clonados pelo /dev (INFRA-001) dentro de `projetos/`
+- /merge-delta NÃO se aplica ao new-project (é criação, não atualização)

package/templates/CLAUDE.md

@@ -24,7 +24,7 @@ Verificar que TODOS os 9 commands estão acessíveis:
 
 | Command | Caminho |
 |---------|---------|
-| `/setup-projeto` | `.claude/commands/setup-projeto.md` |
+| `/new-project` | `.claude/commands/new-project.md` |
 | `/feature` | `.claude/commands/feature.md` |
 | `/discovery` | `.claude/commands/discovery.md` |
 | `/extract` | `.claude/commands/extract.md` |
@@ -76,7 +76,7 @@ ESTE REPO (projeto-base) = ORQUESTRADOR
 
 ```
 workspace/Input/ (qualquer arquivo)
-    ↓ /setup-projeto (uma vez) ou /feature (por feature)
+    ↓ /new-project <nome> (TRD — bootstrap técnico) ou /feature <nome> (PRD — feature)
 /discovery → análise profunda dos insumos (RECOMENDADO, opcional)
     ↓
 /extract → PRD ou TRD em workspace/Output/{nome}/ (checkpoint — usuário revisa e aprova)
@@ -93,7 +93,7 @@ workspace/Input/ (qualquer arquivo)
 
 | Command | Tipo | O que faz |
 |---------|------|-----------|
-| `/setup-projeto` | Orquestrador | Bootstrap: cria .context.md, chama /extract, para no checkpoint. Roda UMA vez |
+| `/new-project <nome>` | Orquestrador | Bootstrap técnico: cria .context.md tipo TRD, chama /extract, para no checkpoint |
 | `/feature <nome>` | Orquestrador | Feature: cria .context.md tipo PRD, chama /extract, para no checkpoint |
 | `/discovery <path>` | Utilitária | Análise profunda dos insumos (RECOMENDADO antes do /extract) |
 | `/extract <nome>` | Atômico | Lê workspace/Input/{nome}/ → gera PRD ou TRD. Re-executável para novos insumos |
@@ -166,8 +166,7 @@ specs/                       ← AGENT CONTRACTS (projeções do SDD pro coder)
 
 workspace/                   ← TEAM CONTENT (futuro wiki)
 ├── Input/                   ← Insumos brutos (QUALQUER formato — nunca modificar)
-│   ├── setup_projeto/       ← Insumos de bootstrap
-│   └── feat_*/              ← Insumos por feature
+│   └── {nome}/              ← Nomeado livremente pelo usuário (ex: app_barbearia, feat_login)
 └── Output/                  ← Artefatos humanos gerados pelo workflow
     └── {nome}/
         ├── PRD.md ou TRD.md ← Requirements (gerado pelo /extract)

package/templates/.claude/commands/setup-projeto.md

@@ -1,68 +0,0 @@
-# /setup-projeto
-
-Orquestrador de bootstrap do projeto. Executa uma única vez.
-Cria contexto TRD, chama /extract e para no checkpoint de aprovação.
-
-## Execução
-
-Siga EXATAMENTE os passos da skill em ordem. Leia o arquivo completo antes de agir.
-
-### Pré-condições — validar TODAS antes de prosseguir
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | `workspace/Input/setup_projeto/` existe | Parar → "Crie a pasta workspace/Input/setup_projeto/ e adicione seus insumos" |
-| 2 | Pasta contém pelo menos 1 arquivo (ignorar .gitkeep) | Parar → "Adicione insumos na pasta (aceitos: .md, .txt, .sql, .xml, .html, .json, .csv, .png, .jpg, .pdf — qualquer formato)" |
-| 3 | `docs/` está vazio ou contém apenas .gitkeep | Parar → "Setup já foi executado. Use /feature para novas funcionalidades" |
-| 4 | `workspace/Output/setup_projeto/.context.md` não existe ou status é `not_started` | Parar → "Setup já está em andamento. Verifique o status em .context.md" |
-
-### Passos
-
-1. Criar `workspace/Output/setup_projeto/` se não existir
-
-2. Criar `.context.md`:
-```yaml
----
-nome: "setup_projeto"
-tipo: "setup"
-documento: "TRD"
-pm_path: "workspace/Input/setup_projeto/"
-status: "not_started"
-ultima_skill: "/setup-projeto"
-atualizado_em: "{{ISO_DATETIME}}"
----
-```
-
-3. Sugerir /sf-discovery (RECOMENDADO):
-```
-📋 Recomendo rodar /sf-discovery antes da extração para análise profunda dos insumos.
-Quer rodar /sf-discovery workspace/Input/setup_projeto/ agora? (s/n)
-```
-Se SIM → rodar discovery, salvar discovery.md em workspace/Output/setup_projeto/
-Se NÃO → pular direto para extract
-
-4. Executar /extract setup_projeto (seguir o command /extract)
-
-5. CHECKPOINT — Parar e informar:
-```
-✅ TRD gerado em workspace/Output/setup_projeto/TRD.md
-
-Revise o documento. Quando estiver satisfeito, execute:
-  /design setup_projeto
-
-Se precisar adicionar mais insumos, coloque na pasta workspace/Input/setup_projeto/
-e execute:
-  /extract setup_projeto
-```
-
-**O orquestrador encerra aqui.** Próximos passos do usuário:
-1. `/design setup_projeto` (pergunta aprovação → gera SDD + docs/ + projetos.yaml)
-2. `/plan setup_projeto` (gera tasks com campo Repo por task)
-3. `/dev setup_projeto` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
-
-### Notas
-- Esta skill roda UMA ÚNICA VEZ por projeto
-- docs/ é gerado pelo /design (passo 3), não por tasks DOC
-- `projetos.yaml` é gerado pelo /design (passo 3b) — mapeia serviços para repos
-- Repos são criados/clonados pelo /dev (INFRA-001) dentro de `projetos/`
-- /merge-delta NÃO se aplica ao setup (é criação, não atualização)