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

package/templates/.github/skills/sf-publish/SKILL.md

@@ -1,143 +1,144 @@
-# /sf-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` | `SDD` | `Progresso`
-
-## Quando é chamado
-
-Automaticamente pelos commands:
-- `/sf-extract` → publica `PRD` no fim
-- `/sf-design` → publica `SDD` no fim
-- `/sf-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:
-- `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 - PRD"`
-
-### 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/sf-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/sf-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 - PRD (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 `/sf-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/sf-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: `.github/adapters/interface.md`
-- Confluence adapter: `.github/adapters/confluence.md`
-- Naming engine: `.github/adapters/naming.md`
+
+# /sf-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` | `Progresso`
+
+## Quando é chamado
+
+Automaticamente pelos commands:
+- `/sf-extract` → publica `PRD` (se `prd_existe=true`) E `TRD` (se `trd_existe=true`)
+- `/sf-plan` → publica `Progresso` no fim
+- `/sf-design` → **não publica** (gera apenas artefatos locais: docs/, specs/, projetos.yaml)
+
+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:
+- `PRD` → `PRD.md`
+- `TRD` → `TRD.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 - PRD"`
+
+### 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 - PRD (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 `/sf-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: `.github/adapters/interface.md`
+- Confluence adapter: `.github/adapters/confluence.md`
+- Naming engine: `.github/adapters/naming.md`

package/templates/.github/skills/sf-session-finish/SKILL.md

