spec-first-copilot 0.3.0 → 0.5.0-beta.0

package/README.md

@@ -46,34 +46,42 @@ Isso cria a pasta `MeuProjeto/` com toda a estrutura pronta:
 ```
 MeuProjeto/
 ├── .ai/memory/napkin.md              <- Memoria persistente do projeto
-├── .github/
+├── .github/                          <- AI OPERATIONAL CONFIG
 │   ├── copilot-instructions.md       <- Regras globais pro agente
+│   ├── rules.md                      <- Regras de desenvolvimento
 │   ├── instructions/                 <- Regras por contexto
+│   ├── templates/                    <- 15 templates do workflow
+│   │   ├── feature/                  <- PRD, TRD, SDD, tasks, etc.
+│   │   ├── estrutura/                <- 5 templates de estado do sistema
+│   │   └── global/                   <- Progresso global
 │   ├── skills/                       <- 9 skills do workflow
-│   │   ├── sf-setup-projeto/         <- Bootstrap do projeto
-│   │   ├── sf-feature/              <- Pipeline de feature
-│   │   ├── sf-discovery/            <- Analise profunda de insumos
-│   │   ├── sf-extract/              <- PM -> PRD/TRD
-│   │   ├── sf-design/              <- PRD/TRD -> SDD
-│   │   ├── sf-plan/                <- SDD -> tasks
-│   │   ├── sf-dev/                 <- Executa tasks
-│   │   ├── sf-merge-delta/         <- Atualiza docs globais
-│   │   └── sf-pausar/             <- Encerra sessao
-│   └── agents/                      <- 7 agentes especializados
-│       ├── backend-coder.md         <- .NET 8 / C#
-│       ├── frontend-coder.md        <- React
-│       ├── db-coder.md              <- PostgreSQL
-│       ├── infra-coder.md           <- Docker
-│       ├── doc-writer.md            <- Documentacao
-│       ├── reviewer.md              <- Code review
-│       └── security-reviewer.md     <- Auditoria de seguranca
-├── docs/
-│   ├── PM/                          <- Jogue seus insumos aqui
-│   │   └── setup_projeto/           <- Insumos do bootstrap
-│   ├── _templates/                  <- 18 templates do workflow
-│   ├── Estrutura/                   <- Docs globais (gerados)
-│   └── Desenvolvimento/             <- Docs por feature (gerados)
-│       └── rules.md                 <- Regras de desenvolvimento
+│   │   ├── sf-setup-projeto/
+│   │   ├── sf-feature/
+│   │   ├── sf-discovery/
+│   │   ├── sf-extract/
+│   │   ├── sf-design/
+│   │   ├── sf-plan/
+│   │   ├── sf-dev/
+│   │   ├── sf-merge-delta/
+│   │   └── sf-session-finish/
+│   └── agents/                       <- 7 agentes especializados
+│       ├── backend-coder.md          <- .NET 8 / C#
+│       ├── frontend-coder.md         <- React
+│       ├── db-coder.md               <- PostgreSQL
+│       ├── infra-coder.md            <- Docker
+│       ├── doc-writer.md             <- Documentacao
+│       ├── reviewer.md               <- Code review
+│       └── security-reviewer.md      <- Auditoria de seguranca
+├── docs/                             <- SYSTEM KNOWLEDGE (gerado pelo /sf-design)
+│   ├── 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
+├── workspace/                       <- TEAM CONTENT (futuro wiki)
+│   ├── Input/                        <- Jogue seus insumos aqui
+│   │   └── setup_projeto/            <- Insumos do bootstrap
+│   └── Output/                       <- Docs por feature (gerados)
 └── .gitignore
 ```
 
