spec-first-claude 0.2.0 → 0.4.0

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

@@ -1,86 +1,86 @@
-# /plan $ARGUMENTS
-
-Skill atômica de planejamento. Lê SDD e gera tasks por área + Progresso.
-$ARGUMENTS = nome (ex: setup_projeto, feat_cadastro_cliente)
-
-## Agente: Planner (Opus)
-Metódico e exaustivo. Cada task auto-contida. Prioriza ordem correta.
-
-## Pré-condições
-
-| # | Validação | Se falhar |
-|---|-----------|-----------|
-| 1 | $ARGUMENTS informado | Parar |
-| 2 | `.context.md` com status `design_done` | Se anterior → "/design primeiro". Se posterior → "Tasks já geradas" |
-| 3 | `sdd.md` existe | Parar → "/design primeiro" |
-
-## Passos
-
-### 1. Ler contexto
-- SDD completo + `projetos.yaml` + `docs/Estrutura/` + `rules.md`
-- Template `tasks.template.md` + `Progresso.template.md`
-
-### 2. Identificar fases de entrega
-Ler PRD §11 (Fases de Entrega) — cada fase vira um agrupamento de tasks:
-- Fases são sequenciais: Fase 2 depende de Fase 1 concluída
-- Cada fase tem entregável e critério de done
-- O `/dev` pode rodar por fase: `/dev feat_nome --fase 1`
-
-### 3. Identificar áreas (por fase)
-
-| Seção SDD | Área |
-|-----------|------|
-| §3 Modelo de dados | BANCO |
-| §5 Endpoints API | BACK |
-| §6 Componentes/Telas | FRONT |
-| §8 Integrações | INFRA |
-| Outras | MOBILE, DEVOPS, etc. conforme SDD |
-
-> **Nota**: Área DOC NÃO existe mais no setup. docs/Estrutura/ é gerado pelo /design (passo 3).
-> DOC só aparece em features se houver necessidade explícita de documentação adicional.
-
-Áreas são DINÂMICAS — só criar as que o SDD exige.
-
-**Área INFRA obrigatória no setup:**
-Sempre gerar estas tasks no setup (antes de qualquer código):
-```
-- [ ] INFRA-001: Validar e configurar ambiente local [M]
-  (detectar OS, instalar Docker/.NET/Node, verificar portas)
-- [ ] INFRA-002: Criar docker-compose.yml + Dockerfiles [M]
-- [ ] INFRA-003: Hello world — subir stack completa e validar [M]
-  (docker compose up, migrations, health check, frontend carrega)
-```
-INFRA-001 é a PRIMEIRA task executada no /dev do setup (antes de BANCO, BACK, FRONT).
-INFRA-003 é a ÚLTIMA task (após tudo, como validação final).
-Setup só é `done` quando INFRA-003 passa.
-
-### 4. Gerar tasks por fase × área
-Para cada área → `{area}_tasks.md`, agrupadas por fase de entrega:
-```markdown
-- [ ] **AREA-NNN**: Título [Tamanho]
-  - Fase: {{N}} — {{Nome da fase de entrega}}
-  - Repo: `{{repo_name}}` (de projetos.yaml)
-  - Arquivos: `caminho/arquivo.ext` (relativo à raiz do repo)
-  - Testes: `caminho/teste.ext`
-  - SDD: §N.N — Referência específica
-  - Depende: AREA-NNN (ou —)
-```
-
-Regras:
-- **Repo obrigatório** — consultar `projetos.yaml` para mapear área → repo. Caminhos relativos ao repo
-- Tamanhos: S (<30min), M (30min-2h), L (2h+). L → avaliar se quebra em M+S
-- IDs sequenciais por área, nunca reutilizar
-- Dependências cross-area permitidas
-- Fases sequenciais: P1 (bloqueia), P2 (importante), P3 (nice-to-have)
-- Cada task inclui campo Testes (arquivo de teste correspondente)
-
-### 5. Gerar Progresso.md (por fase de entrega)
-- Resumo Área × Fase com contagem
-- Ordem de execução com paralelismos
-- Checklist pós-conclusão
-
-### 6. Atualizar progresso global + `.context.md`
-```yaml
-status: "plan_done"
-ultima_skill: "/plan"
-```
+# /plan $ARGUMENTS
+
+Skill atômica de planejamento. Lê SDD e gera tasks por área + Progresso.
+$ARGUMENTS = nome (ex: setup_projeto, feat_cadastro_cliente)
+
+## Agente: Planner (Opus)
+Metódico e exaustivo. Cada task auto-contida. Prioriza ordem correta.
+
+## Pré-condições
+
+| # | Validação | Se falhar |
+|---|-----------|-----------|
+| 1 | $ARGUMENTS informado | Parar |
+| 2 | `.context.md` com status `design_done` | Se anterior → "/design primeiro". Se posterior → "Tasks já geradas" |
+| 3 | `sdd.md` existe | Parar → "/design primeiro" |
+
+## Passos
+
+### 1. Ler contexto
+- SDD completo + `projetos.yaml` + `docs/Estrutura/` + `rules.md`
+- Template `tasks.template.md` + `Progresso.template.md`
+
+### 2. Identificar fases de entrega
+Ler PRD §11 (Fases de Entrega) — cada fase vira um agrupamento de tasks:
+- Fases são sequenciais: Fase 2 depende de Fase 1 concluída
+- Cada fase tem entregável e critério de done
+- O `/dev` pode rodar por fase: `/dev feat_nome --fase 1`
+
+### 3. Identificar áreas (por fase)
+
+| Seção SDD | Área |
+|-----------|------|
+| §3 Modelo de dados | BANCO |
+| §5 Endpoints API | BACK |
+| §6 Componentes/Telas | FRONT |
+| §8 Integrações | INFRA |
+| Outras | MOBILE, DEVOPS, etc. conforme SDD |
+
+> **Nota**: Área DOC NÃO existe mais no setup. docs/Estrutura/ é gerado pelo /design (passo 3).
+> DOC só aparece em features se houver necessidade explícita de documentação adicional.
+
+Áreas são DINÂMICAS — só criar as que o SDD exige.
+
+**Área INFRA obrigatória no setup:**
+Sempre gerar estas tasks no setup (antes de qualquer código):
+```
+- [ ] INFRA-001: Validar e configurar ambiente local [M]
+  (detectar OS, instalar Docker/.NET/Node, verificar portas)
+- [ ] INFRA-002: Criar docker-compose.yml + Dockerfiles [M]
+- [ ] INFRA-003: Hello world — subir stack completa e validar [M]
+  (docker compose up, migrations, health check, frontend carrega)
+```
+INFRA-001 é a PRIMEIRA task executada no /dev do setup (antes de BANCO, BACK, FRONT).
+INFRA-003 é a ÚLTIMA task (após tudo, como validação final).
+Setup só é `done` quando INFRA-003 passa.
+
+### 4. Gerar tasks por fase × área
+Para cada área → `{area}_tasks.md`, agrupadas por fase de entrega:
+```markdown
+- [ ] **AREA-NNN**: Título [Tamanho]
+  - Fase: {{N}} — {{Nome da fase de entrega}}
+  - Repo: `{{repo_name}}` (de projetos.yaml)
+  - Arquivos: `caminho/arquivo.ext` (relativo à raiz do repo)
+  - Testes: `caminho/teste.ext`
+  - SDD: §N.N — Referência específica
+  - Depende: AREA-NNN (ou —)
+```
+
+Regras:
+- **Repo obrigatório** — consultar `projetos.yaml` para mapear área → repo. Caminhos relativos ao repo
+- Tamanhos: S (<30min), M (30min-2h), L (2h+). L → avaliar se quebra em M+S
+- IDs sequenciais por área, nunca reutilizar
+- Dependências cross-area permitidas
+- Fases sequenciais: P1 (bloqueia), P2 (importante), P3 (nice-to-have)
+- Cada task inclui campo Testes (arquivo de teste correspondente)
+
+### 5. Gerar Progresso.md (por fase de entrega)
+- Resumo Área × Fase com contagem
+- Ordem de execução com paralelismos
+- Checklist pós-conclusão
+
+### 6. Atualizar progresso global + `.context.md`
+```yaml
+status: "plan_done"
+ultima_skill: "/plan"
+```

