spec-first-copilot 0.2.0 → 0.4.0

package/templates/.github/skills/sf-setup-projeto/SKILL.md

@@ -1,123 +1,123 @@
----
-name: sf-setup-projeto
-description: |
-  Bootstrap do projeto. Cria contexto TRD, chama /sf-extract, para no checkpoint.
-  Trigger: /sf-setup-projeto
-author: GustavoMaritan
-version: 1.0.0
-date: 2026-04-08
----
-
-# Skill: /sf-setup-projeto
-
-> Orquestrador de bootstrap do projeto. Executa uma única vez.
-> Cria contexto TRD, chama `/extract` e para no checkpoint de aprovação.
-
-## Tipo
-Orquestrador (primeira etapa do pipeline)
-
-## Uso
-```
-/sf-setup-projeto
-```
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | `docs/PM/setup_projeto/` existe | Parar → "Crie a pasta docs/PM/setup_projeto/ e adicione seus insumos" |
-| 2 | 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)" |
-| 3 | `docs/Estrutura/` está vazio ou contém apenas templates vazios | Parar → "Setup já foi executado. Use /sf-feature para novas funcionalidades" |
-| 4 | `docs/Desenvolvimento/setup_projeto/.context.md` não existe ou status é `not_started` | Parar → "Setup já está em andamento. Verifique o status em .context.md" |
-
-## Passos
-
-### 1. Criar estrutura
-```
-docs/Desenvolvimento/setup_projeto/
-├── .context.md        ← criado agora
-└── (TRD.md será criado pelo /extract)
-```
-
-### 2. Criar `.context.md`
-```yaml
----
-nome: "setup_projeto"
-tipo: "setup"
-documento: "TRD"
-pm_path: "docs/PM/setup_projeto/"
-status: "not_started"
-ultima_skill: "/sf-setup-projeto"
-atualizado_em: "{{ISO_DATETIME}}"
----
-```
-
-### 3. Sugerir /sf-discovery (RECOMENDADO)
-
-Antes de extrair, perguntar ao usuário:
-```
-📋 Insumos encontrados em docs/PM/setup_projeto/.
-
-Recomendo rodar /sf-discovery antes da extração para:
-  - Análise profunda dos insumos (parseia drawio, XML, SQL completo)
-  - Identificar gaps e contradições antes de estruturar
-  - Validar entendimento com você (mapa do sistema)
-
-Quer rodar /sf-discovery docs/PM/setup_projeto/ agora? (s/n)
-  Se SIM → rodar discovery, salvar discovery.md, depois continuar com extract
-  Se NÃO → pular direto para /sf-extract (ok para insumos simples)
-```
-
-Se o usuário aceitar:
-- Rodar `/sf-discovery docs/PM/setup_projeto/`
-- Aguardar conclusão — discovery.md salvo em `docs/Desenvolvimento/setup_projeto/`
-- Continuar para o passo 4
-
-### 4. Chamar `/sf-extract setup_projeto`
-O `/sf-extract` lê os insumos + discovery.md (se existir), gera o TRD e atualiza status para `extract_done`.
-
-### 5. CHECKPOINT — Parar e informar o usuário
-Mensagem ao usuário:
-```
-✅ TRD gerado em docs/Desenvolvimento/setup_projeto/TRD.md
-
-Revise o documento. Quando estiver satisfeito, execute:
-  /sf-design setup_projeto
-
-Se precisar adicionar mais insumos, coloque na pasta docs/PM/setup_projeto/
-e execute:
-  /sf-extract setup_projeto
-```
-
-**O orquestrador encerra aqui.** O restante do pipeline é responsabilidade do usuário chamar as skills atômicas na ordem:
-1. `/sf-design setup_projeto` (pergunta aprovação → gera SDD + docs/Estrutura/ + projetos.yaml)
-2. `/sf-plan setup_projeto` (gera tasks com campo Repo por task)
-3. `/sf-dev setup_projeto` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
-
-## Saídas diretas desta skill
-- `docs/Desenvolvimento/setup_projeto/.context.md`
-- `docs/Desenvolvimento/setup_projeto/TRD.md` (via /extract)
-- `docs/Desenvolvimento/setup_projeto/.extract-log.md` (via /extract)
-
-## Saídas indiretas (skills subsequentes)
-- `sdd.md` (via /design)
-- `projetos.yaml` (via /sf-design — manifesto de repos)
-- `docs/Estrutura/` populado (via /design)
-- `*_tasks.md` + `Progresso.md` (via /plan)
-- `projetos/` com repos criados/clonados (via /sf-dev INFRA-001)
-
-## Erros
-
-| Erro | Ação |
-|------|------|
-| PM/setup_projeto/ não existe | Parar, instruir criação |
-| PM/setup_projeto/ vazio | Parar, listar formatos aceitos |
-| Estrutura/ já populado | Parar, sugerir /sf-feature |
-| Pipeline já iniciado | Parar, mostrar status atual do .context.md |
-
-## Notas
-- Esta skill roda **uma única vez** por projeto
-- docs/Estrutura/ é gerado pelo /sf-design (passo 3), não por tasks DOC
-- `projetos.yaml` é gerado pelo /sf-design (passo 3b) — mapeia serviços para repos
-- Repos são criados/clonados pelo /sf-dev (INFRA-001) dentro de `projetos/`
-- O `/merge-delta` NÃO se aplica ao setup (é criação, não atualização)
+---
+name: sf-setup-projeto
+description: |
+  Bootstrap do projeto. Cria contexto TRD, chama /sf-extract, para no checkpoint.
+  Trigger: /sf-setup-projeto
+author: GustavoMaritan
+version: 1.0.0
+date: 2026-04-08
+---
+
+# Skill: /sf-setup-projeto
+
+> Orquestrador de bootstrap do projeto. Executa uma única vez.
+> Cria contexto TRD, chama `/extract` e para no checkpoint de aprovação.
+
+## Tipo
+Orquestrador (primeira etapa do pipeline)
+
+## Uso
+```
+/sf-setup-projeto
+```
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | `docs/PM/setup_projeto/` existe | Parar → "Crie a pasta docs/PM/setup_projeto/ e adicione seus insumos" |
+| 2 | 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)" |
+| 3 | `docs/Estrutura/` está vazio ou contém apenas templates vazios | Parar → "Setup já foi executado. Use /sf-feature para novas funcionalidades" |
+| 4 | `docs/Desenvolvimento/setup_projeto/.context.md` não existe ou status é `not_started` | Parar → "Setup já está em andamento. Verifique o status em .context.md" |
+
+## Passos
+
+### 1. Criar estrutura
+```
+docs/Desenvolvimento/setup_projeto/
+├── .context.md        ← criado agora
+└── (TRD.md será criado pelo /extract)
+```
+
+### 2. Criar `.context.md`
+```yaml
+---
+nome: "setup_projeto"
+tipo: "setup"
+documento: "TRD"
+pm_path: "docs/PM/setup_projeto/"
+status: "not_started"
+ultima_skill: "/sf-setup-projeto"
+atualizado_em: "{{ISO_DATETIME}}"
+---
+```
+
+### 3. Sugerir /sf-discovery (RECOMENDADO)
+
+Antes de extrair, perguntar ao usuário:
+```
+📋 Insumos encontrados em docs/PM/setup_projeto/.
+
+Recomendo rodar /sf-discovery antes da extração para:
+  - Análise profunda dos insumos (parseia drawio, XML, SQL completo)
+  - Identificar gaps e contradições antes de estruturar
+  - Validar entendimento com você (mapa do sistema)
+
+Quer rodar /sf-discovery docs/PM/setup_projeto/ agora? (s/n)
+  Se SIM → rodar discovery, salvar discovery.md, depois continuar com extract
+  Se NÃO → pular direto para /sf-extract (ok para insumos simples)
+```
+
+Se o usuário aceitar:
+- Rodar `/sf-discovery docs/PM/setup_projeto/`
+- Aguardar conclusão — discovery.md salvo em `docs/Desenvolvimento/setup_projeto/`
+- Continuar para o passo 4
+
+### 4. Chamar `/sf-extract setup_projeto`
+O `/sf-extract` lê os insumos + discovery.md (se existir), gera o TRD e atualiza status para `extract_done`.
+
+### 5. CHECKPOINT — Parar e informar o usuário
+Mensagem ao usuário:
+```
+✅ TRD gerado em docs/Desenvolvimento/setup_projeto/TRD.md
+
+Revise o documento. Quando estiver satisfeito, execute:
+  /sf-design setup_projeto
+
+Se precisar adicionar mais insumos, coloque na pasta docs/PM/setup_projeto/
+e execute:
+  /sf-extract setup_projeto
+```
+
+**O orquestrador encerra aqui.** O restante do pipeline é responsabilidade do usuário chamar as skills atômicas na ordem:
+1. `/sf-design setup_projeto` (pergunta aprovação → gera SDD + docs/Estrutura/ + projetos.yaml)
+2. `/sf-plan setup_projeto` (gera tasks com campo Repo por task)
+3. `/sf-dev setup_projeto` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
+
+## Saídas diretas desta skill
+- `docs/Desenvolvimento/setup_projeto/.context.md`
+- `docs/Desenvolvimento/setup_projeto/TRD.md` (via /extract)
+- `docs/Desenvolvimento/setup_projeto/.extract-log.md` (via /extract)
+
+## Saídas indiretas (skills subsequentes)
+- `sdd.md` (via /design)
+- `projetos.yaml` (via /sf-design — manifesto de repos)
+- `docs/Estrutura/` populado (via /design)
+- `*_tasks.md` + `Progresso.md` (via /plan)
+- `projetos/` com repos criados/clonados (via /sf-dev INFRA-001)
+
+## Erros
+
+| Erro | Ação |
+|------|------|
+| PM/setup_projeto/ não existe | Parar, instruir criação |
+| PM/setup_projeto/ vazio | Parar, listar formatos aceitos |
+| Estrutura/ já populado | Parar, sugerir /sf-feature |
+| Pipeline já iniciado | Parar, mostrar status atual do .context.md |
+
+## Notas
+- Esta skill roda **uma única vez** por projeto
+- docs/Estrutura/ é gerado pelo /sf-design (passo 3), não por tasks DOC
+- `projetos.yaml` é gerado pelo /sf-design (passo 3b) — mapeia serviços para repos
+- Repos são criados/clonados pelo /sf-dev (INFRA-001) dentro de `projetos/`
+- O `/merge-delta` NÃO se aplica ao setup (é criação, não atualização)