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

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/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');
@@ -47,23 +48,12 @@ function init({ name, templatesDir, targetDir }) {
   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(`Done! Project "${name}" is ready.`);
   console.log('\nNext steps:');
   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('  3. Copy sfw.config.yml.example to sfw.config.yml and configure your backend');
+  console.log('  4. Run /sf-new-project <folder-name> to start the pipeline');
   console.log('');
 }
 

package/lib/update.js

@@ -51,6 +51,7 @@ function update({ templatesDir, targetDir, force }) {
   } else {
     console.log(`\n${stats.added.length} added, ${stats.updated.length} updated, ${stats.skipped} unchanged`);
   }
+
   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.1",
   "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
   "bin": {
     "spec-first-copilot": "bin/cli.js"

package/templates/.github/CHANGELOG.md

@@ -8,6 +8,68 @@
 
 ---
 
+## 0.6.0-beta.1 (2026-04-12) — Redesign v3 (BREAKING)
+
+Redesign estrutural eliminando o TRD e unificando o pipeline em uma skill única.
+Ver `planodetarefas.md §10` (no repo SFW) pra racional completo e 9 decisões arquiteturais.
+
+### Breaking
+
+- **TRD eliminado** — template `TRD.template.md` removido; conteúdo técnico agora vive no SDD §Sistema (novas subseções 3.1-3.7) e é sintetizado em `docs/` cross-feature
+- **`/sf-new-project` + `/sf-feature` → `/sf-start <nome>`** — entrada única. Detecta automaticamente:
+  - `docs/` ausente → first_run (bootstrap: popula SDD §Sistema completo + cria docs/ + projetos.yaml)
+  - `docs/` existe → feature (popula §Área-X tocadas + §11 Delta Specs)
+- **`/sf-merge-delta` → `/sf-merge-docs`** — nome alinhado ao outcome. "Delta Specs" continua como conceito no SDD §11
+- **PRD empty-allowed** — scopes puro-técnicos marcam `empty: true` em vez de forçar PRD vazio
+- **SDD template reorganizado** — §Sistema (baseline técnico) + §Área-Backend/Frontend/DB/Infra gateáveis por scope
+- **docs/ = síntese cross-feature** (não projeção) — estável, referencia SDDs quando precisa detalhe
+- **Checklist de temas críticos FIXO** — 8 temas unificados (antes era split TRD/PRD). Analyzer consulta `docs/` antes de marcar ambiguidade
+- **Skills: 12 → 11** — `sf-new-project`, `sf-feature`, `sf-merge-delta` removidas; `sf-start`, `sf-merge-docs` adicionadas
+
+### Migração
+
+Projetos em `0.5.0-beta.X` precisam:
+
+1. Rodar `npx spec-first-copilot update` (atualiza .github/, CHANGELOG, templates)
+2. Se tiver `.context.md` com `tipo: feature|setup` ou `documento: PRD|TRD`: migrar pra schema v3:
+   ```yaml
+   first_run: true|false    # true se docs/ não existia quando bootstrap rodou
+   prd_empty: false         # true se TRD existia mas PRD não (raro)
+   areas_tocadas: [BACK, DB]  # derivar do SDD existente
+   ```
+3. Se tiver `TRD.md` em `workspace/Output/{scope}/`: manter como referência histórica ou deletar
+4. Rodar `/sf-merge-docs <scope>` manualmente pra features que estavam em `dev_done` (aplica §11 em `docs/`)
+
+### Novo fluxo (v3)
+
+```
+/sf-start <nome>
+  → /sf-load (se sfw.config.yml)
+  → /sf-discovery (opcional)
+  → /sf-extract → PRD.md (pode ser empty) + .extract-log.md com tech chunks
+  ↓ checkpoint
+/sf-design → SDD (§Sistema + §Área-X) + specs/{nome}/
+  → first_run: cria docs/ + projetos.yaml
+  → feature: §11 Delta Specs pro /sf-merge-docs
+/sf-plan → specs/{nome}/tasks.md + Progresso.md
+/sf-dev → código + Security Review + /sf-merge-docs automático
+```
+
+### Templates atualizados
+
+- `PRD.template.md` — campo `empty` no Meta; rodapé pra caso empty
+- `sdd.template.md` — 552 linhas, §Sistema + §Área-X gateáveis + §12 Ambiguidades com "Consultei docs/?"
+- `context.template.md` — schema v3 (`first_run`, `prd_empty`, `areas_tocadas`)
+- 5 templates em `estrutura/` — papel de síntese cross-feature, origem SDD §Sistema
+- `backlog-extraido.template.md` — scope agnóstico, sugere `/sf-start <nome>` pra promover items
+
+### Arquivos removidos
+
+- `.github/templates/feature/TRD.template.md`
+- `.github/skills/sf-new-project/`, `sf-feature/`, `sf-merge-delta/`
+
+---
+
 ## 0.5.0-beta.7 (2026-04-12)
 
 ### Novo: Comando `/sf-load <nome>`

package/templates/.github/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, TRD, SDD, Progresso]
+      publishes: [PRD, SDD, 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, TRD, SDD, Progresso]
+      publishes: [PRD, SDD, Progresso]
       mode: auto
       conflict_detection: hash
       approval_mechanism: none