@@ -85,7 +93,7 @@ MeuProjeto/
    cd MeuProjeto
    ```
 
-2. Jogue seus insumos em `docs/PM/setup_projeto/` — qualquer formato:
+2. Jogue seus insumos em `workspace/Input/setup_projeto/` — qualquer formato:
    - `.md`, `.txt` (descricoes, requisitos, decisoes)
    - `.sql` (modelagem de banco)
    - `.csv`, `.xml`, `.html` (dados, configs)
@@ -104,13 +112,13 @@ MeuProjeto/
 ## Pipeline completo
 
 ```
-docs/PM/ (seus arquivos)
+workspace/Input/ (seus arquivos)
     |
     v
 /sf-setup-projeto  -->  /sf-extract  -->  TRD (voce revisa e aprova)
                                             |
                                             v
-                                         /sf-design  -->  SDD + docs/Estrutura/
+                                         /sf-design  -->  SDD + docs/ (5 arquivos)
                                                             |
                                                             v
                                                          /sf-plan  -->  tasks + Progresso.md
@@ -119,13 +127,13 @@ docs/PM/ (seus arquivos)
                                                                        /sf-dev  -->  codigo nos repos
                                                                                        |
                                                                                        v
-                                                                                    /sf-merge-delta  -->  docs atualizados
+                                                                                    (merge-delta automatico)
 ```
 
 Para features (apos o setup):
 
 ```
-/sf-feature nome  -->  /sf-extract  -->  PRD  -->  /sf-design  -->  /sf-plan  -->  /sf-dev  -->  /sf-merge-delta
+/sf-feature nome  -->  /sf-extract  -->  PRD  -->  /sf-design  -->  /sf-plan  -->  /sf-dev (inclui merge-delta)
 ```
 
 ## Opcoes do CLI

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 docs/PM/setup_projeto/');
-  console.log('  3. Run /setup-projeto to start the pipeline');
+  console.log('  2. Add your input files to workspace/Input/setup_projeto/');
+  console.log('  3. Run /sf-setup-projeto to start the pipeline');
   console.log('');
 }
 

package/package.json

@@ -1,23 +1,31 @@
-{
-  "name": "spec-first-copilot",
-  "version": "0.3.0",
-  "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
-  "bin": {
-    "spec-first-copilot": "./bin/cli.js"
-  },
-  "files": [
-    "bin/",
-    "lib/",
-    "templates/"
-  ],
-  "author": "gustavomaritan",
-  "keywords": ["spec-first", "workflow", "ai", "copilot", "github", "scaffolding"],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/gustavomaritan-labs/spec-first-workflow"
-  },
-  "scripts": {
-    "test": "echo \"No tests yet\""
-  },
-  "license": "MIT"
-}
+{
+  "name": "spec-first-copilot",
+  "version": "0.5.0-beta.0",
+  "description": "Spec-first workflow kit for GitHub Copilot — AI-driven development with specs, not guesswork",
+  "bin": {
+    "spec-first-copilot": "bin/cli.js"
+  },
+  "files": [
+    "bin/",
+    "lib/",
+    "templates/"
+  ],
+  "author": "gustavomaritan",
+  "keywords": [
+    "spec-first",
+    "workflow",
+    "ai",
+    "copilot",
+    "github",
+    "scaffolding"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gustavomaritan-labs/spec-first-workflow.git",
+    "directory": "packages/spec-first-copilot"
+  },
+  "scripts": {
+    "test": "echo \"No tests yet\""
+  },
+  "license": "MIT"
+}

package/templates/.ai/memory/napkin.md

@@ -65,4 +65,4 @@
 
 ## Sessão Atual
 
-<!-- Atualizado pelo /pausar ao encerrar cada sessão -->
+<!-- Atualizado pelo /session-finish ao encerrar cada sessão -->

package/templates/.github/agents/db-coder.md

@@ -39,7 +39,7 @@ src/Infrastructure/Data/
     └── DevSeedData.cs        ← Seed para desenvolvimento
 ```
 
