spec-first-copilot 0.3.0 → 0.4.0

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

@@ -1,130 +1,130 @@
----
-name: sf-feature
-description: |
-  Pipeline de feature. Cria contexto PRD, chama /sf-extract, para no checkpoint.
-  Trigger: /sf-feature
-author: GustavoMaritan
-version: 1.0.0
-date: 2026-04-08
----
-
-# Skill: /sf-feature
-
-> Orquestrador de feature. Cria contexto PRD, chama `/extract` e para no checkpoint de aprovação.
-
-## Tipo
-Orquestrador (primeira etapa do pipeline de feature)
-
-## Uso
-```
-/sf-feature <nome>
-```
-Exemplo: `/sf-feature feat_cadastro_cliente`
-
-### Convenção de nomes
-- Features: `feat_nome_descritivo`
-- Bugs: `bug_nome_descritivo`
-- Tasks técnicas: `task_nome_descritivo`
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | Argumento `nome` foi informado | Parar → "Informe o nome da feature. Ex: /sf-feature feat_cadastro_cliente" |
-| 2 | `docs/PM/{nome}/` existe | Parar → "Crie a pasta docs/PM/{nome}/ e adicione seus insumos" |
-| 3 | Pasta contém pelo menos 1 arquivo (ignorar .gitkeep) | Parar → "Adicione insumos na pasta (aceitos: .md, .txt, .sql, .xml, .html, .json, .csv, .png, .jpg, .pdf — qualquer formato)" |
-| 4 | `docs/Estrutura/` está populado (setup já executado) | Parar → "Execute /sf-setup-projeto antes de criar features" |
-| 5 | `.context.md` não existe ou status é `not_started` | Se existe com status avançado → "Feature já em andamento (status: {status}). Para re-extrair, use /sf-extract {nome}" |
-
-## Passos
-
-### 1. Carregar contexto do projeto
-Ler `docs/Estrutura/` para entender a arquitetura, stack, modelo de dados e convenções existentes. Esse contexto será passado ao `/extract`.
-
-### 2. Criar estrutura
-```
-docs/Desenvolvimento/{nome}/
-├── .context.md        ← criado agora
-└── (PRD.md será criado pelo /extract)
-```
-
-### 3. Criar `.context.md`
-```yaml
----
-nome: "{nome}"
-tipo: "feature"
-documento: "PRD"
-pm_path: "docs/PM/{nome}/"
-status: "not_started"
-ultima_skill: "/sf-feature"
-atualizado_em: "{{ISO_DATETIME}}"
----
-```
-
-### 4. Sugerir /sf-discovery (RECOMENDADO)
-
-Antes de extrair, perguntar ao usuário:
-```
-📋 Insumos encontrados em docs/PM/{nome}/.
-
-Recomendo rodar /sf-discovery antes da extração para:
-  - Análise profunda dos insumos
-  - Identificar gaps e contradições
-  - Validar entendimento com você
-
-Quer rodar /sf-discovery docs/PM/{nome}/ agora? (s/n)
-  Se SIM → rodar discovery, salvar discovery.md, depois continuar com extract
-  Se NÃO → pular direto para /sf-extract
-```
-
-Se o usuário aceitar:
-- Rodar `/sf-discovery docs/PM/{nome}/`
-- Aguardar conclusão — discovery.md salvo em `docs/Desenvolvimento/{nome}/`
-- Continuar para o passo 5
-
-### 5. Chamar `/sf-extract {nome}`
-O `/sf-extract` lê os insumos + discovery.md (se existir), gera o PRD e atualiza status para `extract_done`.
-
-### 6. CHECKPOINT — Parar e informar o usuário
-Mensagem ao usuário:
-```
-✅ PRD gerado em docs/Desenvolvimento/{nome}/PRD.md
-
-Revise o documento. Quando estiver satisfeito, execute:
-  /sf-design {nome}
-
-Se precisar adicionar mais insumos, coloque na pasta docs/PM/{nome}/
-e execute:
-  /sf-extract {nome}
-```
-
-**O orquestrador encerra aqui.** O restante do pipeline é responsabilidade do usuário chamar as skills atômicas na ordem:
-1. `/sf-design {nome}` (pergunta aprovação → gera SDD)
-2. `/sf-plan {nome}` (gera tasks + Progresso)
-3. `/sf-dev {nome}` (executa tasks)
-4. `/sf-merge-delta {nome}` (aplica Delta Specs em docs/Estrutura/)
-
-## Saídas diretas desta skill
-- `docs/Desenvolvimento/{nome}/.context.md`
-- `docs/Desenvolvimento/{nome}/PRD.md` (via /extract)
-- `docs/Desenvolvimento/{nome}/.extract-log.md` (via /extract)
-
-## Saídas indiretas (skills subsequentes)
-- `sdd.md` (via /design)
-- `*_tasks.md` + `Progresso.md` (via /plan)
-- `docs/Estrutura/` atualizado (via /sf-merge-delta após /dev)
-
-## Erros
-
-| Erro | Ação |
-|------|------|
-| Nome não informado | Parar, mostrar exemplo de uso |
-| PM/{nome}/ não existe | Parar, instruir criação |
-| PM/{nome}/ vazio | Parar, listar formatos aceitos |
-| Estrutura/ não populado | Parar, sugerir /sf-setup-projeto |
-| Pipeline já iniciado | Mostrar status atual, sugerir /sf-extract para re-extração ou skill correspondente ao status |
-
-## Notas
-- Diferente do `/sf-setup-projeto`, pode ser executado **múltiplas vezes** (uma por feature)
-- O contexto de `docs/Estrutura/` é carregado para que o `/extract` gere um PRD coerente com a arquitetura existente
-- Após `/dev`, o `/merge-delta` atualiza `docs/Estrutura/` com as mudanças da feature
+---
+name: sf-feature
+description: |
+  Pipeline de feature. Cria contexto PRD, chama /sf-extract, para no checkpoint.
+  Trigger: /sf-feature
+author: GustavoMaritan
+version: 1.0.0
+date: 2026-04-08
+---
+
+# Skill: /sf-feature
+
+> Orquestrador de feature. Cria contexto PRD, chama `/extract` e para no checkpoint de aprovação.
+
+## Tipo
+Orquestrador (primeira etapa do pipeline de feature)
+
+## Uso
+```
+/sf-feature <nome>
+```
+Exemplo: `/sf-feature feat_cadastro_cliente`
+
+### Convenção de nomes
+- Features: `feat_nome_descritivo`
+- Bugs: `bug_nome_descritivo`
+- Tasks técnicas: `task_nome_descritivo`
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | Argumento `nome` foi informado | Parar → "Informe o nome da feature. Ex: /sf-feature feat_cadastro_cliente" |
+| 2 | `docs/PM/{nome}/` existe | Parar → "Crie a pasta docs/PM/{nome}/ e adicione seus insumos" |
+| 3 | Pasta contém pelo menos 1 arquivo (ignorar .gitkeep) | Parar → "Adicione insumos na pasta (aceitos: .md, .txt, .sql, .xml, .html, .json, .csv, .png, .jpg, .pdf — qualquer formato)" |
+| 4 | `docs/Estrutura/` está populado (setup já executado) | Parar → "Execute /sf-setup-projeto antes de criar features" |
+| 5 | `.context.md` não existe ou status é `not_started` | Se existe com status avançado → "Feature já em andamento (status: {status}). Para re-extrair, use /sf-extract {nome}" |
+
+## Passos
+
+### 1. Carregar contexto do projeto
+Ler `docs/Estrutura/` para entender a arquitetura, stack, modelo de dados e convenções existentes. Esse contexto será passado ao `/extract`.
+
+### 2. Criar estrutura
+```
+docs/Desenvolvimento/{nome}/
+├── .context.md        ← criado agora
+└── (PRD.md será criado pelo /extract)
+```
+
+### 3. Criar `.context.md`
+```yaml
+---
+nome: "{nome}"
+tipo: "feature"
+documento: "PRD"
+pm_path: "docs/PM/{nome}/"
+status: "not_started"
+ultima_skill: "/sf-feature"
+atualizado_em: "{{ISO_DATETIME}}"
+---
+```
+
+### 4. Sugerir /sf-discovery (RECOMENDADO)
+
+Antes de extrair, perguntar ao usuário:
+```
+📋 Insumos encontrados em docs/PM/{nome}/.
+
+Recomendo rodar /sf-discovery antes da extração para:
+  - Análise profunda dos insumos
+  - Identificar gaps e contradições
+  - Validar entendimento com você
+
+Quer rodar /sf-discovery docs/PM/{nome}/ agora? (s/n)
+  Se SIM → rodar discovery, salvar discovery.md, depois continuar com extract
+  Se NÃO → pular direto para /sf-extract
+```
+
+Se o usuário aceitar:
+- Rodar `/sf-discovery docs/PM/{nome}/`
+- Aguardar conclusão — discovery.md salvo em `docs/Desenvolvimento/{nome}/`
+- Continuar para o passo 5
+
+### 5. Chamar `/sf-extract {nome}`
+O `/sf-extract` lê os insumos + discovery.md (se existir), gera o PRD e atualiza status para `extract_done`.
+
+### 6. CHECKPOINT — Parar e informar o usuário
+Mensagem ao usuário:
+```
+✅ PRD gerado em docs/Desenvolvimento/{nome}/PRD.md
+
+Revise o documento. Quando estiver satisfeito, execute:
+  /sf-design {nome}
+
+Se precisar adicionar mais insumos, coloque na pasta docs/PM/{nome}/
+e execute:
+  /sf-extract {nome}
+```
+
+**O orquestrador encerra aqui.** O restante do pipeline é responsabilidade do usuário chamar as skills atômicas na ordem:
+1. `/sf-design {nome}` (pergunta aprovação → gera SDD)
+2. `/sf-plan {nome}` (gera tasks + Progresso)
+3. `/sf-dev {nome}` (executa tasks)
+4. `/sf-merge-delta {nome}` (aplica Delta Specs em docs/Estrutura/)
+
+## Saídas diretas desta skill
+- `docs/Desenvolvimento/{nome}/.context.md`
+- `docs/Desenvolvimento/{nome}/PRD.md` (via /extract)
+- `docs/Desenvolvimento/{nome}/.extract-log.md` (via /extract)
+
+## Saídas indiretas (skills subsequentes)
+- `sdd.md` (via /design)
+- `*_tasks.md` + `Progresso.md` (via /plan)
+- `docs/Estrutura/` atualizado (via /sf-merge-delta após /dev)
+
+## Erros
+
+| Erro | Ação |
+|------|------|
+| Nome não informado | Parar, mostrar exemplo de uso |
+| PM/{nome}/ não existe | Parar, instruir criação |
+| PM/{nome}/ vazio | Parar, listar formatos aceitos |
+| Estrutura/ não populado | Parar, sugerir /sf-setup-projeto |
+| Pipeline já iniciado | Mostrar status atual, sugerir /sf-extract para re-extração ou skill correspondente ao status |
+
+## Notas
+- Diferente do `/sf-setup-projeto`, pode ser executado **múltiplas vezes** (uma por feature)
+- O contexto de `docs/Estrutura/` é carregado para que o `/extract` gere um PRD coerente com a arquitetura existente
+- Após `/dev`, o `/merge-delta` atualiza `docs/Estrutura/` com as mudanças da feature