@@ -238,7 +238,7 @@ mkdir -p workspace/Input/meu_escopo
 # Adicione seus arquivos de insumo na pasta
 ```
 
-Pronto. `/new-project meu_escopo` funciona direto.
+Pronto. `/sf-start meu_escopo` funciona direto.
 
 ---
 
@@ -282,7 +282,7 @@ E coloque `mode: off` nos targets de Confluence.
          config:
            space_key: "ST"
            parent_page_id: "294931"
-         publishes: [PRD, TRD, SDD, Progresso]
+         publishes: [PRD, SDD, Progresso]
          mode: auto
    ```
 3. Re-rode `/extract`, `/design`, `/plan` — os artefatos locais serão publicados

package/templates/.github/adapters/confluence.md

@@ -161,7 +161,7 @@ futuro, trocar. Hoje `get_page` é o caminho mais direto. Custo: ~1 request HTTP
 1. Chamar tool com:
    - `space_key: config.space_key`
    - `parent_id: parentId`
-   - `title: title` (já vem formatado pelo naming engine — ex: `"app_barbearia - TRD"`)
+   - `title: title` (já vem formatado pelo naming engine — ex: `"app_barbearia - PRD"`)
    - `content: content` (markdown — MCP converte pra storage format)
    - `content_format: "markdown"`
 2. Retornar:
@@ -262,7 +262,7 @@ Antes de usar este adapter, usuário precisa:
       + credenciais hardcoded (NUNCA commitar — está no `.gitignore` do kit)
 - [ ] Token Atlassian com scope de leitura + escrita no space alvo
 - [ ] `space_key` descoberto (ex: via `confluence_search` ou URL do Confluence)
-- [ ] Página raiz do projeto criada (manualmente ou via `/new-project`)
+- [ ] Página raiz do projeto criada (manualmente ou via `/sf-start`)
 - [ ] Claude Code reiniciado após qualquer mudança no `.mcp.json`
 
 Bootstrap do kit (§9.9.P0.3) automatiza isso.

package/templates/.github/adapters/errors.md

@@ -1,7 +1,7 @@
 # SourceAdapter — Contrato de Erros
 
 > Classes de erro tipadas que qualquer adapter **deve** lançar em vez de