-### Convenções SQL (alinhado com Modelo_Dados.md)
+### Convenções SQL (alinhado com domain.md)
 
 | Elemento | Convenção | Exemplo |
 |----------|-----------|---------|

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/Estrutura/ e pelo /merge-delta para atualizá-los.
+> Usado pelo /design (setup) para gerar docs/ e pelo /merge-delta para atualizá-los.
 
 ---
 
@@ -16,21 +16,18 @@
 
 ## Responsabilidades
 
-1. **No setup (via /design passo 3)**: gerar os 8 docs de `docs/Estrutura/` a partir do TRD aprovado
-2. **Em features (via /merge-delta)**: atualizar docs de Estrutura com Delta Specs do SDD §11
+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
 
-## Mapeamento TRD → docs/Estrutura/
+## Mapeamento TRD/SDD → docs/
 
-| TRD Seção | Doc gerado | Template |
-|-----------|-----------|---------|
-| §1 Visão + §8 Módulos | Visao.md | `_templates/estrutura/Visao.template.md` |
-| §2 Stack | Stack.md | `_templates/estrutura/Stack.template.md` |
-| §3 Arquitetura | Arquitetura.md | `_templates/estrutura/Arquitetura.template.md` |
-| §4 Modelo + SDD §3 | Modelo_Dados.md | `_templates/estrutura/Modelo_Dados.template.md` |
-| §5 API | API.md | `_templates/estrutura/API.template.md` |
-| §6 Infra | Infraestrutura.md | `_templates/estrutura/Infraestrutura.template.md` |
-| §7 Segurança | Seguranca.md | `_templates/estrutura/Seguranca.template.md` |
-| SDD §2 Decisões | ADRs.md | `_templates/estrutura/ADRs.template.md` |
+| Doc gerado | Fontes | 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` |
 
 ## Regras
 
@@ -48,4 +45,4 @@
 2. **Ler TRD/SDD** → extrair dados para cada seção
 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 Visao.md a partir do TRD`
+5. **Commitar** → `docs(DOC-001): gerar architecture.md a partir do TRD`

package/templates/.github/agents/security-reviewer.md

@@ -11,7 +11,7 @@
 |-------|-------|
 | Área | Todas (cross-area) |
 | Modelo padrão | Opus |
-| Lê | Código produzido + SDD §5 (endpoints/auth) + SDD §9 (testes) + docs/Estrutura/Seguranca.md |
+| Lê | Código produzido + SDD §5 (endpoints/auth) + SDD §9 (testes) + docs/conventions.md (auth, authz, LGPD, auditoria) |
 | Nunca lê | PRD, PM |
 
 ## Quando é acionado

package/templates/.github/copilot-instructions.md

@@ -12,11 +12,11 @@
 | Dependência | Caminho | Se não existir |
 |-------------|---------|----------------|
 | Napkin (memória) | `.ai/memory/napkin.md` | Criar com formato padrão: seções Decisões, Padrões, Armadilhas, Preferências (máx 10 itens/seção) |
-| Templates | `docs/_templates/` | ERRO — projeto não está configurado |
+| Templates | `.github/templates/` | ERRO — projeto não está configurado |
 | Skills | `.github/skills/` | ERRO — projeto não está configurado |
 | Agents | `.github/agents/` | ERRO — projeto não está configurado |
-| Rules | `docs/Desenvolvimento/rules.md` | ERRO — projeto não está configurado |
-| Retomada | `docs/Desenvolvimento/retomada.md` | OK — primeira sessão |
+| Rules | `.github/rules.md` | ERRO — projeto não está configurado |
+| Retomada | `workspace/Output/retomada.md` | OK — primeira sessão |
 
 ### 2. Validar acesso a todas skills
 
@@ -31,7 +31,7 @@ Verificar que TODAS as 9 skills estão acessíveis:
 | `/sf-plan` | `.github/skills/sf-plan/SKILL.md` |
 | `/sf-dev` | `.github/skills/sf-dev/SKILL.md` |
 | `/sf-merge-delta` | `.github/skills/sf-merge-delta/SKILL.md` |
