spec-first-claude 0.5.0-beta.18 → 0.5.0-beta.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "spec-first-claude",
-  "version": "0.5.0-beta.18",
+  "version": "0.5.0-beta.19",
   "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/commands/design.md

@@ -121,3 +121,12 @@ status: "design_done"
 ultima_skill: "/design"
 atualizado_em: "{{ISO_DATETIME}}"
 ```
+
+### 9. Publicar SDD no(s) backend(s)
+
+Se existe `sfw.config.yml` com `output.targets[]` ativo:
+- Executar `/publish $ARGUMENTS SDD`
+- O `/publish` respeita o `mode` (auto/manual/off) de cada target
+- Se não existe `sfw.config.yml` → pular silenciosamente
+
+Ver `.claude/commands/publish.md`.

package/templates/.claude/commands/extract.md

@@ -122,6 +122,15 @@ ultima_skill: "/extract"
 atualizado_em: "{{ISO_DATETIME}}"
 ```
 
+### 7. Publicar artefato no(s) backend(s)
+
+Se existe `sfw.config.yml` com `output.targets[]` ativo:
+- Executar `/publish $ARGUMENTS TRD` (setup) ou `/publish $ARGUMENTS PRD` (feature)
+- O `/publish` respeita o `mode` (auto/manual/off) de cada target
+- Se não existe `sfw.config.yml` → pular silenciosamente (projeto 100% local)
+
+Ver `.claude/commands/publish.md`.
+
 ## Re-extração
 - Merge ADITIVO com documento existente (nunca remove info de inalterados)
 - Seções afetadas marcadas com `<!-- ATUALIZADO: re-extração -->`

package/templates/.claude/commands/plan.md

