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

package/templates/{docs/_templates → .github/templates}/feature/PRD.template.md

@@ -1,256 +1,256 @@
-# PRD — {{FEATURE}}
-## Product Requirements Document
-
-> **Artefato gerado pela IA** a partir do processamento de todos os insumos em `docs/PM/{{FEATURE}}/`.
-> Este é o checkpoint de extração — o usuário DEVE revisar e aprovar antes de prosseguir.
-> Todos os documentos subsequentes (SDD, tasks) são gerados a partir DESTE arquivo.
-
----
-
-## Meta
-
-| Campo | Valor |
-|-------|-------|
-| Feature | `{{FEATURE}}` |
-| Status | `em extração` → `aguardando revisão` → `aprovado` |
-| Insumos processados | {{LISTA_INSUMOS}} |
-| Gerado em | |
-| Aprovado em | |
-
----
-
-<!--
-=============================================================================
-INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
-=============================================================================
-
-QUANDO USAR: Gerado pelo /extract (chamado via /feature).
-QUEM GERA: Agent Analyzer (Opus) a partir dos outputs dos Readers (Sonnet).
-
-COMO GERAR:
-1. Readers (Sonnet) leem cada arquivo do PM/ individualmente e catalogam por seção
-2. Analyzer (Opus) recebe todos os outputs e:
-   a. Consolida em visão unificada
-   b. Cruza informações entre fontes — detecta contradições
-   c. Identifica gaps — seções sem informação viram ambiguidades
-   d. Gera este documento seguindo as 14 seções fixas
-3. Ler `docs/Estrutura/` para contexto de arquitetura existente
-4. Para cada informação, registrar DE QUAL insumo veio (rastreabilidade §14)
-5. Se faltam dados para preencher uma seção → pergunta BLOQUEANTE em §13
-
-FORMATOS DE INSUMO (o que extrair de cada):
-- .txt, .md → requisitos, regras, contexto, restrições
-- .sql → entidades, campos, tipos, constraints, índices, relações
-- .html → telas, campos (data-field), ações (data-action),
-  validações (data-validation), rotas (data-route),
-  permissões (data-permission), estados (data-state)
-- .xml (drawio) → fluxos, decisões, atores, sequências
-- .csv → dados tabulares, mapeamentos
-- .png, .jpg, .pdf → wireframes, mockups (análise visual)
-- Outros → extrair o que for relevante — nunca ignorar
-
-REGRAS DA EXTRAÇÃO:
-- Categorias FIXAS (as 15 seções abaixo) — não inventar novas
-- §11 Fases de Entrega é OBRIGATÓRIO — organizar funcionalidades em fases incrementais
-  Se existe backlog_extraido.md, usar como referência para as fases
-  Princípio: entregáveis contínuos, cada fase entrega valor e pode ir pra produção
-- Regras de negócio com IDs únicos e ESTÁVEIS (RN-001, RN-002...)
-  → IDs nunca renumeram após criação. Em re-extração, novos continuam sequência
-- Ambiguidades como perguntas diretas — BLOQUEANTES
-- SEM texto narrativo — apenas informação estruturada em tabelas e listas
-- Rastreabilidade: de qual arquivo veio cada informação
-- Nunca INFERIR regra de negócio — se não está explícito, é ambiguidade
-- Contradição entre fontes → gerar ambiguidade citando os dois arquivos
-
-RE-EXTRAÇÃO:
-- Merge ADITIVO com PRD existente (não sobrescrever)
-- Seções afetadas marcadas com <!-- ATUALIZADO: re-extração ISO_DATE -->
-- IDs de regras continuam sequência existente
-
-=============================================================================
--->
-
-## 1. Contexto e Motivação
-
-### Qual problema resolve?
-<!-- POR QUÊ essa feature existe — extraído dos insumos -->
-
-### Como funciona hoje?
-<!-- Estado ATUAL — o que existe, como é feito, quais os problemas -->
-
-### Estado desejado
-<!-- O que muda com essa feature — o delta é o escopo real -->
-
----
-
-## 2. Atores e Permissões
-
-| Ator | O que pode fazer | O que NÃO pode fazer |
-|------|------------------|----------------------|
-|      |                  |                      |
-
----
-
-## 3. Entidades e Modelo de Dados
-
-> Extraído de: arquivos `.sql`, protótipos, texto livre.
-
-| Entidade | Campos principais | Tipo dos campos | Relações |
-|----------|-------------------|-----------------|----------|
-|          |                   |                 |          |
-
-### Índices e constraints identificados
--
-
-### Histórico / Auditoria
--
-
----
-
-## 4. Jornadas do Usuário
-
-> Extraído de: protótipos HTML, textos, fluxos.
-
-### Jornada 1: {{NOME}}
-| Passo | Ator | Ação | Resultado esperado |
-|-------|------|------|--------------------|
-| 1     |      |      |                    |
-
----
-
-## 5. Regras de Negócio
-
-> Extraídas de TODOS os insumos. Cada regra deve ser clara, testável e ter ID único.
-
-| ID | Regra | Fonte | Testável? |
-|----|-------|-------|-----------|
-| RN-001 | | {{arquivo_fonte}} | Sim/Não |
-
----
-
-## 6. Validações
-
-> Extraídas de: protótipos (`data-validation`), `.sql` (constraints), texto.
-
-| Campo | Validações | Obrigatório? | Máscara | Fonte |
-|-------|-----------|--------------|---------|-------|
-|       |           |              |         |       |
-
----
-
-## 7. Telas e Componentes UI
-
-> Extraídos de: protótipos HTML (`data-field`, `data-action`, `data-route`, `data-state`).
-
-### Tela 1: {{NOME}}
-- **Rota**: 
-- **Campos**: (extraídos dos `data-field`)
-- **Ações**: (extraídas dos `data-action`)
-- **Navegação**: (extraída dos `data-route`)
-- **Estados**: (extraídos dos `data-state`)
-- **Permissões por elemento**: (extraídos dos `data-permission`)
-
----
-
-## 8. Integrações Externas
-
-| Serviço | Método | Quando é chamado | O que envia | O que recebe | Fallback |
-|---------|--------|------------------|-------------|--------------|----------|
-|         |        |                  |             |              |          |
-
----
-
-## 9. Cenários de Erro
-
-| # | Cenário | Causa | Comportamento esperado | Fonte |
-|---|---------|-------|----------------------|-------|
-| 1 |         |       |                      |       |
-
----
-
-## 10. Requisitos Não-Funcionais
-
-| Aspecto | Requisito | Fonte |
-|---------|-----------|-------|
-| Volume esperado | | |
-| Performance | | |
-| Disponibilidade | | |
-| Acessibilidade | | |
-
----
-
-## 11. Fases de Entrega
-
-> Princípio: **entregáveis contínuos** — cada fase entrega valor e pode ir pra produção.
-> Fases são sequenciais por dependência. Cada uma tem entregável testável.
-> Se o `/extract` foi precedido por um roadmap (backlog_extraido.md), usar as fases como base.
-
-### Fase 1 — {{Nome}} [P1]
-
-> **Entregável**: {{O que o usuário pode usar ao final}}
-> **Critério de done**: {{Como validar — testes E2E que devem passar}}
-
-| # | Funcionalidade | Entidades | Regras | Jornadas |
-|---|---------------|-----------|--------|----------|
-| 1 | | | RN-NNN | Jornada N |
-
-### Fase 2 — {{Nome}} [P1]
-
-> **Entregável**: {{...}}
-> **Critério de done**: {{...}}
-> **Depende de**: Fase 1
-
-| # | Funcionalidade | Entidades | Regras | Jornadas |
-|---|---------------|-----------|--------|----------|
-| 1 | | | | |
-
-<!-- Repetir fases conforme necessário. Máximo 4-5 fases. -->
-
-### Visão geral
-
-| Fase | Nome | Prioridade | Entregável | Depende de |
-|------|------|-----------|------------|------------|
-| 1 | | P1 | | — |
-| 2 | | P1 | | Fase 1 |
-
----
-
-## 12. Dependências
-
-| Dependência | Tipo | Status | Impacto se indisponível |
-|-------------|------|--------|------------------------|
-|             | feature / serviço / tabela | pronto / pendente | |
-
----
-
-## 13. Fora de Escopo
-
-> Explicitamente listado — o que NÃO será feito nesta feature.
-
-| # | Item | Motivo |
-|---|------|--------|
-| 1 |      | futuro / outra feature / decisão do usuário |
-
----
-
-## 14. Ambiguidades e Perguntas
-
-> ⚠️ **BLOQUEANTE** — o fluxo NÃO avança até o usuário responder TODAS.
-
-| # | Pergunta | Contexto | Fonte | Resposta do usuário |
-|---|----------|----------|-------|---------------------|
-| 1 | ⚠️ | | | (aguardando) |
-
----
-
-## 15. Rastreabilidade — De onde veio cada informação
-
-> Mapa de qual insumo originou qual seção. Permite auditoria da extração.
-
-| Insumo | Tipo | O que foi extraído |
-|--------|------|--------------------|
-| `{{arquivo}}` | {{tipo}} | {{seções alimentadas}} |
-
----
-
-> **Próximo passo**: Após aprovação do usuário, este PRD alimenta a geração do `sdd.md` e das tasks (`*_tasks.md`).
+# PRD — {{FEATURE}}
+## Product Requirements Document
+
+> **Artefato gerado pela IA** a partir do processamento de todos os insumos em `workspace/Input/{{FEATURE}}/`.
+> Este é o checkpoint de extração — o usuário DEVE revisar e aprovar antes de prosseguir.
+> Todos os documentos subsequentes (SDD, tasks) são gerados a partir DESTE arquivo.
+
+---
+
+## Meta
+
+| Campo | Valor |
+|-------|-------|
+| Feature | `{{FEATURE}}` |
+| Status | `em extração` → `aguardando revisão` → `aprovado` |
+| Insumos processados | {{LISTA_INSUMOS}} |
+| Gerado em | |
+| Aprovado em | |
+
+---
+
+<!--
+=============================================================================
+INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
+=============================================================================
+
+QUANDO USAR: Gerado pelo /extract (chamado via /feature).
+QUEM GERA: Agent Analyzer (Opus) a partir dos outputs dos Readers (Sonnet).
+
+COMO GERAR:
+1. Readers (Sonnet) leem cada arquivo do PM/ individualmente e catalogam por seção
+2. Analyzer (Opus) recebe todos os outputs e:
+   a. Consolida em visão unificada
+   b. Cruza informações entre fontes — detecta contradições
+   c. Identifica gaps — seções sem informação viram ambiguidades
+   d. Gera este documento seguindo as 14 seções fixas
+3. Ler `docs/` para contexto de arquitetura existente
+4. Para cada informação, registrar DE QUAL insumo veio (rastreabilidade §14)
+5. Se faltam dados para preencher uma seção → pergunta BLOQUEANTE em §13
+
+FORMATOS DE INSUMO (o que extrair de cada):
+- .txt, .md → requisitos, regras, contexto, restrições
+- .sql → entidades, campos, tipos, constraints, índices, relações
+- .html → telas, campos (data-field), ações (data-action),
+  validações (data-validation), rotas (data-route),
+  permissões (data-permission), estados (data-state)
+- .xml (drawio) → fluxos, decisões, atores, sequências
+- .csv → dados tabulares, mapeamentos
+- .png, .jpg, .pdf → wireframes, mockups (análise visual)
+- Outros → extrair o que for relevante — nunca ignorar
+
+REGRAS DA EXTRAÇÃO:
+- Categorias FIXAS (as 15 seções abaixo) — não inventar novas
+- §11 Fases de Entrega é OBRIGATÓRIO — organizar funcionalidades em fases incrementais
+  Se existe backlog_extraido.md, usar como referência para as fases
+  Princípio: entregáveis contínuos, cada fase entrega valor e pode ir pra produção
+- Regras de negócio com IDs únicos e ESTÁVEIS (RN-001, RN-002...)
+  → IDs nunca renumeram após criação. Em re-extração, novos continuam sequência
+- Ambiguidades como perguntas diretas — BLOQUEANTES
+- SEM texto narrativo — apenas informação estruturada em tabelas e listas
+- Rastreabilidade: de qual arquivo veio cada informação
+- Nunca INFERIR regra de negócio — se não está explícito, é ambiguidade
+- Contradição entre fontes → gerar ambiguidade citando os dois arquivos
+
+RE-EXTRAÇÃO:
+- Merge ADITIVO com PRD existente (não sobrescrever)
+- Seções afetadas marcadas com <!-- ATUALIZADO: re-extração ISO_DATE -->
+- IDs de regras continuam sequência existente
+
+=============================================================================
+-->
+
+## 1. Contexto e Motivação
+
+### Qual problema resolve?
+<!-- POR QUÊ essa feature existe — extraído dos insumos -->
+
+### Como funciona hoje?
+<!-- Estado ATUAL — o que existe, como é feito, quais os problemas -->
+
+### Estado desejado
+<!-- O que muda com essa feature — o delta é o escopo real -->
+
+---
+
+## 2. Atores e Permissões
+
+| Ator | O que pode fazer | O que NÃO pode fazer |
+|------|------------------|----------------------|
+|      |                  |                      |
+
+---
+
+## 3. Entidades e Modelo de Dados
+
+> Extraído de: arquivos `.sql`, protótipos, texto livre.
+
+| Entidade | Campos principais | Tipo dos campos | Relações |
+|----------|-------------------|-----------------|----------|
+|          |                   |                 |          |
+
+### Índices e constraints identificados
+-
+
+### Histórico / Auditoria
+-
+
+---
+
+## 4. Jornadas do Usuário
+
+> Extraído de: protótipos HTML, textos, fluxos.
+
+### Jornada 1: {{NOME}}
+| Passo | Ator | Ação | Resultado esperado |
+|-------|------|------|--------------------|
+| 1     |      |      |                    |
+
+---
+
+## 5. Regras de Negócio
+
+> Extraídas de TODOS os insumos. Cada regra deve ser clara, testável e ter ID único.
+
+| ID | Regra | Fonte | Testável? |
+|----|-------|-------|-----------|
+| RN-001 | | {{arquivo_fonte}} | Sim/Não |
+
+---
+
+## 6. Validações
+
+> Extraídas de: protótipos (`data-validation`), `.sql` (constraints), texto.
+
+| Campo | Validações | Obrigatório? | Máscara | Fonte |
+|-------|-----------|--------------|---------|-------|
+|       |           |              |         |       |
+
+---
+
+## 7. Telas e Componentes UI
+
+> Extraídos de: protótipos HTML (`data-field`, `data-action`, `data-route`, `data-state`).
+
+### Tela 1: {{NOME}}
+- **Rota**: 
+- **Campos**: (extraídos dos `data-field`)
+- **Ações**: (extraídas dos `data-action`)
+- **Navegação**: (extraída dos `data-route`)
+- **Estados**: (extraídos dos `data-state`)
+- **Permissões por elemento**: (extraídos dos `data-permission`)
+
+---
+
+## 8. Integrações Externas
+
+| Serviço | Método | Quando é chamado | O que envia | O que recebe | Fallback |
+|---------|--------|------------------|-------------|--------------|----------|
+|         |        |                  |             |              |          |
+
+---
+
+## 9. Cenários de Erro
+
+| # | Cenário | Causa | Comportamento esperado | Fonte |
+|---|---------|-------|----------------------|-------|
+| 1 |         |       |                      |       |
+
+---
+
+## 10. Requisitos Não-Funcionais
+
+| Aspecto | Requisito | Fonte |
+|---------|-----------|-------|
+| Volume esperado | | |
+| Performance | | |
+| Disponibilidade | | |
+| Acessibilidade | | |
+
+---
+
+## 11. Fases de Entrega
+
+> Princípio: **entregáveis contínuos** — cada fase entrega valor e pode ir pra produção.
+> Fases são sequenciais por dependência. Cada uma tem entregável testável.
+> Se o `/extract` foi precedido por um roadmap (backlog_extraido.md), usar as fases como base.
+
+### Fase 1 — {{Nome}} [P1]
+
+> **Entregável**: {{O que o usuário pode usar ao final}}
+> **Critério de done**: {{Como validar — testes E2E que devem passar}}
+
+| # | Funcionalidade | Entidades | Regras | Jornadas |
+|---|---------------|-----------|--------|----------|
+| 1 | | | RN-NNN | Jornada N |
+
+### Fase 2 — {{Nome}} [P1]
+
+> **Entregável**: {{...}}
+> **Critério de done**: {{...}}
+> **Depende de**: Fase 1
+
+| # | Funcionalidade | Entidades | Regras | Jornadas |
+|---|---------------|-----------|--------|----------|
+| 1 | | | | |
+
+<!-- Repetir fases conforme necessário. Máximo 4-5 fases. -->
+
+### Visão geral
+
+| Fase | Nome | Prioridade | Entregável | Depende de |
+|------|------|-----------|------------|------------|
+| 1 | | P1 | | — |
+| 2 | | P1 | | Fase 1 |
+
+---
+
+## 12. Dependências
+
+| Dependência | Tipo | Status | Impacto se indisponível |
+|-------------|------|--------|------------------------|
+|             | feature / serviço / tabela | pronto / pendente | |
+
+---
+
+## 13. Fora de Escopo
+
+> Explicitamente listado — o que NÃO será feito nesta feature.
+
+| # | Item | Motivo |
+|---|------|--------|
+| 1 |      | futuro / outra feature / decisão do usuário |
+
+---
+
+## 14. Ambiguidades e Perguntas
+
+> ⚠️ **BLOQUEANTE** — o fluxo NÃO avança até o usuário responder TODAS.
+
+| # | Pergunta | Contexto | Fonte | Resposta do usuário |
+|---|----------|----------|-------|---------------------|
+| 1 | ⚠️ | | | (aguardando) |
+
+---
+
+## 15. Rastreabilidade — De onde veio cada informação
+
+> Mapa de qual insumo originou qual seção. Permite auditoria da extração.
+
+| Insumo | Tipo | O que foi extraído |
+|--------|------|--------------------|
+| `{{arquivo}}` | {{tipo}} | {{seções alimentadas}} |
+
+---
+
+> **Próximo passo**: Após aprovação do usuário, este PRD alimenta a geração do `sdd.md` e das tasks (`*_tasks.md`).