-| `/sf-pausar` | `.github/skills/sf-pausar/SKILL.md` |
+| `/sf-session-finish` | `.github/skills/sf-session-finish/SKILL.md` |
 | `/sf-discovery` | `.github/skills/sf-discovery/SKILL.md` |
 
 Se alguma skill não for encontrada → avisar o usuário.
@@ -39,9 +39,9 @@ Se alguma skill não for encontrada → avisar o usuário.
 ### 3. Carregar contexto
 
 1. Ler `.ai/memory/napkin.md` — decisões e padrões acumulados
-2. Ler `docs/Desenvolvimento/retomada.md` (se existir) — ponto de retomada da última sessão
-3. Ler `docs/Estrutura/` (se existir) — contexto global do projeto
-4. Ler `docs/Desenvolvimento/rules.md` — regras de desenvolvimento
+2. Ler `workspace/Output/retomada.md` (se existir) — ponto de retomada da última sessão
+3. Ler `docs/` (se existir) — contexto global do projeto (architecture, domain, conventions, apiContracts, decisions)
+4. Ler `.github/rules.md` — regras de desenvolvimento
 
 ---
 
@@ -53,37 +53,41 @@ Este é um projeto que utiliza desenvolvimento **spec-first** assistido por IA.
 
 ```
 ESTE REPO (projeto-base) = ORQUESTRADOR
-├── docs/          ← specs, PRDs, SDDs, tasks (fonte de verdade)
-├── projetos.yaml  ← manifesto de repos
-└── projetos/      ← repos de código (gitignored, cada um com .git próprio)
-    ├── api/       ← repo: org/projeto-api
-    ├── web/       ← repo: org/projeto-web
-    └── worker/    ← repo: org/projeto-worker
+├── .github/        ← AI operational config (rules, templates, skills, agents)
+├── docs/           ← estado do sistema (architecture, domain, conventions, apiContracts, decisions)
+├── workspace/     ← content compartilhável
+│   ├── Input/      ← insumos brutos do time
+│   └── Output/     ← outputs por feature (PRD, TRD, SDD, tasks, progresso)
+├── projetos.yaml   ← manifesto de repos
+└── projetos/       ← repos de código (gitignored, cada um com .git próprio)
+    ├── api/        ← repo: org/projeto-api
+    ├── web/        ← repo: org/projeto-web
+    └── worker/     ← repo: org/projeto-worker
 ```
 
-**Regra clara**:
-- **Specs, docs, tasks, progresso** → ficam NESTE repo (projeto-base)
-- **Código, testes, Dockerfiles, CI** → ficam nos repos em `projetos/`
-- **Commits de código** → nos repos do serviço, NUNCA no projeto-base
-- **Git workflow (branches, PRs, merge)** → se aplica aos repos em `projetos/`
+**Três zonas, zero ambiguidade:**
+- **`.github/` + `.ai/`** → AI operational config (rules, templates, skills, agents, memória) — time edita raro
+- **`docs/`** → estado do sistema (gerado pelo /sf-design e /sf-merge-delta)
+- **`workspace/`** → content compartilhável (Input = time, Output = workflow)
+- **`projetos/`** → código dos serviços (branches, PRs, commits acontecem aí)
+
 Nenhum código é escrito sem especificação aprovada (SDD).
 
 ## Pipeline do Workflow
 
 ```
-docs/PM/ (qualquer arquivo)
+workspace/Input/ (qualquer arquivo)
     ↓ /sf-setup-projeto (uma vez) ou /sf-feature (por feature)
 /sf-discovery → análise profunda dos insumos (RECOMENDADO, opcional)
     ↓
-/sf-extract → PRD ou TRD (checkpoint — usuário revisa e aprova)
+/sf-extract → PRD ou TRD em workspace/Output/{nome}/ (checkpoint — usuário revisa e aprova)
     ↓
-/sf-design → SDD + projetos.yaml + docs/Estrutura/ (setup)
+/sf-design → SDD + projetos.yaml + docs/ (5 docs de sistema — só setup)
     ↓
-/sf-plan → *_tasks.md + Progresso.md (tasks por fase × área)
+/sf-plan → *_tasks.md + Progresso.md em workspace/Output/{nome}/ (tasks por fase × área)
     ↓
 /sf-dev → código nos repos (Security Review pós-dev)
-    ↓
-/sf-merge-delta → docs/Estrutura/ atualizado (apenas para features)
+    → merge-delta automático em features (aplica SDD §11 em docs/)
 ```
 
 ## Skills disponíveis
