spec-first-copilot 0.6.0-beta.9 → 0.7.0

package/templates/.github/CHANGELOG.md

@@ -8,6 +8,127 @@
 
 ---
 
+## 0.7.0 (2026-04-14) — Redesign v4 estável
+
+Promoção de `0.7.0-beta.1` para versão estável. Inclui fix crítico:
+purga de referências SDD residuais que sobreviveram ao beta (incluindo
+whitelist do `/sf-publish`, que silenciosamente pulava TRD).
+
+### Fix — limpeza de resíduos v3
+
+Varredura de 23 arquivos no projeto:
+- `sfw.config.yml.example`: `publishes: [PRD, SDD, Progresso]` → `[PRD, TRD, Progresso]` (bug runtime)
+- `adapters/registry.md` e `naming.md`: refs a SDD como tipo válido → TRD
+- `rules.md`: regras invioláveis 1-4 reescritas ("SDD aprovado" → "PRD/TRD aprovados + specs/")
+- Templates de `estrutura/` (architecture, domain, conventions, apiContracts, decisions):
+  mapeamento completo SDD §X → TRD §Y nas instruções de ORIGEM/ATUALIZAÇÃO
+- Templates de `feature/` (Progresso, projetos.yaml): refs SDD §3.2 → TRD §1.2, etc.
+- `progresso_global.template.md`: legenda de status reescrita com fluxo v4 completo
+- `docs.instructions.md`: reescrito integralmente para v4
+- `sensitive-files.instructions.md`: `sdd.md` → `TRD.md`
+- `copilot-instructions.md`: refs `sdd.md` → `TRD.md`
+- `.ai/memory/napkin.md` (template): princípios invioláveis atualizados
+- READMEs dos 2 packages: narrativa + estrutura + diagrama v4
+
+Refs legítimas mantidas: CHANGELOGs (histórico), `doc-writer.md` e
+`sf-merge-docs/SKILL.md` (explicam a migração v3→v4).
+
+---
+
+## 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 `/sf-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
+  `/sf-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** — `/sf-discovery` deixou de ser skill opcional e virou
+  passo obrigatório dentro do `/sf-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 `/sf-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
+
+- `/sf-start` — 2 aprovações + discovery obrigatório
+- `/sf-extract` — gera PRD e/ou TRD conforme conteúdo dos insumos (Reader + Produto-Analyzer + Tech-Analyzer)
+- `/sf-design` — consome PRD+TRD aprovados, gera docs/ (first-run) + specs/
+- `/sf-merge-docs` — diff semântico PRD+TRD ↔ docs/ (agente Integrator promovido pra Opus)
+- `/sf-plan` — entrada PRD+TRD+specs/, tasks com `Ref TRD` em vez de `Ref SDD`
+- `/sf-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-copilot@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