spec-first-claude 0.6.0-beta.8 → 0.7.0-beta.1

package/bin/cli.js

@@ -8,19 +8,19 @@ const args = process.argv.slice(2);
 const command = args[0];
 
 function printUsage() {
-  console.log('Usage:');
-  console.log('  spec-first-claude init --name=<project-name> [--target=<path>]');
-  console.log('  spec-first-claude update [--target=<path>] [--force]');
+  console.log('Uso:');
+  console.log('  spec-first-claude init --name=<nome-do-projeto> [--target=<caminho>]');
+  console.log('  spec-first-claude update [--target=<caminho>] [--force]');
   console.log('');
-  console.log('Commands:');
-  console.log('  init     Create a new spec-first project');
-  console.log('  update   Update an existing project with new framework files');
-  console.log('           (adds missing files, updates framework files like commands/adapters/agents)');
+  console.log('Comandos:');
+  console.log('  init     Cria um novo projeto spec-first');
+  console.log('  update   Atualiza projeto existente com arquivos novos do framework');
+  console.log('           (adiciona faltantes, atualiza commands/adapters/agents/templates)');
   console.log('');
-  console.log('Options:');
-  console.log('  --name=<name>    Project name (required for init)');
-  console.log('  --target=<path>  Target directory (defaults to ./<name> for init, cwd for update)');
-  console.log('  --force          Force update all files, not just framework files (use with caution)');
+  console.log('Opções:');
+  console.log('  --name=<nome>      Nome do projeto (obrigatório no init)');
+  console.log('  --target=<path>    Diretório destino (default: ./<nome> no init, cwd no update)');
+  console.log('  --force            Força atualizar TODOS arquivos, não só os do framework (cuidado)');
 }
 
 function parseArgs(args) {
@@ -40,7 +40,7 @@ if (command === 'init') {
   const opts = parseArgs(args.slice(1));
 
   if (!opts.name) {
-    console.error('Error: --name is required.\n');
+    console.error('Erro: --name é obrigatório.\n');
     printUsage();
     process.exit(1);
   }
@@ -64,7 +64,7 @@ if (command === 'init') {
 } else {
   printUsage();
   if (command) {
-    console.error(`\nUnknown command: "${command}"`);
+    console.error(`\nComando desconhecido: "${command}"`);
   }
   process.exit(command ? 1 : 0);
 }

package/lib/init.js

@@ -42,19 +42,31 @@ function init({ name, templatesDir, targetDir }) {
   const dest = targetDir || path.resolve(process.cwd(), name);
 
   const existed = fs.existsSync(dest);
-  console.log(`\n${existed ? 'Initializing' : 'Creating'} project "${name}" in ${dest}\n`);
+  console.log(`\n${existed ? 'Inicializando' : 'Criando'} projeto "${name}" em ${dest}\n`);
 
   const replacements = { [PLACEHOLDER]: name };
   copyDir(templatesDir, dest, replacements);
   patchProjectName(dest, name);
 
-  console.log(`Done! Project "${name}" is ready.`);
-  console.log('\nNext steps:');
+  console.log(`Pronto! Projeto "${name}" criado.`);
+  console.log('\nPróximos passos:');
   console.log(`  1. cd ${name}`);
-  console.log('  2. Create a folder in workspace/Input/ with your project files (e.g. workspace/Input/my_app/)');
-  console.log('  3. (Optional) Copy sfw.config.yml.example to sfw.config.yml and configure your backend');
-  console.log('  4. Open Claude Code in the project and run: /sfw-start <folder-name>');
-  console.log('     Framework detects first-run automatically (creates docs/) vs feature (updates docs/).');
+  console.log('  2. Crie uma pasta em workspace/Input/ com os insumos do seu projeto');
+  console.log('     (ex: workspace/Input/meu_app/requisitos.md)');
+  console.log('');
+  console.log('  3. (Opcional) Configure o backend de input/output:');
+  console.log('       cp sfw.config.yml.example sfw.config.yml');
+  console.log('     Sem isso, o framework roda 100% local (sem Confluence/etc.)');
+  console.log('');
+  console.log('  4. (Opcional, se vai usar Confluence) Prepare o ambiente ANTES de abrir o Claude:');
+  console.log('       node .claude/scripts/bootstrap-confluence.js');
+  console.log('     Valida uvx, coleta credenciais, gera .mcp.json e pré-cacheia o MCP.');
+  console.log('     Evita o ciclo "abrir Claude → faltar dep → reiniciar".');
+  console.log('');
+  console.log('  5. Abra o Claude Code no diretório do projeto e rode:');
+  console.log('       /sfw-start <nome-da-pasta-em-Input>');
+  console.log('     O framework detecta first-run automaticamente (cria docs/) vs feature');
+  console.log('     (atualiza docs/ via merge).');
   console.log('');
 }
 

package/lib/update.js

@@ -18,36 +18,36 @@ function update({ templatesDir, targetDir, force }) {
   const dest = targetDir || process.cwd();
 
   if (!fs.existsSync(dest)) {
-    console.error(`Error: directory "${dest}" does not exist.`);
-    console.error('Run "spec-first-claude init --name=<name>" first to create a project.');
+    console.error(`Erro: diretório "${dest}" não existe.`);
+    console.error('Rode "spec-first-claude init --name=<nome>" primeiro pra criar o projeto.');
     process.exit(1);
   }
 
   const claudeDir = path.join(dest, '.claude');
   if (!fs.existsSync(claudeDir)) {
-    console.error('Error: not a spec-first project (missing .claude/ directory).');
-    console.error('Run "spec-first-claude init --name=<name>" first.');
+    console.error('Erro: não é um projeto spec-first (pasta .claude/ não encontrada).');
+    console.error('Rode "spec-first-claude init --name=<nome>" primeiro.');
     process.exit(1);
   }
 
-  console.log(`\nUpdating project in ${dest}\n`);
+  console.log(`\nAtualizando projeto em ${dest}\n`);
 
   const stats = { added: [], updated: [], skipped: 0 };
   syncDir(templatesDir, dest, force, stats, dest);
 
   console.log('');
   if (stats.added.length > 0) {
-    console.log(`Added (${stats.added.length}):`);
+    console.log(`Adicionados (${stats.added.length}):`);
     for (const f of stats.added) console.log(`  + ${f}`);
   }
   if (stats.updated.length > 0) {
-    console.log(`Updated (${stats.updated.length}):`);
+    console.log(`Atualizados (${stats.updated.length}):`);
     for (const f of stats.updated) console.log(`  ~ ${f}`);
   }
   if (stats.added.length === 0 && stats.updated.length === 0) {
-    console.log('Already up to date — no new files to add.');
+    console.log('Já está atualizado — nenhum arquivo novo pra adicionar.');
   } else {
-    console.log(`\n${stats.added.length} added, ${stats.updated.length} updated, ${stats.skipped} unchanged`);
+    console.log(`\n${stats.added.length} adicionado(s), ${stats.updated.length} atualizado(s), ${stats.skipped} inalterado(s)`);
   }
   console.log('');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-claude",
-  "version": "0.6.0-beta.8",
+  "version": "0.7.0-beta.1",
   "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/CHANGELOG.md

@@ -8,6 +8,128 @@
 
 ---
 
+## 0.7.0-beta.1 (2026-04-13) — Redesign v4 (BREAKING)
+
+Reestruturação arquitetural baseada em feedback de uso real do v3. TRD ressuscitado
+como peer do PRD, SDD eliminado, aprovação por persona. Pipeline continua unificado
+via `/sfw-start`.
+
+### Breaking
+
+- **TRD ressuscitado** — peer do PRD, aprovado pelo dev. Não é o TRD antigo
+  transiente: agora tem papel próprio (source técnica autoritativa).
+- **SDD eliminado** — camada intermediária desnecessária quando PRD+TRD são bem
+  estruturados. `specs/{nome}/` deriva direto de PRD+TRD. `docs/` atualizado via
+  `/merge-docs` a partir de PRD+TRD.
+- **Aprovação por persona** — PM aprova PRD (`prd_aprovado: true`), dev aprova TRD
+  (`trd_aprovado: true`). Flags no `.context.md`. Em time pequeno, user faz as 2
+  aprovações — não pula.
+- **Discovery obrigatório** — `/discovery` deixou de ser skill opcional e virou
+  passo obrigatório dentro do `/sfw-start`. Força entendimento antes da extração.
+- **PRD `empty` removido** — conceito obsoleto. Agora: scope puro-técnico tem
+  `prd_existe=false`; scope puro-produto tem `trd_existe=false`. Maioria tem ambos.
+- **backlog_extraido.md eliminado** — features futuras viram itens em PRD §11
+  Fora de Escopo com sugestão de `/sfw-start <nome>` próprio.
+- **Schema do `.context.md` mudou**: `prd_empty` → `prd_existe` + `prd_aprovado`;
+  adicionado `trd_existe` + `trd_aprovado`. Status fluxo tem novos estados:
+  `discovery_done → extract_done → prd_approved → trd_approved → design_done`.
+
+### Templates
+
+- `TRD.template.md` novo — 11 seções, organizado por área (§Sistema + §Área-X)
+- `PRD.template.md` refatorado — 13 seções puro-produto, sem conteúdo técnico
+- `sdd.template.md` deletado
+- `backlog-extraido.template.md` deletado
+- `context.template.md` schema v4
+- `extract-log.template.md` sem categorização "produto/tech" (obsoleta)
+- `specs/*.template.md` com ORIGEM atualizada: PRD+TRD em vez de SDD
+
+### Skills
+
+- `/sfw-start` — 2 aprovações + discovery obrigatório
+- `/extract` — gera PRD e/ou TRD conforme conteúdo dos insumos (Reader + Produto-Analyzer + Tech-Analyzer)
+- `/design` — consome PRD+TRD aprovados, gera docs/ (first-run) + specs/
+- `/merge-docs` — diff semântico PRD+TRD ↔ docs/ (agente Integrator promovido pra Opus)
+- `/plan` — entrada PRD+TRD+specs/, tasks com `Ref TRD` em vez de `Ref SDD`
+- `/publish` — adicionado TRD à whitelist; SDD removido
+
+### Agents
+
+- Doc Writer reescrito: fonte muda de "SDD §Sistema" para "PRD + TRD"
+- Coders (backend/frontend/db/infra) e Reviewers: refs de "SDD §X" → "TRD §X" ou "specs/{nome}/"
+
+### Migração de v3 (0.6.x) pra v4
+
+```bash
+# 1. Atualizar kit
+npx spec-first-claude@beta update
+
+# 2. Para cada scope em andamento: migrar .context.md
+#    - Remover `prd_empty`
+#    - Adicionar `prd_existe`, `trd_existe`, `prd_aprovado`, `trd_aprovado`
+#    - Se scope já tem SDD: extrair conteúdo técnico pra TRD.md manual
+
+# 3. SDDs antigos em workspace/Output/{nome}/sdd.md ficam como legado
+#    (nenhum skill v4 lê eles). Deletar quando confortável.
+```
+
+### Versionamento
+
+- Bump **minor** (0.6 → 0.7) pelo breaking. v3 (`0.6.0-beta.10`) permanece no npm
+  como histórico.
+- Publicado com tag `beta`. Promoção para `latest` apenas após validação em uso real.
+
+---
+
+## 0.6.0-beta.10 (2026-04-13)
+
+### `bootstrap-confluence.js` agora é idempotente
+
+Script agora lê `.mcp.json` existente e reusa valores da entry `atlassian` em
+vez de perguntar tudo de novo:
+
+- Se `CONFLUENCE_URL` já existe: mostra URL atual, pergunta "Manter? [S/n]"
+- Se `CONFLUENCE_USERNAME` já existe: mostra email atual, pergunta "Manter? [S/n]"
+- Se `CONFLUENCE_API_TOKEN` já existe: mostra token mascarado (`abcd…wxyz`), pergunta "Manter? [S/n]"
+- Default ENTER = manter. Responder `n` abre o prompt completo da informação.
+
+Se todos os 3 campos foram mantidos: detecta que nada mudou e **não reescreve**
+`.mcp.json` (evita dirty git). Se mudou algo: reescreve preservando outras
+entries MCP (Supabase, GitHub, etc.).
+
+Útil pra: reexecução após novo rebuild do MCP, rotação apenas do token, debug
+de setup sem perder credenciais já válidas.
+
+---
+
+## 0.6.0-beta.9 (2026-04-13)
+
+### CLI em pt-BR + dica de bootstrap-confluence no init
+
+Mensagens do CLI (`init` e `update`) traduzidas para pt-BR — usuário final é o público.
+
+Mensagem do `init` reescrita para deixar **explícito o passo opcional de pré-setup
+do Confluence**:
+
+```
+Pronto! Projeto "X" criado.
+
+Próximos passos:
+  1. cd X
+  2. Crie uma pasta em workspace/Input/ com os insumos do seu projeto
+  3. (Opcional) Configure o backend de input/output:
+       cp sfw.config.yml.example sfw.config.yml
+  4. (Opcional, se vai usar Confluence) Prepare o ambiente ANTES de abrir o Claude:
+       node .claude/scripts/bootstrap-confluence.js
+  5. Abra o Claude Code e rode: /sfw-start <nome-da-pasta>
+```
+
+O passo 4 era invisível antes — só aparecia inline na "Dica" do skill `/mcp`.
+Agora aparece logo no fim do `init`, no momento exato em que o usuário vai decidir
+se prepara o Confluence ou não.
+
+---
+
 ## 0.6.0-beta.8 (2026-04-13)
 
 ### Novo: `bootstrap-confluence.js` (opcional, pré-Claude)

package/templates/.claude/adapters/SETUP.md

@@ -148,7 +148,7 @@ output:
       config:
         space_key: "ST"                # ← mesmo Space Key
         parent_page_id: "294931"       # ← Page ID da page Output
-      publishes: [PRD, SDD, Progresso]
+      publishes: [PRD, TRD, Progresso]
       mode: auto                       # ← auto | manual | off
       conflict_detection: version
       approval_mechanism: label
@@ -225,7 +225,7 @@ output:
       adapter: filesystem
       config:
         root_path: "workspace/Output"
-      publishes: [PRD, SDD, Progresso]
+      publishes: [PRD, TRD, Progresso]
       mode: auto
       conflict_detection: hash
       approval_mechanism: none
@@ -282,7 +282,7 @@ E coloque `mode: off` nos targets de Confluence.
          config:
            space_key: "ST"
            parent_page_id: "294931"
-         publishes: [PRD, SDD, Progresso]
+         publishes: [PRD, TRD, Progresso]
          mode: auto
    ```
 3. Re-rode `/extract`, `/design`, `/plan` — os artefatos locais serão publicados

package/templates/.claude/adapters/filesystem.md

@@ -259,7 +259,7 @@ output:
       adapter: filesystem
       config:
         root_path: "./workspace/Output"
-      publishes: [PRD, SDD, Progresso]
+      publishes: [PRD, TRD, Progresso]
       mode: auto
       conflict_detection: hash
       approval_mechanism: none
@@ -284,7 +284,7 @@ output:
       adapter: filesystem
       config:
         root_path: "./tests/fixtures/barbearia/actual_output"
-      publishes: [PRD, SDD, Progresso]
+      publishes: [PRD, TRD, Progresso]
       mode: auto
 ```
 

package/templates/.claude/adapters/naming.md

@@ -56,7 +56,7 @@ O `sfw.config.yml` define 2 templates de output:
 **`output_container`** é o agrupador. No Confluence vira uma page-mãe com
 children; no filesystem vira uma pasta.
 
-**`output_artifact`** é o item individual (PRD, SDD, Progresso). No
+**`output_artifact`** é o item individual (PRD, TRD, Progresso). No
 Confluence é title de uma child page; no filesystem é nome de arquivo
 (adapter adiciona `.md` automaticamente).
 

package/templates/.claude/adapters/registry.md

@@ -178,13 +178,13 @@ output:
       config:
         space_key: ST
         parent_page_id: "294931"
-      publishes: [PRD, SDD, Progresso]
+      publishes: [PRD, TRD, Progresso]
       mode: auto
     - name: local-mirror
       adapter: filesystem
       config:
         root_path: "./mirror"
-      publishes: [PRD, SDD, Progresso, backlog]
+      publishes: [PRD, TRD, Progresso]
       mode: auto
 ```