@@ -1,120 +1,93 @@
----
-name: sf-session-finish
-description: |
-  Encerrar sessão. Salva estado, atualiza napkin, gera retomada.md.
-  Trigger: /sf-session-finish
-author: GustavoMaritan
-version: 1.0.0
-date: 2026-04-08
----
-
-# Skill: /sf-session-finish
-
-> Encerra a sessão de trabalho de forma organizada.
-> Consolida estado, atualiza memória, gera ponto de retomada para a próxima sessão.
-
-## Tipo
-Utilitária — roda a qualquer momento
-
-## Uso
-```
-/sf-session-finish
-```
-
----
-
-## Passos
-
-### 1. Levantar estado atual de cada feature/setup
-
-Para cada `.context.md` em `workspace/Output/*/`:
-- Ler status atual
-- Ler Progresso.md (se existir) → % concluído, fase atual
-- Identificar tasks em andamento (`- [ ]` com dependências resolvidas)
-
-### 2. Verificar working tree dos repos
-
-Para cada repo em `projetos/`:
-```bash
-cd projetos/{repo}
-git status --short
-git log --oneline -3
-```
-- Listar mudanças não commitadas
-- Listar branches ativas
-- Se há working tree sujo → avisar (sugerir commit antes de pausar)
-
-### 3. Atualizar `.ai/memory/napkin.md`
-
-Adicionar/atualizar seção `## Sessão Atual` com:
-- Data da sessão
-- O que foi feito (tasks concluídas, fases entregues)
-- O que estava em andamento (task atual, bloqueios)
-- Decisões tomadas durante a sessão
-- Armadilhas encontradas (se houver novos aprendizados)
-
-### 4. Gerar resumo de retomada
-
-Criar/atualizar `workspace/Output/retomada.md`:
-
-```markdown
-# Ponto de Retomada — {{DATA}}
-
-> Gerado pelo /sf-session-finish. Leia este arquivo ao iniciar a próxima sessão.
-
-## Estado geral
-
-| Feature/Setup | Status | Fase atual | % | Próxima ação |
-|---------------|--------|------------|---|-------------|
-| {{nome}} | {{status}} | Fase {{N}} | {{%}} | {{ação}} |
-
-## Repos — estado do git
-
-| Repo | Branch ativa | Working tree | Último commit |
-|------|-------------|-------------|---------------|
-| {{repo}} | {{branch}} | limpo/sujo | {{commit msg}} |
-
-## O que estava em andamento
-
-- Task: {{AREA-NNN}} — {{descrição}}
-- Bloqueios: {{se houver}}
-- Decisões pendentes: {{se houver}}
-
-## Para retomar
-
-1. {{Passo 1 — ex: "Subir infra: docker compose up -d"}}
-2. {{Passo 2 — ex: "Continuar /sf-dev feat_mvp --fase 2"}}
-3. {{Passo 3 — ex: "Resolver ambiguidade X do PRD"}}
-
-## Aprendizados desta sessão
-
-- {{Decisão ou armadilha que vale registrar}}
-```
-
-### 5. Informar ao usuário
-
-```
-✅ Sessão encerrada. Estado salvo em:
-  - `.ai/memory/napkin.md` — memória atualizada
-  - `workspace/Output/retomada.md` — ponto de retomada
-
-Para retomar na próxima sessão:
-  1. Ler retomada.md
-  2. Seguir os passos listados em "Para retomar"
-```
-
----
-
-## Saídas
-
-| Arquivo | Descrição |
-|---------|-----------|
-| `.ai/memory/napkin.md` | Sessão atual atualizada |
-| `workspace/Output/retomada.md` | Ponto de retomada com estado completo |
-
-## Notas
-
-- Não modifica .context.md (o status da pipeline não muda ao pausar)
-- Não faz commit automático — se tem working tree sujo, avisa mas não força
-- Pode ser chamada a qualquer momento, não só no final do dia
-- O arquivo `retomada.md` é sobrescrito a cada /sf-session-finish (é ponto atual, não histórico)
+---
+name: sf-session-finish
+description: |
+  Encerrar sessão. Salva estado, atualiza napkin, gera retomada.md.
+  Trigger: /sf-session-finish
+author: GustavoMaritan
+version: 1.0.0
+date: 2026-04-08
+---
+
+# /sf-session-finish
+
+Encerra a sessão de trabalho de forma organizada.
+Consolida estado, atualiza memória, gera ponto de retomada para a próxima sessão.
+
+## Passos
+
+### 1. Levantar estado atual
+
+Para cada `.context.md` em `workspace/Output/*/`:
+- Status atual + Progresso.md (% concluído, fase atual)
+- Tasks em andamento
+
+### 2. Verificar working tree dos repos
+
+Para cada repo em `projetos/`:
+```bash
+cd projetos/{repo}
+git status --short
+git log --oneline -3
+```
+- Se working tree sujo → avisar (sugerir commit antes de pausar)
+
+### 3. Atualizar `.ai/memory/napkin.md`
+
+Atualizar seção `## Sessão Atual` com:
+- Data, o que foi feito, o que estava em andamento
+- Decisões tomadas, armadilhas encontradas
+
+### 4. Gerar resumo de retomada
+
+Criar/atualizar `workspace/Output/retomada.md`:
+
+```markdown
+# Ponto de Retomada — {{DATA}}
+
+> Gerado pelo /sf-session-finish. Leia este arquivo ao iniciar a próxima sessão.
+
+## Estado geral
+
+| Feature/Setup | Status | Fase atual | % | Próxima ação |
+|---------------|--------|------------|---|-------------|
+| {{nome}} | {{status}} | Fase {{N}} | {{%}} | {{ação}} |
+
+## Repos — estado do git
+
+| Repo | Branch ativa | Working tree | Último commit |
+|------|-------------|-------------|---------------|
+| {{repo}} | {{branch}} | limpo/sujo | {{commit msg}} |
+
+## O que estava em andamento
+
+- Task: {{AREA-NNN}} — {{descrição}}
+- Bloqueios: {{se houver}}
+- Decisões pendentes: {{se houver}}
+
+## Para retomar
+
+1. {{Passo 1 — ex: "Subir infra: docker compose up -d"}}
+2. {{Passo 2 — ex: "Continuar /sf-dev feat_mvp --fase 2"}}
+3. {{Passo 3 — ex: "Resolver ambiguidade X do PRD"}}
+
+## Aprendizados desta sessão
+
+- {{Decisão ou armadilha que vale registrar}}
+```
+
+### 5. Informar ao usuário
+
+```
+✅ Sessão encerrada. Estado salvo em:
+  - `.ai/memory/napkin.md` — memória atualizada
+  - `workspace/Output/retomada.md` — ponto de retomada
+
+Para retomar:
+  1. Ler retomada.md
+  2. Seguir os passos listados
+```
+
+## Notas
+- Não modifica .context.md (status da pipeline não muda)
+- Não faz commit automático — avisa se working tree sujo
+- `retomada.md` é sobrescrito a cada /sf-session-finish (ponto atual, não histórico)