spec-first-copilot 0.4.0 → 0.5.0-beta.1

package/templates/.github/instructions/docs.instructions.md

@@ -1,123 +1,123 @@
-# Instruções — Documentação e Specs
-
-> Regras para o agente ao trabalhar com a camada de documentação.
-> Complementa `copilot-instructions.md` com detalhes operacionais.
-
-## Skills e fluxo
-
-O pipeline é executado por skills atômicas, cada uma com seu arquivo em `.github/skills/`:
-
-```
-/setup-projeto → /extract → /design → /plan → /dev → /merge-delta
-```
-
-Cada skill tem pré-condições, passos e saídas documentados. **Sempre ler a skill antes de executar.**
-
-## Estado da pipeline (`.context.md`)
-
-Cada feature/setup tem um `.context.md` (YAML frontmatter) que controla o fluxo:
-
-```
-not_started → extract_done → approved → design_done → plan_done → dev_in_progress → dev_done → done
-```
-
-- **Apenas skills atualizam** `.context.md` — o usuário nunca edita manualmente
-- **Aprovação** acontece no início do `/design` (skill pergunta ao usuário)
-- Antes de executar qualquer skill, verificar status no `.context.md`
-
-## Extração (/extract)
-
-Cada tipo de projeto tem seu documento de extração:
-
-| Comando | Documento | Template | Foco |
-|---------|----------|---------|------|
-| `/setup-projeto` | TRD.md | `_templates/feature/TRD.template.md` | Stack, arquitetura, infra, modelo base |
-| `/feature` | PRD.md | `_templates/feature/PRD.template.md` | Regras de negócio, jornadas, telas |
-
-### Multi-agent no /extract
-
-| Agente | Modelo | Papel |
-|--------|--------|-------|
-| Reader (1 por arquivo) | Sonnet | Lê e cataloga 1 arquivo por vez, em paralelo |
-| Analyzer | Opus | Cruza fontes, detecta gaps/contradições, gera documento final |
-
-### Regras da extração
-
-- Ler TODOS arquivos em `docs/PM/{nome}/` (qualquer formato: .md, .txt, .sql, .html, .xml, .csv, .png, .pdf)
-- Categorias FIXAS do template — não inventar seções novas
-- Regras de negócio com IDs únicos e estáveis (RN-001, RN-002 — nunca renumerar)
-- Ambiguidades = BLOQUEANTES (workflow para até responder)
-- Nunca INFERIR regra de negócio — se não está explícito, é ambiguidade
-- Contradições entre arquivos → ambiguidade citando ambos
-- Rastreabilidade obrigatória: cada informação aponta pro arquivo fonte
-- Arquivo não identificável → registrar como NÃO IDENTIFICADO no extract-log, gerar ambiguidade
-- Gerar `.extract-log.md` com hash SHA-256 (8 chars) por arquivo
-
-### Re-extração
-
-- Compara hashes com `.extract-log.md` existente → NOVO / MODIFICADO / INALTERADO
-- Merge ADITIVO (nunca remove info de arquivos inalterados)
-- Novas regras continuam sequência de IDs (se último era RN-005, próximo é RN-006)
-
-## Design (/design)
-
-1. Verificar aprovação do PRD/TRD (perguntar ao usuário)
-2. Verificar ambiguidades — todas devem estar respondidas
-3. Ler PRD/TRD + `docs/Estrutura/` + `rules.md`
-4. Gerar SDD usando `_templates/feature/sdd.template.md`
-5. SDD deve ser **auto-contido** — coder lê APENAS SDD + task, nada mais
-6. Toda regra referencia seção do PRD/TRD (rastreabilidade)
-7. §9 Estratégia de Testes: definir framework, estrutura, CAs mapeados a testes
-8. §11 Delta Specs: obrigatório (ADDED/MODIFIED/REMOVED)
-9. Seções N/A permitidas em setup (§4-§8 podem ser N/A)
-
-## Planejamento (/plan)
-
-1. Ler SDD completo + `docs/Estrutura/` + `rules.md`
-2. Áreas são DINÂMICAS — determinadas pelo SDD, não pré-definidas
-3. Para cada área → gerar `{area}_tasks.md` usando `_templates/feature/tasks.template.md`
-4. Tasks em fases sequenciais com prioridade P1/P2/P3
-5. Cada task: ID (AREA-NNN), título, tamanho (S/M/L), arquivos, ref SDD §N, depende, testes
-6. Gerar `Progresso.md` com ordem de execução e paralelismos
-7. Em setup: área DOC obrigatória (8 tasks, 1 por doc de Estrutura)
-
-## Desenvolvimento (/dev)
-
-### Agents por área (perfis em `.github/agents/`)
-
-| Área | Agente | Stack padrão |
-|------|--------|-------------|
-| BANCO | DB Coder | PostgreSQL 16 |
-| BACK | Backend Coder | .NET 8 / C# |
-| FRONT | Frontend Coder | React + Fusion |
-| INFRA | Infra Coder | Docker |
-| DOC | Doc Writer | — |
-| Todas | Reviewer | — |
-
-### Loop de desenvolvimento
-
-```
-Por task: implement → test unit → fix → lint → commit → review → fix → review (max 3)
-Por fase: integration tests → fix
-Por feature: E2E tests (CAs) → fix → dev_done
-```
-
-### Regras
-
-- Implement + testes na mesma task (não separar)
-- Agente selecionado pelo prefixo: BACK-* → Backend Coder
-- Modelo por tamanho: S/M → Sonnet, L → Opus
-- 1 commit por task: `tipo(TASK-ID): descrição`
-- Quality gate validado pelo Reviewer após cada task
-- Limite de retry: 3 reprovações → escalar pro usuário
-
-## /setup-projeto vs /feature
-
-| Aspecto | /setup-projeto | /feature |
-|---------|---------------|----------|
-| Input | `docs/PM/setup_projeto/` | `docs/PM/feat_nome/` |
-| Extração | TRD.md (técnico) | PRD.md (produto) |
-| SDD + Tasks | Sim (infra + DOC tasks) | Sim (feature tasks) |
-| Gera docs/Estrutura/ | Via tasks DOC | Não — atualiza via /merge-delta |
-| /merge-delta | Não se aplica | Obrigatório após /dev |
-| Pré-requisito | Nenhum (primeiro comando) | docs/Estrutura/ deve existir |
+# Instruções — Documentação e Specs
+
+> Regras para o agente ao trabalhar com a camada de documentação.
+> Complementa `copilot-instructions.md` com detalhes operacionais.
+
+## Skills e fluxo
+
+O pipeline é executado por skills atômicas, cada uma com seu arquivo em `.github/skills/`:
+
+```
+/setup-projeto → /extract → /design → /plan → /dev → /merge-delta
+```
+
+Cada skill tem pré-condições, passos e saídas documentados. **Sempre ler a skill antes de executar.**
+
+## Estado da pipeline (`.context.md`)
+
+Cada feature/setup tem um `.context.md` (YAML frontmatter) que controla o fluxo:
+
+```
+not_started → extract_done → approved → design_done → plan_done → dev_in_progress → dev_done → done
+```
+
+- **Apenas skills atualizam** `.context.md` — o usuário nunca edita manualmente
+- **Aprovação** acontece no início do `/design` (skill pergunta ao usuário)
+- Antes de executar qualquer skill, verificar status no `.context.md`
+
+## Extração (/extract)
+
+Cada tipo de projeto tem seu documento de extração:
+
+| Comando | Documento | Template | Foco |
+|---------|----------|---------|------|
+| `/setup-projeto` | TRD.md | `.github/templates/feature/TRD.template.md` | Stack, arquitetura, infra, modelo base |
+| `/feature` | PRD.md | `.github/templates/feature/PRD.template.md` | Regras de negócio, jornadas, telas |
+
+### Multi-agent no /extract
+
+| Agente | Modelo | Papel |
+|--------|--------|-------|
+| Reader (1 por arquivo) | Sonnet | Lê e cataloga 1 arquivo por vez, em paralelo |
+| Analyzer | Opus | Cruza fontes, detecta gaps/contradições, gera documento final |
+
+### Regras da extração
+
+- Ler TODOS arquivos em `workspace/Input/{nome}/` (qualquer formato: .md, .txt, .sql, .html, .xml, .csv, .png, .pdf)
+- Categorias FIXAS do template — não inventar seções novas
+- Regras de negócio com IDs únicos e estáveis (RN-001, RN-002 — nunca renumerar)
+- Ambiguidades = BLOQUEANTES (workflow para até responder)
+- Nunca INFERIR regra de negócio — se não está explícito, é ambiguidade
+- Contradições entre arquivos → ambiguidade citando ambos
+- Rastreabilidade obrigatória: cada informação aponta pro arquivo fonte
+- Arquivo não identificável → registrar como NÃO IDENTIFICADO no extract-log, gerar ambiguidade
+- Gerar `.extract-log.md` com hash SHA-256 (8 chars) por arquivo
+
+### Re-extração
+
+- Compara hashes com `.extract-log.md` existente → NOVO / MODIFICADO / INALTERADO
+- Merge ADITIVO (nunca remove info de arquivos inalterados)
+- Novas regras continuam sequência de IDs (se último era RN-005, próximo é RN-006)
+
+## Design (/design)
+
+1. Verificar aprovação do PRD/TRD (perguntar ao usuário)
+2. Verificar ambiguidades — todas devem estar respondidas
+3. Ler PRD/TRD + `docs/` + `rules.md`
+4. Gerar SDD usando `.github/templates/feature/sdd.template.md`
+5. SDD deve ser **auto-contido** — coder lê APENAS SDD + task, nada mais
+6. Toda regra referencia seção do PRD/TRD (rastreabilidade)
+7. §9 Estratégia de Testes: definir framework, estrutura, CAs mapeados a testes
+8. §11 Delta Specs: obrigatório (ADDED/MODIFIED/REMOVED)
+9. Seções N/A permitidas em setup (§4-§8 podem ser N/A)
+
+## Planejamento (/plan)
+
+1. Ler SDD completo + `docs/` + `rules.md`
+2. Áreas são DINÂMICAS — determinadas pelo SDD, não pré-definidas
+3. Para cada área → gerar `docs/specs/{nome}/tasks.md` usando `.github/templates/feature/tasks.template.md`
+4. Tasks em fases sequenciais com prioridade P1/P2/P3
+5. Cada task: ID (AREA-NNN), título, tamanho (S/M/L), arquivos, ref SDD §N, depende, testes
+6. Gerar `Progresso.md` com ordem de execução e paralelismos
+7. Em setup: área DOC NÃO existe mais — `docs/` é gerado diretamente pelo /sf-design (passo 3) a partir do TRD
+
+## Desenvolvimento (/dev)
+
+### Agents por área (perfis em `.github/agents/`)
+
+| Área | Agente | Stack padrão |
+|------|--------|-------------|
+| BANCO | DB Coder | PostgreSQL 16 |
+| BACK | Backend Coder | .NET 8 / C# |
+| FRONT | Frontend Coder | React + Fusion |
+| INFRA | Infra Coder | Docker |
+| DOC | Doc Writer | — |
+| Todas | Reviewer | — |
+
+### Loop de desenvolvimento
+
+```
+Por task: implement → test unit → fix → lint → commit → review → fix → review (max 3)
+Por fase: integration tests → fix
+Por feature: E2E tests (CAs) → fix → dev_done
+```
+
+### Regras
+
+- Implement + testes na mesma task (não separar)
+- Agente selecionado pelo prefixo: BACK-* → Backend Coder
+- Modelo por tamanho: S/M → Sonnet, L → Opus
+- 1 commit por task: `tipo(TASK-ID): descrição`
+- Quality gate validado pelo Reviewer após cada task
+- Limite de retry: 3 reprovações → escalar pro usuário
+
+## /setup-projeto vs /feature
+
+| Aspecto | /setup-projeto | /feature |
+|---------|---------------|----------|
+| Input | `workspace/Input/setup_projeto/` | `workspace/Input/feat_nome/` |
+| Extração | TRD.md (técnico) | PRD.md (produto) |
+| SDD + Tasks | Sim (infra + banco + back + front) | Sim (feature tasks) |
+| Gera docs/ | Sim — pelo /sf-design (passo 3) | Não — atualiza via /merge-delta |
+| /merge-delta | Não se aplica | Obrigatório após /dev |
+| Pré-requisito | Nenhum (primeiro comando) | docs/ deve existir |