@@ -92,12 +96,12 @@ docs/PM/ (qualquer arquivo)
 |-------|------|-----------|
 | `/sf-setup-projeto` | Orquestrador | Bootstrap: cria .context.md, chama /sf-extract, para no checkpoint. Roda UMA vez |
 | `/sf-feature <nome>` | Orquestrador | Feature: cria .context.md tipo PRD, chama /sf-extract, para no checkpoint |
-| `/sf-extract <nome>` | Atômica | Lê docs/PM/{nome}/ → gera PRD ou TRD. Re-executável para novos insumos |
+| `/sf-extract <nome>` | Atômica | Lê workspace/Input/{nome}/ → gera PRD ou TRD. Re-executável para novos insumos |
 | `/sf-design <nome>` | Atômica | Pergunta aprovação → gera SDD a partir do PRD/TRD |
 | `/sf-plan <nome>` | Atômica | Lê SDD → gera tasks por área + Progresso.md |
-| `/sf-dev <nome>` | Atômica | Implementa tasks com loop (implement → test → review). Agents por área |
-| `/sf-merge-delta <nome>` | Atômica | Aplica SDD §11 Delta Specs em docs/Estrutura/ |
-| `/sf-pausar` | Utilitária | Encerra sessão: salva estado, atualiza napkin, gera retomada.md |
+| `/sf-dev <nome>` | Atômica | Implementa tasks com loop (implement → test → review). Agents por área. Merge-delta automático em features |
+| `/sf-merge-delta <nome>` | Atômica | Aplica SDD §11 Delta Specs em docs/ (chamado automaticamente pelo /sf-dev, re-executável manualmente) |
+| `/sf-session-finish` | Utilitária | Encerra sessão: salva estado, atualiza napkin, gera retomada.md |
 | `/sf-discovery` | Utilitária | Análise profunda de sistemas, arquiteturas e documentações |
 
 ## Agents especializados (usados pelo /dev)
@@ -114,7 +118,7 @@ docs/PM/ (qualquer arquivo)
 
 ## Estado da pipeline (`.context.md`)
 
-Cada feature/setup tem um `.context.md` em `docs/Desenvolvimento/{nome}/` que controla o fluxo:
+Cada feature/setup tem um `.context.md` em `workspace/Output/{nome}/` que controla o fluxo:
 
 ```
 not_started → extract_done → approved → design_done → plan_done → dev_in_progress → dev_done → done
@@ -125,7 +129,7 @@ Antes de executar qualquer skill, verificar o status no `.context.md`. Cada skil
 ## Regras Invioláveis
 
 1. **Spec-first**: NUNCA gerar código sem SDD aprovado
-2. **PM é sagrado**: NUNCA modificar arquivos em `docs/PM/`
+2. **Input é sagrado**: NUNCA modificar arquivos em `workspace/Input/`
 3. **Extração rígida**: categorias fixas do template, sem texto narrativo, ambiguidades são BLOQUEANTES
 4. **SDD é auto-contido**: coder lê APENAS SDD + task, NUNCA PRD/PM diretamente
 5. **Memória ativa**: ler napkin.md no início, atualizar ao descobrir padrões/armadilhas
@@ -136,15 +140,27 @@ Antes de executar qualquer skill, verificar o status no `.context.md`. Cada skil
 ## Estrutura de Documentação
 
 ```