package/templates/.github/skills/sf-merge-delta/SKILL.md

@@ -1,142 +1,142 @@
----
-name: sf-merge-delta
-description: |
-  Delta Specs. Aplica mudanças do SDD em docs/Estrutura/.
-  Trigger: /sf-merge-delta
-author: GustavoMaritan
-version: 1.0.0
-date: 2026-04-08
----
-
-# Skill: /sf-merge-delta
-
-> Skill atômica pós-dev. Aplica Delta Specs do SDD em docs/Estrutura/.
-> Última etapa do pipeline de feature — não se aplica a setup.
-
-## Tipo
-Atômica — Single-agent
-
-## Uso
-```
-/sf-merge-delta <nome>
-```
-Exemplo: `/sf-merge-delta feat_cadastro_cliente`
-
----
-
-## Agente
-
-| Campo | Valor |
-|-------|-------|
-| **Papel** | Integrador de documentação — aplica mudanças incrementais mantendo consistência global |
-| **Modelo** | Sonnet |
-| **Comportamento** | Meticuloso com consistência. Aplica apenas o que o Delta Specs diz — não infere mudanças adicionais. Cada alteração gera entrada no changelog. Se há conflito com conteúdo existente, para e pede resolução. |
-
----
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | Argumento `nome` foi informado | Parar → "Informe o nome. Ex: /sf-merge-delta feat_cadastro_cliente" |
-| 2 | `.context.md` existe com status `dev_done` | Se anterior → "Execute /sf-dev {nome} primeiro" |
-| 3 | `.context.md` tipo é `feature` (não `setup`) | Parar → "Setup não usa merge-delta — docs/Estrutura/ foi criado diretamente pelo /sf-dev" |
-| 4 | `sdd.md` existe com §11 Delta Specs preenchida | Parar → "Delta Specs não encontrada no SDD" |
-| 5 | `docs/Estrutura/` está populado | Parar → "docs/Estrutura/ vazio — execute /sf-setup-projeto primeiro" |
-
-## Passos
-
-### 1. Ler Delta Specs
-Ler `sdd.md` §11 e classificar cada delta:
-
-| Tipo | Significado | Exemplo |
-|------|------------|---------|
-| **ADDED** | Elemento novo no sistema | Nova tabela `clientes`, novo endpoint POST /api/v1/clientes |
-| **MODIFIED** | Elemento existente alterado | Tabela `usuarios` recebe coluna `telefone` |
-| **REMOVED** | Elemento removido do sistema | Endpoint DELETE /api/v1/legacy removido |
-
-### 2. Mapear deltas para docs alvo
-Cada delta afeta um ou mais docs em `docs/Estrutura/`:
-
-| Elemento | Doc alvo |
-|----------|----------|
-| Tabelas, colunas, índices | `Modelo_Dados.md` |
-| Endpoints, contratos | `API.md` |
-| Decisões de arquitetura | `Arquitetura.md` + `ADRs.md` |
-| Mudanças de infra | `Infraestrutura.md` |
-| Mudanças de segurança | `Seguranca.md` |
-| Mudanças de stack | `Stack.md` |
-| Mudanças de visão/escopo | `Visao.md` |
-
-### 3. Aplicar cada delta
-Para cada delta, no doc alvo:
-
-**ADDED:**
-- Adicionar novo conteúdo na seção apropriada do doc
-- Registrar no changelog
-
-**MODIFIED:**
-- Localizar elemento existente no doc
-- Aplicar a modificação
-- Registrar no changelog
-
-**REMOVED:**
-- Localizar elemento existente no doc
-- Remover ou marcar como deprecated (conforme contexto)
-- Registrar no changelog
-
-**Formato do changelog** (no final de cada doc afetado):
-```markdown
-## Changelog
-
-| Data | Feature | Tipo | Descrição |
-|------|---------|------|-----------|
-| 2026-04-08 | feat_cadastro_cliente | ADDED | Tabela `clientes`, tabela `clientes_enderecos` |
-| 2026-04-08 | feat_cadastro_cliente | ADDED | POST/GET /api/v1/clientes |
-```
-
-### 4. Validar consistência
-Após todas alterações:
-- Verificar que docs não ficaram com referências quebradas
-- Verificar que REMOVED não deixou referências órfãs em outros docs
-- Se inconsistência detectada → reportar ao usuário, não corrigir automaticamente
-
-### 5. Atualizar status
-- `.context.md` → status: `done`
-- `docs/Desenvolvimento/progresso.md` → feature marcada como concluída
-- Informar ao usuário:
-  ```
-  ✅ Delta Specs aplicadas em docs/Estrutura/
-  
-  Docs atualizados:
-  - Modelo_Dados.md — ADDED: tabelas clientes, clientes_enderecos
-  - API.md — ADDED: endpoints POST/GET /api/v1/clientes
-  
-  Feature {nome} concluída.
-  ```
-
----
-
-## Saídas
-
-| Arquivo | Descrição |
-|---------|-----------|
-| `docs/Estrutura/*.md` | Docs globais atualizados com deltas da feature |
-| `progresso.md` (global) | Feature marcada como concluída |
-| `.context.md` | Status: `done` |
-
-## Pós-condições
-- `docs/Estrutura/` reflete o estado real do sistema
-- Cada mudança rastreável: changelog → feature → SDD → PRD → insumo
-- Feature completamente concluída
-
-## Erros
-
-| Erro | Ação |
-|------|------|
-| Nome não informado | Parar, mostrar exemplo |
-| Status não é dev_done | Parar, sugerir /sf-dev |
-| Tipo é setup | Parar, informar que setup não usa merge-delta |
-| Delta Specs vazia | Informar (legítimo em refactors internos), marcar como done |
-| Elemento MODIFIED/REMOVED não encontrado no doc alvo | Parar, reportar conflito — pedir resolução manual |
-| Inconsistência entre docs após merge | Parar, listar inconsistências |
+---
+name: sf-merge-delta
+description: |
+  Delta Specs. Aplica mudanças do SDD em docs/Estrutura/.
+  Trigger: /sf-merge-delta
+author: GustavoMaritan
+version: 1.0.0
+date: 2026-04-08
+---
+
+# Skill: /sf-merge-delta
+
+> Skill atômica pós-dev. Aplica Delta Specs do SDD em docs/Estrutura/.
+> Última etapa do pipeline de feature — não se aplica a setup.
+
+## Tipo
+Atômica — Single-agent
+
+## Uso
+```
+/sf-merge-delta <nome>
+```
+Exemplo: `/sf-merge-delta feat_cadastro_cliente`
+
+---
+
+## Agente
+
+| Campo | Valor |
+|-------|-------|
+| **Papel** | Integrador de documentação — aplica mudanças incrementais mantendo consistência global |
+| **Modelo** | Sonnet |
+| **Comportamento** | Meticuloso com consistência. Aplica apenas o que o Delta Specs diz — não infere mudanças adicionais. Cada alteração gera entrada no changelog. Se há conflito com conteúdo existente, para e pede resolução. |
+
+---
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | Argumento `nome` foi informado | Parar → "Informe o nome. Ex: /sf-merge-delta feat_cadastro_cliente" |
+| 2 | `.context.md` existe com status `dev_done` | Se anterior → "Execute /sf-dev {nome} primeiro" |
+| 3 | `.context.md` tipo é `feature` (não `setup`) | Parar → "Setup não usa merge-delta — docs/Estrutura/ foi criado diretamente pelo /sf-dev" |
+| 4 | `sdd.md` existe com §11 Delta Specs preenchida | Parar → "Delta Specs não encontrada no SDD" |
+| 5 | `docs/Estrutura/` está populado | Parar → "docs/Estrutura/ vazio — execute /sf-setup-projeto primeiro" |
+
+## Passos
+
+### 1. Ler Delta Specs
+Ler `sdd.md` §11 e classificar cada delta:
+
+| Tipo | Significado | Exemplo |
+|------|------------|---------|
+| **ADDED** | Elemento novo no sistema | Nova tabela `clientes`, novo endpoint POST /api/v1/clientes |
+| **MODIFIED** | Elemento existente alterado | Tabela `usuarios` recebe coluna `telefone` |
+| **REMOVED** | Elemento removido do sistema | Endpoint DELETE /api/v1/legacy removido |
+
+### 2. Mapear deltas para docs alvo
+Cada delta afeta um ou mais docs em `docs/Estrutura/`:
+
+| Elemento | Doc alvo |
+|----------|----------|
+| Tabelas, colunas, índices | `Modelo_Dados.md` |
+| Endpoints, contratos | `API.md` |
+| Decisões de arquitetura | `Arquitetura.md` + `ADRs.md` |
+| Mudanças de infra | `Infraestrutura.md` |
+| Mudanças de segurança | `Seguranca.md` |
+| Mudanças de stack | `Stack.md` |
+| Mudanças de visão/escopo | `Visao.md` |
+
+### 3. Aplicar cada delta
+Para cada delta, no doc alvo:
+
+**ADDED:**
+- Adicionar novo conteúdo na seção apropriada do doc
+- Registrar no changelog
+
+**MODIFIED:**
+- Localizar elemento existente no doc
+- Aplicar a modificação
+- Registrar no changelog
+
+**REMOVED:**
+- Localizar elemento existente no doc
+- Remover ou marcar como deprecated (conforme contexto)
+- Registrar no changelog
+
+**Formato do changelog** (no final de cada doc afetado):
+```markdown
+## Changelog
+
+| Data | Feature | Tipo | Descrição |
+|------|---------|------|-----------|
+| 2026-04-08 | feat_cadastro_cliente | ADDED | Tabela `clientes`, tabela `clientes_enderecos` |
+| 2026-04-08 | feat_cadastro_cliente | ADDED | POST/GET /api/v1/clientes |
+```
+
+### 4. Validar consistência
+Após todas alterações:
+- Verificar que docs não ficaram com referências quebradas
+- Verificar que REMOVED não deixou referências órfãs em outros docs
+- Se inconsistência detectada → reportar ao usuário, não corrigir automaticamente
+
+### 5. Atualizar status
+- `.context.md` → status: `done`
+- `docs/Desenvolvimento/progresso.md` → feature marcada como concluída
+- Informar ao usuário:
+  ```
+  ✅ Delta Specs aplicadas em docs/Estrutura/
+  
+  Docs atualizados:
+  - Modelo_Dados.md — ADDED: tabelas clientes, clientes_enderecos
+  - API.md — ADDED: endpoints POST/GET /api/v1/clientes
+  
+  Feature {nome} concluída.
+  ```
+
+---
+
+## Saídas
+
+| Arquivo | Descrição |
+|---------|-----------|
+| `docs/Estrutura/*.md` | Docs globais atualizados com deltas da feature |
+| `progresso.md` (global) | Feature marcada como concluída |
+| `.context.md` | Status: `done` |
+
+## Pós-condições
+- `docs/Estrutura/` reflete o estado real do sistema
+- Cada mudança rastreável: changelog → feature → SDD → PRD → insumo
+- Feature completamente concluída
+
+## Erros
+
+| Erro | Ação |
+|------|------|
+| Nome não informado | Parar, mostrar exemplo |
+| Status não é dev_done | Parar, sugerir /sf-dev |
+| Tipo é setup | Parar, informar que setup não usa merge-delta |
+| Delta Specs vazia | Informar (legítimo em refactors internos), marcar como done |
+| Elemento MODIFIED/REMOVED não encontrado no doc alvo | Parar, reportar conflito — pedir resolução manual |
+| Inconsistência entre docs após merge | Parar, listar inconsistências |