-> `throw new Error(...)`. As skills (`/load`, `/publish`, `/new-project`,
+> `throw new Error(...)`. As skills (`/load`, `/publish`, `/sf-start`,
 > `/extract`, `/design`, `/plan`) fazem `catch` tipado e decidem o que fazer.
 >
 > Arquivo é referência conceitual, não runtime. A implementação real vive no
@@ -100,7 +100,7 @@ foi deletado. Inclui: `fetchContent`, `getVersion`, `update`, `listChildren`,
 - `/load`: pode ser scope removido no backend. Loga e pula (não fatal).
 - `/publish`: se título existia no publish-log mas sumiu do backend → o caller
   DEVE chamar `create` em vez de `update` (fallback implícito).
-- `/new-project`: se parent root não existe → fatal (config errada).
+- `/sf-start`: se parent root não existe → fatal (config errada).
 
 ---
 

package/templates/.github/adapters/filesystem.md

@@ -200,11 +200,11 @@ arquivos de spec/doc são pequenos (KB). Se precisar otimizar, substituir por
 7. Retornar `{ itemId: <relative path>, version }`
 
 **Convenção sobre `title`**: o caller já aplica `naming.output_artifact`
-(ex: `"app_barbearia - TRD"`). O adapter **adiciona extensão `.md`** se o
+(ex: `"app_barbearia - PRD"`). O adapter **adiciona extensão `.md`** se o
 title não já tiver uma — filesystem exige extensão, Confluence não. Esta é a
 assimetria principal entre os 2 adapters.
 
-Exemplo: `title = "app_barbearia - TRD"` → arquivo `app_barbearia - TRD.md`.
+Exemplo: `title = "app_barbearia - PRD"` → arquivo `app_barbearia - PRD.md`.
 
 ---
 
@@ -259,7 +259,7 @@ output:
       adapter: filesystem
       config:
         root_path: "./workspace/Output"
-      publishes: [PRD, TRD, SDD, Progresso]
+      publishes: [PRD, SDD, 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, TRD, SDD, Progresso]
+      publishes: [PRD, SDD, Progresso]
       mode: auto
 ```
 

package/templates/.github/adapters/interface.md

@@ -1,7 +1,7 @@
 # SourceAdapter — Interface
 
 > Contrato que **todo adapter** (Confluence, Filesystem, Notion, JIRA, …) deve
-> implementar. As skills `/load`, `/publish`, `/new-project` **nunca** falam com
+> implementar. As skills `/load`, `/publish`, `/sf-start` **nunca** falam com
 > backends direto — elas falam com essa interface.
 >
 > Este arquivo é **especificação**, não código executável. A implementação real
@@ -42,7 +42,7 @@ interface SourceAdapter {
   validateConfig(config: object): void;
 
   // ------------------------------------------------------------------
-  // LEITURA — usado por /load e /new-project
+  // LEITURA — usado por /load e /sf-start
   // ------------------------------------------------------------------
 
   /**
@@ -263,7 +263,7 @@ Qualquer adapter **DEVE** garantir:
   ├── listChildren(output.parent_page_id)       ← acha container existente por título
   ├── se container não existe:
   │     └── create(output.parent_page_id, containerTitle, seed) → container criado
-  ├── applyNaming(output_artifact, {scope, type}) ← ex: "app_barbearia - TRD"
+  ├── applyNaming(output_artifact, {scope, type}) ← ex: "app_barbearia - PRD"
   ├── listChildren(container.id)                ← busca artefato por título
   ├── se artefato não existe:
   │     └── create(container.id, artifactTitle, content) → log version

package/templates/.github/adapters/naming.md

@@ -15,12 +15,12 @@ Antes da decisão do adapter layer, títulos eram hardcoded em string literal
 no código das skills:
 
 ```
-title = `out_${scope}_TRD`;    // ← hardcoded em 5 lugares
+title = `out_${scope}_PRD`;    // ← hardcoded em 5 lugares
 ```
 
 Isso forçava:
 1. Qualquer mudança de convenção → tocar N arquivos
-2. Times com outra convenção (ex: `[TRD] scope`) não conseguiam usar SFW
+2. Times com outra convenção (ex: `[PRD] scope`) não conseguiam usar SFW
 3. Testes precisavam mockar strings mágicas
 
 Agora a convenção vive em **um** arquivo (`sfw.config.yml`) e é aplicada via
@@ -33,7 +33,7 @@ templating engine centralizado.
 | Placeholder | O que substitui | Fonte |
 |-------------|-----------------|-------|
 | `{scope}` | Nome do item no Input (ex: `app_barbearia`, `feat_login`) | Argumento da skill |
-| `{type}` | Tipo do artefato (ex: `TRD`, `SDD`, `PRD`, `Progresso`) | Contexto da skill |
+| `{type}` | Tipo do artefato (ex: `PRD`, `SDD`, `Progresso`) | Contexto da skill |
 
 **Nenhum outro placeholder é aceito no MVP.** Expansões futuras entram por
 proposta explícita (ex: `{phase}`, `{repo}`, `{timestamp}`).
@@ -51,17 +51,17 @@ O `sfw.config.yml` define 2 templates de output:
 | Template | Onde | Exemplo |
 |----------|------|---------|
 | `output_container` | Subpasta/page-mãe por scope no Output | `"out_{scope}"` → `out_app_barbearia` |
-| `output_artifact` | Nome do artefato dentro do container | `"{scope} - {type}"` → `app_barbearia - TRD` |
+| `output_artifact` | Nome do artefato dentro do container | `"{scope} - {type}"` → `app_barbearia - PRD` |
 
 **`output_container`** é o agrupador. No Confluence vira uma page-mãe com
 children; no filesystem vira uma pasta.
 
-**`output_artifact`** é o item individual (TRD, SDD, PRD, Progresso). No
+**`output_artifact`** é o item individual (PRD, SDD, Progresso). No
 Confluence é title de uma child page; no filesystem é nome de arquivo
 (adapter adiciona `.md` automaticamente).
 
 **Por que `{scope}` no `output_artifact`?** No Confluence, titles são
-unique per SPACE — sem `{scope}`, duas features teriam `TRD` e `SDD` com
+unique per SPACE — sem `{scope}`, duas features teriam `PRD` e `SDD` com
 mesmo título e colidiria. No filesystem não colide porque vive dentro de
 pastas diferentes, então o user pode configurar `output_artifact: "{type}"`
 se preferir limpar redundância.
@@ -94,7 +94,7 @@ function applyNaming(template: string, vars: {
    Nunca retorna a string literal `{module}` — isso vazaria inconsistência pros backends.
 
 2. **Placeholder sem valor lança erro.**
-   Template `"{scope} - {type}"` com `vars = { type: "TRD" }`
+   Template `"{scope} - {type}"` com `vars = { type: "PRD" }`
    → `NamingTemplateError: placeholder {scope} required but not provided`.
 
 3. **Chaves extras em `vars` são ignoradas.**
@@ -156,12 +156,12 @@ function applyNaming(template: string, vars: Record<string, string | undefined>)
 | Template | vars | Resultado | OK? |
 |----------|------|-----------|-----|
 | `out_{scope}` | `{scope:"app_barbearia"}` | `out_app_barbearia` | ✅ |
-| `{scope} - {type}` | `{scope:"app_barbearia", type:"TRD"}` | `app_barbearia - TRD` | ✅ |
+| `{scope} - {type}` | `{scope:"app_barbearia", type:"PRD"}` | `app_barbearia - PRD` | ✅ |
 | `{type}` | `{type:"SDD"}` | `SDD` | ✅ (filesystem dentro de subpasta) |
 | `[{type}] {scope}` | `{type:"PRD", scope:"feat_login"}` | `[PRD] feat_login` | ✅ |
 | `{type}/{scope}` | `{type:"docs", scope:"arch"}` | `docs/arch` | ✅ (adapter sanitiza `/` depois) |
-| `{scope} - {type}` | `{type:"TRD"}` | — | ❌ `NamingTemplateError: placeholder {scope} required` |
-| `{type} {module}` | `{type:"TRD"}` | — | ❌ `NamingTemplateError: unknown placeholder "{module}"` |
+| `{scope} - {type}` | `{type:"PRD"}` | — | ❌ `NamingTemplateError: placeholder {scope} required` |
+| `{type} {module}` | `{type:"PRD"}` | — | ❌ `NamingTemplateError: unknown placeholder "{module}"` |
 | `hello world` | `{}` | `hello world` | ✅ (sem placeholders) |
 | `out_{scope}` | `{scope:""}` | — | ❌ (string vazia é tratada como ausente) |
 
@@ -172,7 +172,7 @@ function applyNaming(template: string, vars: Record<string, string | undefined>)
 | Skill / operação | Template consumido | Placeholders usados |
 |------------------|-------------------|---------------------|
 | `/load` busca scope no Input | Nenhum — usa o nome do item **tal qual está** no backend | — |
-| `/extract` publica TRD/PRD | `output_container` + `output_artifact` (type=TRD ou PRD) | `{scope}`, `{type}` |
+| `/extract` publica PRD | `output_container` + `output_artifact` (type=PRD) | `{scope}`, `{type}` |
 | `/design` publica SDD | `output_container` + `output_artifact` (type=SDD) | `{scope}`, `{type}` |
 | `/plan` publica Progresso | `output_container` + `output_artifact` (type=Progresso) | `{scope}`, `{type}` |
 | `/load` grava scope folder local | `output_container` (reuso pro path local) | `{scope}` |
@@ -194,14 +194,14 @@ naming:
   output_artifact: "{scope} - {type}"
 ```
 
-Cenário: `/new-project app_barbearia` → `/extract` → `/design` → `/plan`
+Cenário: `/sf-start app_barbearia` → `/extract` → `/design` → `/plan`
 
 | Passo | Template usado | vars | Resultado |
 |-------|---------------|------|-----------|
 | `/load` busca item no Input | nenhum | — | Encontra page "app_barbearia" pelo nome |
 | `/load` grava local | `output_container` | `{scope:"app_barbearia"}` | Pasta `workspace/Input/out_app_barbearia/` |
 | `/extract` cria container no Output | `output_container` | `{scope:"app_barbearia"}` | Page/pasta `out_app_barbearia` |
-| `/extract` publica TRD | `output_artifact` | `{scope:"app_barbearia", type:"TRD"}` | `app_barbearia - TRD` (dentro do container) |
+| `/extract` publica PRD | `output_artifact` | `{scope:"app_barbearia", type:"PRD"}` | `app_barbearia - PRD` (dentro do container) |
 | `/design` publica SDD | `output_artifact` | `{scope:"app_barbearia", type:"SDD"}` | `app_barbearia - SDD` |
 | `/plan` publica Progresso | `output_artifact` | `{scope:"app_barbearia", type:"Progresso"}` | `app_barbearia - Progresso` |
 
@@ -209,7 +209,7 @@ Resultado no Confluence:
 ```
 Output (page-mãe)
 └── out_app_barbearia (container)
-    ├── app_barbearia - TRD
+    ├── app_barbearia - PRD
     ├── app_barbearia - SDD
     └── app_barbearia - Progresso
 ```
@@ -218,7 +218,7 @@ Resultado no filesystem:
 ```
 workspace/Output/
 └── out_app_barbearia/
-    ├── app_barbearia - TRD.md
+    ├── app_barbearia - PRD.md
     ├── app_barbearia - SDD.md
     └── app_barbearia - Progresso.md
 ```

package/templates/.github/adapters/registry.md

@@ -153,7 +153,7 @@ Quando skill chama `loadConfig("sfw.config.yml")`:
 5. **Valida `naming.*`** — templates precisam ser strings não-vazias; placeholders
    desconhecidos detectados agora (antecipa erro de runtime).
 6. **Valida coerência inter-seções**: ex., `output.targets[i].mode: auto` exige
-   `approval_mechanism` presente quando `publishes` contém TRD/PRD/SDD (artefatos
+   `approval_mechanism` presente quando `publishes` contém PRD/SDD (artefatos
    com gate de aprovação).
 
 Tudo no load. Se qualquer passo falha, skill para antes de tocar backend.
@@ -178,13 +178,13 @@ output:
       config:
         space_key: ST
         parent_page_id: "294931"
-      publishes: [PRD, TRD, SDD, Progresso]
+      publishes: [PRD, SDD, Progresso]
       mode: auto
     - name: local-mirror
       adapter: filesystem
       config:
         root_path: "./mirror"
-      publishes: [PRD, TRD, SDD, Progresso, backlog]
+      publishes: [PRD, SDD, Progresso, backlog]
       mode: auto
 ```
 

package/templates/.github/agents/doc-writer.md

@@ -1,7 +1,7 @@
 # Agent: Doc Writer
 
-> Especialista em geração de documentação técnica.
-> Usado pelo /design (setup) para gerar docs/ e pelo /merge-delta para atualizá-los.
+> Especialista em geração e atualização de documentação técnica de síntese cross-feature.
+> Usado pelo /sf-design (first-run) para gerar docs/ e pelo /sf-merge-docs para atualizá-los.
 
 ---
 
@@ -11,23 +11,27 @@
 |-------|-------|
 | Área | DOC |
 | Modelo padrão | Sonnet |
-| Lê | TRD/SDD (seções referenciadas) + template correspondente |
-| Nunca lê | PRD, PM, código fonte |
+| Lê | PRD (atores/entidades) + SDD (todas as seções técnicas) + template correspondente |
+| Nunca lê | PM bruto, código fonte |
 
 ## Responsabilidades
 
-1. **No setup (via /design passo 3)**: gerar os 5 docs de `docs/` a partir do TRD aprovado (architecture, domain, conventions, apiContracts, decisions)
-2. **Em features (via /merge-delta)**: atualizar os docs de `docs/` com Delta Specs do SDD §11
+1. **First-run (via /sf-design)**: gerar os 5 docs de `docs/` a partir do SDD aprovado (que já absorveu todo conteúdo técnico que antes ficava no TRD). docs/ é **síntese cross-feature** — estado consolidado do sistema, não duplicação do SDD.
+2. **Em features (via /sf-merge-docs)**: atualizar os docs de `docs/` com Delta Specs do SDD §11 da feature — adicionando/modificando/removendo conforme ADDED/MODIFIED/REMOVED.
 
-## Mapeamento TRD/SDD → docs/
+## Mapeamento SDD → docs/
 
-| Doc gerado | Fontes | Template |
+O SDD v3 tem uma seção §3 "Sistema" que centraliza o conteúdo técnico
+antes dividido entre TRD e SDD. Os 5 docs de `docs/` são projeções
+cross-feature dessas subseções:
+
+| Doc gerado | Fontes no SDD/PRD | Template |
 |-----------|--------|---------|
-| architecture.md | TRD §2 Stack + §3 Arquitetura + §6 Infra (ambientes/deploy/CI/rollback) | `.github/templates/estrutura/architecture.template.md` |
-| domain.md | TRD §1 Visão + §4 Modelo de Dados (+ SDD §3 em features) | `.github/templates/estrutura/domain.template.md` |
-| conventions.md | TRD §7 Segurança + §6 Infra (env vars/monitoramento) + §5 API (códigos de erro) + §2 Stack (alternativas/versionamento) | `.github/templates/estrutura/conventions.template.md` |
-| apiContracts.md | TRD §5 API (padrão geral, rotas, paginação, filtros, erros, catálogo) | `.github/templates/estrutura/apiContracts.template.md` |
-| decisions.md | SDD §2 Decisões + decisões iniciais de stack/arquitetura | `.github/templates/estrutura/decisions.template.md` |
+| architecture.md | SDD §3.1 Stack + §3.2 Arquitetura + §3.3 Ambientes + §3.4 Infra | `.github/templates/estrutura/architecture.template.md` |
+| domain.md | PRD §2 Atores + PRD §3 Entidades + SDD §6 §Área-DB (em features) | `.github/templates/estrutura/domain.template.md` |
+| conventions.md | SDD §3.5 Segurança + SDD §3.4 Infra (env vars) + SDD §3.6 Convenções de API + SDD §3.7 Monitoramento | `.github/templates/estrutura/conventions.template.md` |
+| apiContracts.md | SDD §3.6 Convenções de API + SDD §4.1 Endpoints (catálogo cross-feature) | `.github/templates/estrutura/apiContracts.template.md` |
+| decisions.md | SDD §2 Decisões de Design (ADRs extraídos) | `.github/templates/estrutura/decisions.template.md` |
 
 ## Regras
 
@@ -36,13 +40,14 @@
 | Template é lei | Toda seção do template preenchida — se não tem info, marcar "A definir" |
 | Instruções `<!-- -->` não vão pro doc | Bloco de instruções do agente é removido |
 | Changelog inicia vazio | Primeiro preenchimento não tem changelog |
-| Dados vêm do TRD/SDD | Nunca inventar informação — se TRD não tem, marcar "A definir" |
+| Dados vêm do SDD/PRD | Nunca inventar informação — se o SDD não tem, marcar "A definir" |
+| Síntese, não cópia | docs/ é estado consolidado — agregar, não duplicar literalmente o SDD |
 | Formato estruturado | Tabelas e listas, nunca texto narrativo longo |
 
 ## Comportamento
 
 1. **Ler template** → entender seções obrigatórias
-2. **Ler TRD/SDD** → extrair dados para cada seção
+2. **Ler SDD (e PRD quando aplicável)** → extrair dados para cada seção conforme mapeamento
 3. **Preencher** → seguindo formato do template exatamente
 4. **Remover instruções** → bloco `<!-- INSTRUÇÕES -->` não vai pro doc final
-5. **Commitar** → `docs(DOC-001): gerar architecture.md a partir do TRD`
+5. **Commitar** → `docs(DOC-001): gerar architecture.md a partir do SDD`