-docs/
-├── PM/                  ← Insumos brutos (QUALQUER formato — nunca modificar)
-│   ├── setup_projeto/   ← Insumos de bootstrap
-│   └── feat_*/          ← Insumos por feature
-├── _templates/          ← 16 templates (feature/7 + estrutura/8 + global/1)
-├── Estrutura/           ← Retrato global do projeto (gerado por /setup-projeto via tasks DOC)
-└── Desenvolvimento/     ← Artefatos por feature
-    ├── rules.md         ← Regras de desenvolvimento
-    └── {nome}/          ← PRD/TRD, SDD, *_tasks.md, Progresso.md, .context.md, .extract-log.md
+.github/
+├── copilot-instructions.md  ← Regras globais pro agente (este arquivo)
+├── rules.md                 ← Regras de desenvolvimento (lidas pelos coders)
+├── templates/               ← Templates do workflow (feature/estrutura/global)
+├── skills/                  ← 9 skills atômicas
+├── agents/                  ← 7 perfis de agents especializados
+└── instructions/            ← Instruções por contexto
+
+docs/                        ← Estado global do sistema (gerado pelo /sf-design)
+├── architecture.md          ← C4 + stack + ambientes + deploy
+├── domain.md                ← Visão de negócio + modelo de dados
+├── conventions.md           ← Auth, authz, LGPD, env vars, monitoramento
+├── apiContracts.md          ← Rotas, paginação, catálogo de endpoints
+└── decisions.md             ← ADRs
+
+workspace/                  ← Content compartilhável (futuro wiki)
+├── Input/                   ← Insumos brutos (QUALQUER formato — nunca modificar)
+│   ├── setup_projeto/       ← Insumos de bootstrap
+│   └── feat_*/              ← Insumos por feature
+└── Output/                  ← Artefatos gerados pelo workflow
+    └── {nome}/              ← PRD/TRD, SDD, *_tasks.md, Progresso.md, .context.md, .extract-log.md
 ```
 
 ## Convenções
@@ -157,7 +173,7 @@ docs/
 
 ## Quando Parar e Perguntar
 
-- `docs/PM/{nome}/` vazio ou inexistente → PARAR
+- `workspace/Input/{nome}/` vazio ou inexistente → PARAR
 - Ambiguidade na extração → listar como pergunta BLOQUEANTE, PARAR
 - `.context.md` com status incompatível com a skill → PARAR, informar status atual
 - Task com dependência não concluída → avisar, não pular
@@ -168,9 +184,11 @@ docs/
 
 | Doc | Onde |
 |-----|------|
-| Rules de dev | `docs/Desenvolvimento/rules.md` |
+| Rules de dev | `.github/rules.md` |
 | Memória | `.ai/memory/napkin.md` |
 | Skills | `.github/skills/*.md` |
 | Agents | `.github/agents/*.md` |
-| Templates | `docs/_templates/` |
-| Estrutura do sistema | `docs/Estrutura/*.md` (após setup) |
+| Templates | `.github/templates/` |
+| Estado do sistema | `docs/*.md` (após setup) |
+| Insumos brutos | `workspace/Input/` |
+| Outputs do workflow | `workspace/Output/` |

package/templates/.github/instructions/docs.instructions.md

@@ -31,8 +31,8 @@ Cada tipo de projeto tem seu documento de extração:
 
 | Comando | Documento | Template | Foco |
 |---------|----------|---------|------|
-| `/setup-projeto` | TRD.md | `_templates/feature/TRD.template.md` | Stack, arquitetura, infra, modelo base |
-| `/feature` | PRD.md | `_templates/feature/PRD.template.md` | Regras de negócio, jornadas, telas |
+| `/setup-projeto` | TRD.md | `.github/templates/feature/TRD.template.md` | Stack, arquitetura, infra, modelo base |
+| `/feature` | PRD.md | `.github/templates/feature/PRD.template.md` | Regras de negócio, jornadas, telas |
 
 ### Multi-agent no /extract
 
@@ -43,7 +43,7 @@ Cada tipo de projeto tem seu documento de extração:
 
 ### Regras da extração
 
-- Ler TODOS arquivos em `docs/PM/{nome}/` (qualquer formato: .md, .txt, .sql, .html, .xml, .csv, .png, .pdf)
+- Ler TODOS arquivos em `workspace/Input/{nome}/` (qualquer formato: .md, .txt, .sql, .html, .xml, .csv, .png, .pdf)
 - Categorias FIXAS do template — não inventar seções novas
 - Regras de negócio com IDs únicos e estáveis (RN-001, RN-002 — nunca renumerar)
 - Ambiguidades = BLOQUEANTES (workflow para até responder)
@@ -63,8 +63,8 @@ Cada tipo de projeto tem seu documento de extração:
 
 1. Verificar aprovação do PRD/TRD (perguntar ao usuário)
 2. Verificar ambiguidades — todas devem estar respondidas
-3. Ler PRD/TRD + `docs/Estrutura/` + `rules.md`
-4. Gerar SDD usando `_templates/feature/sdd.template.md`
+3. Ler PRD/TRD + `docs/` + `rules.md`
+4. Gerar SDD usando `.github/templates/feature/sdd.template.md`
 5. SDD deve ser **auto-contido** — coder lê APENAS SDD + task, nada mais
 6. Toda regra referencia seção do PRD/TRD (rastreabilidade)
 7. §9 Estratégia de Testes: definir framework, estrutura, CAs mapeados a testes
@@ -73,13 +73,13 @@ Cada tipo de projeto tem seu documento de extração:
 
 ## Planejamento (/plan)
 
-1. Ler SDD completo + `docs/Estrutura/` + `rules.md`
+1. Ler SDD completo + `docs/` + `rules.md`
 2. Áreas são DINÂMICAS — determinadas pelo SDD, não pré-definidas
-3. Para cada área → gerar `{area}_tasks.md` usando `_templates/feature/tasks.template.md`
+3. Para cada área → gerar `{area}_tasks.md` usando `.github/templates/feature/tasks.template.md`
 4. Tasks em fases sequenciais com prioridade P1/P2/P3
 5. Cada task: ID (AREA-NNN), título, tamanho (S/M/L), arquivos, ref SDD §N, depende, testes
 6. Gerar `Progresso.md` com ordem de execução e paralelismos
-7. Em setup: área DOC obrigatória (8 tasks, 1 por doc de Estrutura)
+7. Em setup: área DOC NÃO existe mais — `docs/` é gerado diretamente pelo /sf-design (passo 3) a partir do TRD
 
 ## Desenvolvimento (/dev)
 
@@ -115,9 +115,9 @@ Por feature: E2E tests (CAs) → fix → dev_done
 
 | Aspecto | /setup-projeto | /feature |
 |---------|---------------|----------|
-| Input | `docs/PM/setup_projeto/` | `docs/PM/feat_nome/` |
+| Input | `workspace/Input/setup_projeto/` | `workspace/Input/feat_nome/` |
 | Extração | TRD.md (técnico) | PRD.md (produto) |
-| SDD + Tasks | Sim (infra + DOC tasks) | Sim (feature tasks) |
-| Gera docs/Estrutura/ | Via tasks DOC | Não — atualiza via /merge-delta |
+| SDD + Tasks | Sim (infra + banco + back + front) | Sim (feature tasks) |
+| Gera docs/ | Sim — pelo /sf-design (passo 3) | Não — atualiza via /merge-delta |
 | /merge-delta | Não se aplica | Obrigatório após /dev |
-| Pré-requisito | Nenhum (primeiro comando) | docs/Estrutura/ deve existir |
+| Pré-requisito | Nenhum (primeiro comando) | docs/ deve existir |

package/templates/.github/instructions/sensitive-files.instructions.md

@@ -4,26 +4,26 @@
 
 ## Arquivos que NUNCA devem ser modificados pelo agente
 
-- `docs/PM/**/*` — Insumos brutos do usuário. Somente leitura.
+- `workspace/Input/**/*` — Insumos brutos do usuário. Somente leitura.
 - `.env`, `.env.*` — Variáveis de ambiente com secrets.
-- `docs/Estrutura/ADRs.md` — ADRs aceitas são imutáveis (apenas adicionar novas).
+- `docs/decisions.md` — decisões aceitas são imutáveis (apenas adicionar novas, com status "substituída por ADR-XXX" na original).
 
 ## Arquivos que requerem aprovação antes de modificar
 
-- `docs/Estrutura/*` — Documentação global. Só alterar via /merge-delta após /dev.
-- `docs/Desenvolvimento/rules.md` — Regras de desenvolvimento. Alteração deve ser explícita.
+- `docs/*` — Documentação global. Só alterar via /merge-delta após /dev.
+- `.github/rules.md` — Regras de desenvolvimento. Alteração deve ser explícita.
 - `.github/copilot-instructions.md` — Meta-regras. Alteração requer aprovação.
 - `.github/skills/*` — Skills do workflow. Alteração requer aprovação.
 - `.github/agents/*` — Perfis de agentes. Alteração requer aprovação.
 
 ## Arquivos com formato rígido (gerados por skills)
 
-- `docs/Desenvolvimento/*/.context.md` — YAML frontmatter, apenas skills atualizam.
-- `docs/Desenvolvimento/*/.extract-log.md` — Append-only, hashes obrigatórios.
-- `docs/Desenvolvimento/*/PRD.md` ou `TRD.md` — Seguir template exato.
-- `docs/Desenvolvimento/*/sdd.md` — Seguir template, todas as 11 seções + rastreabilidade.
-- `docs/Desenvolvimento/*/*_tasks.md` — IDs sequenciais, campos obrigatórios.
-- `docs/Desenvolvimento/*/Progresso.md` — Tabelas com formato fixo.
+- `workspace/Output/*/.context.md` — YAML frontmatter, apenas skills atualizam.
+- `workspace/Output/*/.extract-log.md` — Append-only, hashes obrigatórios.
+- `workspace/Output/*/PRD.md` ou `TRD.md` — Seguir template exato.
+- `workspace/Output/*/sdd.md` — Seguir template, todas as 11 seções + rastreabilidade.
+- `workspace/Output/*/*_tasks.md` — IDs sequenciais, campos obrigatórios.
+- `workspace/Output/*/Progresso.md` — Tabelas com formato fixo.
 
 ## Arquivos que nunca devem conter secrets
 

package/templates/{docs/Desenvolvimento → .github}/rules.md

@@ -36,7 +36,7 @@ As regras abaixo são o padrão do framework. O time pode:
 ## Convenções de Código
 
 ### Padrão geral
-- Todo código segue as convenções de `docs/Estrutura/Stack.md`
+- Todo código segue a stack e convenções de `docs/architecture.md` + `docs/conventions.md`
 - Nomes em inglês (código) — documentação em português
 - Sem código morto (comentado) — se não usa, apaga
 - Sem secrets hardcoded — sempre variáveis de ambiente
@@ -44,7 +44,7 @@ As regras abaixo são o padrão do framework. O time pode:
 ### Backend
 - Testes obrigatórios: mínimo happy path + 1 cenário de erro
 - Validação de input na borda (controller/handler) — não no service
-- Erros de negócio: usar códigos definidos em `docs/Estrutura/API.md`
+- Erros de negócio: usar códigos definidos em `docs/conventions.md` (seção Códigos de Erro do Domínio)
 - Tipos explícitos (sem `any`, `object`, `dynamic` genéricos)
 
 ### Frontend