package/templates/.claude/commands/{pausar.md → session-finish.md}

@@ -1,83 +1,83 @@
-# /pausar
-
-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 `docs/Desenvolvimento/*/`:
-- 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 `docs/Desenvolvimento/retomada.md`:
-
-```markdown
-# Ponto de Retomada — {{DATA}}
-
-> Gerado pelo /pausar. 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 /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
-  - `docs/Desenvolvimento/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 /pausar (ponto atual, não histórico)
+# /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 `docs/Desenvolvimento/*/`:
+- 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 `docs/Desenvolvimento/retomada.md`:
+
+```markdown
+# Ponto de Retomada — {{DATA}}
+
+> Gerado pelo /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 /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
+  - `docs/Desenvolvimento/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 /session-finish (ponto atual, não histórico)

package/templates/.claude/commands/setup-projeto.md

@@ -1,68 +1,68 @@
-# /setup-projeto
-
-Orquestrador de bootstrap do projeto. Executa uma única vez.
-Cria contexto TRD, chama /extract e para no checkpoint de aprovação.
-
-## Execução
-
-Siga EXATAMENTE os passos da skill em ordem. Leia o arquivo completo antes de agir.
-
-### Pré-condições — validar TODAS antes de prosseguir
-
-| # | 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 .gitkeep | Parar → "Setup já foi executado. Use /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 `docs/Desenvolvimento/setup_projeto/` se não existir
-
-2. Criar `.context.md`:
-```yaml
----
-nome: "setup_projeto"
-tipo: "setup"
-documento: "TRD"
-pm_path: "docs/PM/setup_projeto/"
-status: "not_started"
-ultima_skill: "/setup-projeto"
-atualizado_em: "{{ISO_DATETIME}}"
----
-```
-
-3. Sugerir /sf-discovery (RECOMENDADO):
-```
-📋 Recomendo rodar /sf-discovery antes da extração para análise profunda dos insumos.
-Quer rodar /sf-discovery docs/PM/setup_projeto/ agora? (s/n)
-```
-Se SIM → rodar discovery, salvar discovery.md em docs/Desenvolvimento/setup_projeto/
-Se NÃO → pular direto para extract
-
-4. Executar /extract setup_projeto (seguir o command /extract)
-
-5. CHECKPOINT — Parar e informar:
-```
-✅ TRD gerado em docs/Desenvolvimento/setup_projeto/TRD.md
-
-Revise o documento. Quando estiver satisfeito, execute:
-  /design setup_projeto
-
-Se precisar adicionar mais insumos, coloque na pasta docs/PM/setup_projeto/
-e execute:
-  /extract setup_projeto
-```
-
-**O orquestrador encerra aqui.** Próximos passos do usuário:
-1. `/design setup_projeto` (pergunta aprovação → gera SDD + docs/Estrutura/ + projetos.yaml)
-2. `/plan setup_projeto` (gera tasks com campo Repo por task)
-3. `/dev setup_projeto` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
-
-### Notas
-- Esta skill roda UMA ÚNICA VEZ por projeto
-- docs/Estrutura/ é gerado pelo /design (passo 3), não por tasks DOC
-- `projetos.yaml` é gerado pelo /design (passo 3b) — mapeia serviços para repos
-- Repos são criados/clonados pelo /dev (INFRA-001) dentro de `projetos/`
-- /merge-delta NÃO se aplica ao setup (é criação, não atualização)
+# /setup-projeto
+
+Orquestrador de bootstrap do projeto. Executa uma única vez.
+Cria contexto TRD, chama /extract e para no checkpoint de aprovação.
+
+## Execução
+
+Siga EXATAMENTE os passos da skill em ordem. Leia o arquivo completo antes de agir.
+
+### Pré-condições — validar TODAS antes de prosseguir
+
+| # | 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 .gitkeep | Parar → "Setup já foi executado. Use /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 `docs/Desenvolvimento/setup_projeto/` se não existir
+
+2. Criar `.context.md`:
+```yaml
+---
+nome: "setup_projeto"
+tipo: "setup"
+documento: "TRD"
+pm_path: "docs/PM/setup_projeto/"
+status: "not_started"
+ultima_skill: "/setup-projeto"
+atualizado_em: "{{ISO_DATETIME}}"
+---
+```
+
+3. Sugerir /sf-discovery (RECOMENDADO):
+```
+📋 Recomendo rodar /sf-discovery antes da extração para análise profunda dos insumos.
+Quer rodar /sf-discovery docs/PM/setup_projeto/ agora? (s/n)
+```
+Se SIM → rodar discovery, salvar discovery.md em docs/Desenvolvimento/setup_projeto/
+Se NÃO → pular direto para extract
+
+4. Executar /extract setup_projeto (seguir o command /extract)
+
+5. CHECKPOINT — Parar e informar:
+```
+✅ TRD gerado em docs/Desenvolvimento/setup_projeto/TRD.md
+
+Revise o documento. Quando estiver satisfeito, execute:
+  /design setup_projeto
+
+Se precisar adicionar mais insumos, coloque na pasta docs/PM/setup_projeto/
+e execute:
+  /extract setup_projeto
+```
+
+**O orquestrador encerra aqui.** Próximos passos do usuário:
+1. `/design setup_projeto` (pergunta aprovação → gera SDD + docs/Estrutura/ + projetos.yaml)
+2. `/plan setup_projeto` (gera tasks com campo Repo por task)
+3. `/dev setup_projeto` (INFRA-001 cria/clona repos em projetos/, executa tasks nos repos corretos)
+
+### Notas
+- Esta skill roda UMA ÚNICA VEZ por projeto
+- docs/Estrutura/ é gerado pelo /design (passo 3), não por tasks DOC
+- `projetos.yaml` é gerado pelo /design (passo 3b) — mapeia serviços para repos
+- Repos são criados/clonados pelo /dev (INFRA-001) dentro de `projetos/`
+- /merge-delta NÃO se aplica ao setup (é criação, não atualização)

package/templates/.claude/settings.local.json

@@ -1,6 +1,6 @@
-{
-  "enabledMcpjsonServers": [
-    "supabase"
-  ],
-  "enableAllProjectMcpServers": true
-}
+{
+  "enabledMcpjsonServers": [
+    "supabase"
+  ],
+  "enableAllProjectMcpServers": true
+}