spec-first-copilot 0.5.0-beta.9 → 0.6.0-beta.10

package/README.md

@@ -6,7 +6,7 @@ Kit completo para desenvolvimento **spec-first** com [GitHub Copilot](https://gi
 
 Em vez de pedir pra IA "cria um CRUD de usuarios", voce fornece insumos brutos (docs, SQLs, rascunhos) e a IA:
 
-1. **Extrai** requisitos estruturados (PRD/TRD)
+1. **Extrai** requisitos estruturados (PRD)
 2. **Espera sua aprovacao** (checkpoint humano)
 3. **Gera design tecnico** (SDD) — fonte unica de verdade
 4. **Planeja tasks** com dependencias e fases
@@ -49,20 +49,25 @@ MeuProjeto/
 ├── .github/                          <- AI OPERATIONAL CONFIG
 │   ├── copilot-instructions.md       <- Regras globais pro agente
 │   ├── rules.md                      <- Regras de desenvolvimento
+│   ├── CHANGELOG.md                  <- Historico do framework
 │   ├── instructions/                 <- Regras por contexto
-│   ├── templates/                    <- 15 templates do workflow
-│   │   ├── feature/                  <- PRD, TRD, SDD, tasks, etc.
-│   │   ├── estrutura/                <- 5 templates de estado do sistema
+│   ├── templates/                    <- Templates do workflow
+│   │   ├── feature/                  <- PRD, SDD, context, extract-log, Progresso, backlog, projetos.yaml
+│   │   ├── specs/                    <- brief, contracts, scenarios, tasks (projecoes pro agent)
+│   │   ├── estrutura/                <- 5 templates de sintese cross-feature
 │   │   └── global/                   <- Progresso global
-│   ├── skills/                       <- 9 skills do workflow
-│   │   ├── sf-setup-projeto/
-│   │   ├── sf-feature/
+│   ├── adapters/                     <- SourceAdapter + ConfluenceAdapter + FilesystemAdapter
+│   ├── skills/                       <- 11 skills do workflow
+│   │   ├── sf-mcp/
+│   │   ├── sf-load/
+│   │   ├── sf-publish/
+│   │   ├── sf-start/                 <- entrada unica (substitui sf-new-project + sf-feature)
 │   │   ├── sf-discovery/
 │   │   ├── sf-extract/
 │   │   ├── sf-design/
 │   │   ├── sf-plan/
 │   │   ├── sf-dev/
-│   │   ├── sf-merge-delta/
+│   │   ├── sf-merge-docs/            <- renomeado de sf-merge-delta
 │   │   └── sf-session-finish/
 │   └── agents/                       <- 7 agentes especializados
 │       ├── backend-coder.md          <- .NET 8 / C#
@@ -72,22 +77,23 @@ MeuProjeto/
 │       ├── doc-writer.md             <- Documentacao
 │       ├── reviewer.md               <- Code review
 │       └── security-reviewer.md      <- Auditoria de seguranca
-├── docs/                             <- SYSTEM KNOWLEDGE (gerado pelo /sf-design)
+├── docs/                             <- SINTESE CROSS-FEATURE (atualizada pelo /sf-merge-docs)
 │   ├── architecture.md               <- Containers, stack, ambientes, deploy
 │   ├── domain.md                     <- Visao de negocio + modelo de dados
 │   ├── conventions.md                <- Auth, authz, LGPD, env vars, monitoramento
 │   ├── apiContracts.md               <- Rotas, paginacao, erros, catalogo de endpoints
-│   ├── decisions.md                  <- ADRs
-│   └── specs/                        <- Especs por feature (projecoes do SDD, pro agent)
-│       └── {nome}/
-│           ├── brief.md              <- Problema/Solucao
-│           ├── contracts.md          <- Dados/API/Integracoes
-│           ├── scenarios.md          <- Fluxos/UI/CAs
-│           └── tasks.md              <- Tabela unica com coluna Area
-├── workspace/                        <- TEAM CONTENT (futuro wiki)
-│   ├── Input/                        <- Jogue seus insumos aqui
-│   │   └── setup_projeto/            <- Insumos do bootstrap
-│   └── Output/                       <- Docs narrativos pro humano (PRD, TRD, SDD, Progresso)
+│   └── decisions.md                  <- ADRs (append-only)
+├── specs/                            <- AGENT CONTRACTS (projecoes do SDD pro coder)
+│   └── {nome}/
+│       ├── brief.md                  <- Problema/Solucao (SDD §1+§2+§10)
+│       ├── contracts.md              <- Sistema + Áreas tocadas (SDD §3-§7)
+│       ├── scenarios.md              <- Fluxos/UI/CAs (SDD §5.2+§8+§9)
+│       └── tasks.md                  <- Tabela unica com coluna Area
+├── workspace/                        <- TEAM CONTENT
+│   ├── Input/                        <- Jogue seus insumos aqui (nome livre)
+│   │   └── {nome}/                   <- ex: app_barbearia, feat_login
+│   └── Output/                       <- Docs narrativos pro humano (PRD, SDD, Progresso)
+├── sfw.config.yml.example            <- Manifesto de adapters (input/output)
 └── .gitignore
 ```
 
@@ -99,7 +105,8 @@ MeuProjeto/
    cd MeuProjeto
    ```
 
-2. Jogue seus insumos em `workspace/Input/setup_projeto/` — qualquer formato:
+2. Jogue seus insumos em `workspace/Input/<nome>/` — qualquer formato.
+   `<nome>` e livre: `app_barbearia`, `bootstrap`, `feat_login`, `bug_checkout`, etc.
    - `.md`, `.txt` (descricoes, requisitos, decisoes)
    - `.sql` (modelagem de banco)
    - `.csv`, `.xml`, `.html` (dados, configs)
@@ -107,40 +114,38 @@ MeuProjeto/
 
 3. Abra o VS Code com Copilot Chat e rode:
    ```
-   /sf-setup-projeto
+   /sf-start <nome>
    ```
 
-4. O pipeline comeca. A IA vai:
-   - Extrair um TRD dos seus insumos
-   - Parar e pedir sua aprovacao
+4. O pipeline comeca. A IA detecta automaticamente se e first-run (docs/ ausente)
+   ou feature (docs/ ja existe). Nao ha skills diferentes pra setup vs feature.
+
+   - Extrai PRD dos seus insumos (pode ser empty em scopes puro-tecnicos)
+   - Para e pede sua aprovacao
    - Depois voce roda `/sf-design`, `/sf-plan`, `/sf-dev` na sequencia
 
 ## Pipeline completo
 
 ```
-workspace/Input/ (seus arquivos)
+workspace/Input/<nome>/ (seus arquivos)
     |
     v
-/sf-setup-projeto  -->  /sf-extract  -->  TRD (voce revisa e aprova)
-                                            |
-                                            v
-                                         /sf-design  -->  SDD + docs/ (5 arquivos)
+/sf-start <nome>  -->  /sf-extract  -->  PRD (voce revisa e aprova)
+                                                |
+                                                v
+                                         /sf-design  -->  SDD + docs/ (first-run: cria 5 arquivos)
+                                                                        (feature: gera só §Área-X + §11 delta)
                                                             |
                                                             v
                                                          /sf-plan  -->  tasks + Progresso.md
                                                                           |
                                                                           v
                                                                        /sf-dev  -->  codigo nos repos
-                                                                                       |
-                                                                                       v
-                                                                                    (merge-delta automatico)
+                                                                                       + /sf-merge-docs automatico
+                                                                                         (aplica §11 em docs/)
 ```
 
-Para features (apos o setup):
-
-```
-/sf-feature nome  -->  /sf-extract  -->  PRD  -->  /sf-design  -->  /sf-plan  -->  /sf-dev (inclui merge-delta)
-```
+Mesmo comando pra bootstrap e feature — `first_run` e derivado da ausencia/presenca de `docs/`.
 
 ## Opcoes do CLI
 

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-copilot init --name=<project-name> [--target=<path>]');
-  console.log('  spec-first-copilot update [--target=<path>] [--force]');
+  console.log('Uso:');
+  console.log('  spec-first-copilot init --name=<nome-do-projeto> [--target=<caminho>]');
+  console.log('  spec-first-copilot 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 skills/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 skills/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

@@ -1,6 +1,5 @@
 const fs = require('fs');
 const path = require('path');
-const { execSync } = require('child_process');
 
 const PLACEHOLDER = '{{PROJECT_NAME}}';
 
@@ -8,7 +7,9 @@ function copyDir(src, dest, replacements) {
   fs.mkdirSync(dest, { recursive: true });
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
+    // Rename _gitignore → .gitignore (npm strips .gitignore from packages)
+    const destName = entry.name === '_gitignore' ? '.gitignore' : entry.name;
+    const destPath = path.join(dest, destName);
     if (entry.isDirectory()) {
       copyDir(srcPath, destPath, replacements);
     } else {
@@ -24,7 +25,7 @@ function copyFile(src, dest, replacements) {
   const textExtensions = ['.md', '.yaml', '.yml', '.json', '.js', '.ts', '.gitignore', '.gitkeep', ''];
   const ext = path.extname(src).toLowerCase();
   const basename = path.basename(src);
-  const isText = textExtensions.includes(ext) || basename.startsWith('.');
+  const isText = textExtensions.includes(ext) || basename.startsWith('.') || basename === '_gitignore';
 
   if (isText) {
     let content = fs.readFileSync(src, 'utf-8');
@@ -41,29 +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);
 
-  try {
-    execSync('git init', { cwd: dest, stdio: 'pipe' });
-    execSync('git add -A', { cwd: dest, stdio: 'pipe' });
-    execSync(`git commit -m "chore: init project ${name} via spec-first-workflow"`, {
-      cwd: dest,
-      stdio: 'pipe',
-    });
-    console.log('Git initialized with initial commit.');
-  } catch {
-    console.log('Git init skipped (git not available or error).');
-  }
-
-  console.log(`\nDone! 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. Run /sf-new-project <folder-name> to start the pipeline');
+  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 VS Code:');
+  console.log('       node .github/scripts/bootstrap-confluence.js');
+  console.log('     Valida uvx, coleta credenciais, gera .mcp.json e pré-cacheia o MCP.');
+  console.log('     Evita o ciclo "abrir Copilot → faltar dep → reiniciar VS Code".');
+  console.log('');
+  console.log('  5. Abra o VS Code com Copilot Chat e rode:');
+  console.log('       /sf-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

@@ -20,37 +20,38 @@ 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-copilot init --name=<name>" first to create a project.');
+    console.error(`Erro: diretório "${dest}" não existe.`);
+    console.error('Rode "spec-first-copilot init --name=<nome>" primeiro pra criar o projeto.');
     process.exit(1);
   }
 
   const githubDir = path.join(dest, '.github');
   if (!fs.existsSync(githubDir)) {
-    console.error('Error: not a spec-first project (missing .github/ directory).');
-    console.error('Run "spec-first-copilot init --name=<name>" first.');
+    console.error('Erro: não é um projeto spec-first (pasta .github/ não encontrada).');
+    console.error('Rode "spec-first-copilot 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('');
 }
 
@@ -58,7 +59,8 @@ function syncDir(src, dest, force, stats, root) {
   fs.mkdirSync(dest, { recursive: true });
   for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
     const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
+    const destName = entry.name === '_gitignore' ? '.gitignore' : entry.name;
+    const destPath = path.join(dest, destName);
     if (entry.isDirectory()) {
       syncDir(srcPath, destPath, force, stats, root);
     } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-copilot",
-  "version": "0.5.0-beta.9",
+  "version": "0.6.0-beta.10",
   "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
   "bin": {
     "spec-first-copilot": "bin/cli.js"