package/templates/.github/instructions/sensitive-files.instructions.md

@@ -1,32 +1,32 @@
-# Instruções para Arquivos Sensíveis
-
-> Regras especiais para arquivos que requerem cuidado extra.
-
-## Arquivos que NUNCA devem ser modificados pelo agente
-
-- `docs/PM/**/*` — Insumos brutos do usuário. Somente leitura.
-- `.env`, `.env.*` — Variáveis de ambiente com secrets.
-- `docs/Estrutura/ADRs.md` — ADRs aceitas são imutáveis (apenas adicionar novas).
-
-## Arquivos que requerem aprovação antes de modificar
-
-- `docs/Estrutura/*` — Documentação global. Só alterar via /merge-delta após /dev.
-- `docs/Desenvolvimento/rules.md` — Regras de desenvolvimento. Alteração deve ser explícita.
-- `.github/copilot-instructions.md` — Meta-regras. Alteração requer aprovação.
-- `.github/skills/*` — Skills do workflow. Alteração requer aprovação.
-- `.github/agents/*` — Perfis de agentes. Alteração requer aprovação.
-
-## Arquivos com formato rígido (gerados por skills)
-
-- `docs/Desenvolvimento/*/.context.md` — YAML frontmatter, apenas skills atualizam.
-- `docs/Desenvolvimento/*/.extract-log.md` — Append-only, hashes obrigatórios.
-- `docs/Desenvolvimento/*/PRD.md` ou `TRD.md` — Seguir template exato.
-- `docs/Desenvolvimento/*/sdd.md` — Seguir template, todas as 11 seções + rastreabilidade.
-- `docs/Desenvolvimento/*/*_tasks.md` — IDs sequenciais, campos obrigatórios.
-- `docs/Desenvolvimento/*/Progresso.md` — Tabelas com formato fixo.
-
-## Arquivos que nunca devem conter secrets
-
-- Qualquer arquivo `.md` em docs/
-- `docker-compose.yml` — usar variáveis de ambiente, não valores diretos
-- Código fonte — usar `appsettings.json` + environment variables, não hardcoded
+# Instruções para Arquivos Sensíveis
+
+> Regras especiais para arquivos que requerem cuidado extra.
+
+## Arquivos que NUNCA devem ser modificados pelo agente
+
+- `workspace/Input/**/*` — Insumos brutos do usuário. Somente leitura.
+- `.env`, `.env.*` — Variáveis de ambiente com secrets.
+- `docs/decisions.md` — decisões aceitas são imutáveis (apenas adicionar novas, com status "substituída por ADR-XXX" na original).
+
+## Arquivos que requerem aprovação antes de modificar
+
+- `docs/*` — Documentação global. Só alterar via /merge-delta após /dev.
+- `.github/rules.md` — Regras de desenvolvimento. Alteração deve ser explícita.
+- `.github/copilot-instructions.md` — Meta-regras. Alteração requer aprovação.
+- `.github/skills/*` — Skills do workflow. Alteração requer aprovação.
+- `.github/agents/*` — Perfis de agentes. Alteração requer aprovação.
+
+## Arquivos com formato rígido (gerados por skills)
+
+- `workspace/Output/*/.context.md` — YAML frontmatter, apenas skills atualizam.
+- `workspace/Output/*/.extract-log.md` — Append-only, hashes obrigatórios.
+- `workspace/Output/*/PRD.md` ou `TRD.md` — Seguir template exato.
+- `workspace/Output/*/sdd.md` — Seguir template, todas as 11 seções + rastreabilidade.
+- `workspace/Output/*/docs/specs/{nome}/tasks.md` — IDs sequenciais, campos obrigatórios.
+- `workspace/Output/*/Progresso.md` — Tabelas com formato fixo.
+
+## Arquivos que nunca devem conter secrets
+
+- Qualquer arquivo `.md` em docs/
+- `docker-compose.yml` — usar variáveis de ambiente, não valores diretos
+- Código fonte — usar `appsettings.json` + environment variables, não hardcoded