@@ -88,6 +88,16 @@ status: "plan_done"
 ultima_skill: "/plan"
 ```
 
+### 7. Publicar Progresso no(s) backend(s)
+
+Se existe `sfw.config.yml` com `output.targets[]` ativo:
+- Executar `/publish $ARGUMENTS Progresso`
+- O `/publish` respeita o `mode` (auto/manual/off) de cada target
+- Se não existe `sfw.config.yml` → pular silenciosamente
+- **Nota**: `tasks.md`, `specs/`, `docs/`, `projetos.yaml` são LOCAL ONLY — nunca publicados
+
+Ver `.claude/commands/publish.md`.
+
 ## Saídas
 - `specs/{nome}/tasks.md` — tabela única
 - `workspace/Output/{nome}/Progresso.md` — tracking

package/templates/.claude/commands/publish.md

@@ -0,0 +1,144 @@
+# /publish <nome> <tipo>
+
+Publica um artefato gerado localmente no(s) backend(s) configurado(s) como `output.targets[]` no `sfw.config.yml`.
+
+## Argumentos
+
+- `<nome>` = scope do artefato (ex: `app_barbearia`, `feat_login`)
+- `<tipo>` = tipo do artefato: `PRD` | `TRD` | `SDD` | `Progresso`
+
+## Quando é chamado
+
+Automaticamente pelos commands:
+- `/extract` → publica `TRD` ou `PRD` no fim
+- `/design` → publica `SDD` no fim
+- `/plan` → publica `Progresso` no fim
+
+Manualmente: quando o usuário quer re-publicar um artefato após editar local.
+
+## Modo (`mode` no sfw.config.yml)
+
+| Mode | Comportamento |
+|------|---------------|
+| `auto` | Publica sem perguntar (default) |
+| `manual` | Gera artefato local, pergunta "Publicar no {target.name}? (s/n)" |
+| `off` | Ignora o target completamente |
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | `sfw.config.yml` existe | Parar → "Sem sfw.config.yml, publish desabilitado. Artefato local está em workspace/Output/{nome}/{tipo}.md" |
+| 2 | Tipo está na `publishes` do target | Pular target, informar |
+| 3 | Arquivo local existe em `workspace/Output/{nome}/{tipo}.md` (ou .lower) | Parar → "Arquivo não encontrado" |
+
+## Execução
+
+### 1. Carregar configuração
+
+- Ler `sfw.config.yml`
+- Para cada target em `output.targets[]`:
+  - Verificar `mode` (se `off` → pular)
+  - Verificar `publishes` inclui `<tipo>` (se não → pular)
+  - Se `mode: manual` → perguntar ao usuário
+
+### 2. Ler artefato local
+
+Ler `workspace/Output/{nome}/{arquivo}` onde arquivo depende do tipo:
+- `TRD` → `TRD.md`
+- `PRD` → `PRD.md`
+- `SDD` → `sdd.md`
+- `Progresso` → `Progresso.md`
+
+### 3. Aplicar naming
+
+Usar templates do `naming` no `sfw.config.yml`:
+- `containerTitle = applyNaming(naming.output_container, {scope: nome})`
+  - Ex: `"out_app_barbearia"`
+- `artifactTitle = applyNaming(naming.output_artifact, {scope: nome, type: tipo})`
+  - Ex: `"app_barbearia - TRD"`
+
+### 4. Para cada target ativo — publicar
+
+**Confluence**:
+
+1. Listar filhos de `target.config.parent_page_id` (Output)
+2. Buscar container pelo `containerTitle`:
+   - **Não existe** → `mcp__atlassian__confluence_create_page` como filho de Output
+   - **Existe** → pegar `container.id`
+3. Listar filhos do container
+4. Buscar artefato pelo `artifactTitle`:
+   - **Não existe** → `mcp__atlassian__confluence_create_page` com `content=markdown local`
+   - **Existe** → precisa atualizar (próximo passo)
+
+### 5. Conflict detection (update)
+
+Se artefato existe no backend:
+
+1. Ler `.ai/publish-log.md` pra pegar a última `version` publicada desse artefato
+2. Chamar `mcp__atlassian__confluence_get_page(page_id=artifact.id)` → pega `currentVersion`
+3. **Se `currentVersion != lastPublishedVersion`** → DRIFT detectado
+   - Alguém editou no Confluence depois do último publish
+   - Mostrar ao usuário:
+     ```
+     CONFLITO: "{artifactTitle}" foi editada no Confluence desde o último publish.
+
+     Última version publicada por nós: {last}
+     Version atual no Confluence: {current}
+
+     Opções:
+       1. Sobrescrever (perde edição manual)
+       2. Abortar (edita local depois)
+       3. Ver diff
+     ```
+   - Esperar decisão
+4. Se sem drift → `mcp__atlassian__confluence_update_page(page_id, content)`
+5. Ler nova `version` retornada
+
+### 6. Registrar em `.ai/publish-log.md`
+
+Formato append-only:
+
+```markdown
+## Publish: {nome} {tipo} — {ISO_DATETIME}
+
+| Target | Container | Artifact ID | Version | Status |
+|--------|-----------|-------------|---------|--------|
+| confluence-mirror | out_app_barbearia (393220) | 393238 | 3 | UPDATED |
+```
+
+Status: `CREATED`, `UPDATED`, `SKIPPED` (se INALTERADO), `CONFLICT` (se drift não resolvido)
+
+### 7. Informar o usuário
+
+```
+Publicado: {nome} {tipo}
+
+  confluence-mirror: app_barbearia - TRD (v3) — UPDATED
+
+Link: https://empresa.atlassian.net/wiki/spaces/ST/pages/393238
+```
+
+## Erros
+
+| Erro | Ação |
+|------|------|
+| `sfw.config.yml` não existe | Skippa todos os targets, só salva local |
+| Target MCP não disponível | Avisar, pular target |
+| Sem permissão de escrita | Avisar, pular target |
+| Conflict não resolvido | Não publicar, salvar como CONFLICT no log |
+| Container Output não existe | Criar automaticamente como filho de `output.parent_page_id` |
+
+## Notas
+
+- O `/publish` é **idempotente** pra content sem mudanças — detecta hash igual e marca `SKIPPED`
+- `naming.output_container` e `naming.output_artifact` são aplicados em TODOS os targets
+- Cada target pode ter `publishes: []` diferente (permite segmentar: Confluence recebe 4 artefatos, filesystem recebe todos)
+- `.ai/publish-log.md` é essencial pro conflict detection funcionar
+- Nunca publica tasks.md, docs/, specs/, projetos.yaml — esses são LOCAL ONLY
+
+## Referências
+
+- Adapter interface: `.claude/adapters/interface.md`
+- Confluence adapter: `.claude/adapters/confluence.md`
+- Naming engine: `.claude/adapters/naming.md`

package/templates/CLAUDE.md

@@ -20,12 +20,13 @@
 
 ### 2. Validar acesso a todos commands
 
-Verificar que TODOS os 11 commands estão acessíveis:
+Verificar que TODOS os 12 commands estão acessíveis:
 
 | Command | Caminho |
 |---------|---------|
 | `/mcp` | `.claude/commands/mcp.md` |
 | `/load` | `.claude/commands/load.md` |
+| `/publish` | `.claude/commands/publish.md` |
 | `/new-project` | `.claude/commands/new-project.md` |
 | `/feature` | `.claude/commands/feature.md` |
 | `/discovery` | `.claude/commands/discovery.md` |
@@ -97,7 +98,8 @@ ESTE REPO (projeto-base) = ORQUESTRADOR
 | Command | Tipo | O que faz |
 |---------|------|-----------|
 | `/mcp <provider>` | Setup | Configura backend externo interativamente. Cria .mcp.json + sfw.config.yml + ajusta .gitignore |
-| `/load <nome>` | Utilitária | Puxa insumos do backend (Confluence/filesystem) para workspace/Input/{nome}/. Incremental |
+| `/load <nome> \| --all` | Utilitária | Puxa Input + Output do backend. Incremental |
+| `/publish <nome> <tipo>` | Utilitária | Publica artefato (PRD/TRD/SDD/Progresso) nos output.targets[]. Chamado auto por extract/design/plan |
 | `/new-project <nome>` | Orquestrador | Bootstrap técnico: cria .context.md tipo TRD, chama /extract, para no checkpoint |
 | `/feature <nome>` | Orquestrador | Feature: cria .context.md tipo PRD, chama /extract, para no checkpoint |
 | `/discovery <path>` | Utilitária | Análise profunda dos insumos (RECOMENDADO antes do /extract) |