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

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

@@ -1,200 +1,204 @@
-# TRD — {{PROJETO}}
-## Technical Requirements Document
-
-> **Artefato gerado pela IA** a partir do processamento de todos os insumos em `docs/PM/setup_projeto/`.
-> Este é o checkpoint de extração para ESTRUTURAÇÃO do projeto.
-> Após aprovação, gera os documentos de `docs/Estrutura/`.
-
----
-
-## Meta
-
-| Campo | Valor |
-|-------|-------|
-| Tipo | `setup-projeto` |
-| 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 /setup-projeto). NUNCA por /feature.
-QUEM GERA: Agent Analyzer (Opus) a partir dos outputs dos Readers (Sonnet).
-
-COMO GERAR:
-1. Readers (Sonnet) leem cada arquivo de docs/PM/setup_projeto/ individualmente
-2. Analyzer (Opus) recebe todos os outputs e:
-   a. Consolida decisões técnicas, stack, arquitetura, modelo base
-   b. Cruza informações entre fontes — detecta contradições
-   c. Identifica gaps — decisões críticas sem resposta viram perguntas §9
-   d. Gera este documento seguindo as 10 seções fixas
-3. Focar em ESTRUTURA do sistema, não em features específicas
-4. Para cada informação, registrar DE QUAL insumo veio (§10)
-
-FORMATOS DE INSUMO (o que extrair de cada):
-- .txt, .md → visão, requisitos técnicos, decisões de arquitetura
-- .sql → modelo de dados base, convenções, tipos
-- .html → protótipos que revelam stack frontend
-- .xml (drawio) → diagramas de arquitetura, fluxos de infra
-- .json → configurações, schemas
-- Outros → extrair o que for relevante
-
-PÓS-APROVAÇÃO:
-- /design gera SDD a partir deste TRD
-- /plan gera tasks DOC que criam os 8 docs de docs/Estrutura/
-- Cada seção do TRD alimenta um doc específico:
-  §1 → Visao.md | §2 → Stack.md | §3 → Arquitetura.md
-  §4 → Modelo_Dados.md | §5 → API.md | §6 → Infraestrutura.md
-  §7 → Seguranca.md | §8 → Visao.md (roadmap de módulos)
-
-REGRAS DA EXTRAÇÃO:
-- Categorias FIXAS (as 10 seções abaixo) — não inventar novas
-- SEM texto narrativo — apenas informação estruturada
-- Ambiguidades são BLOQUEANTES (§9) — workflow para até responder
-- Nunca INFERIR decisão técnica — se não está explícito, perguntar
-- Contradição entre fontes → gerar pergunta em §9 citando ambos
-
-RE-EXTRAÇÃO:
-- Merge ADITIVO com TRD existente (não sobrescrever)
-- Seções afetadas marcadas com <!-- ATUALIZADO: re-extração ISO_DATE -->
-
-=============================================================================
--->
-
-## 1. Visão do Sistema
-
-### O que é?
-<!-- Para que serve o sistema, qual problema resolve -->
-
-### Quem usa?
-
-| Ator | Papel | Permissões gerais |
-|------|-------|--------------------|
-|      |       |                    |
-
-### Integrações externas
-
-| Sistema | Direção | Descrição |
-|---------|---------|-----------|
-|         |         |           |
-
-### Restrições e premissas
--
-
----
-
-## 2. Stack e Tecnologias
-
-| Camada | Tecnologia | Versão | Justificativa extraída |
-|--------|-----------|--------|------------------------|
-|        |           |        |                        |
-
-### Ferramentas de desenvolvimento
-
-| Ferramenta | Para quê |
-|-----------|----------|
-|           |          |
-
----
-
-## 3. Arquitetura
-
-### Containers identificados
-
-| Container | Tecnologia | Responsabilidade |
-|-----------|-----------|-----------------|
-|           |           |                 |
-
-### Padrões de comunicação
--
-
-### Padrões de design
--
-
----
-
-## 4. Modelo de Dados Base
-
-> Extraído de: arquivos `.sql`, texto.
-
-| Tabela | Campos principais | Propósito |
-|--------|-------------------|-----------|
-|        |                   |           |
-
-### Convenções identificadas
--
-
----
-
-## 5. Convenções de API
-
-| Aspecto | Convenção extraída |
-|---------|-------------------|
-| Estilo | |
-| Formato | |
-| Versionamento | |
-| Autenticação | |
-| Paginação | |
-| Erros | |
-
----
-
-## 6. Infraestrutura
-
-| Aspecto | Decisão extraída |
-|---------|-----------------|
-| Hospedagem | |
-| CI/CD | |
-| Containers | |
-| Ambientes | |
-
----
-
-## 7. Segurança
-
-| Aspecto | Requisito extraído |
-|---------|-------------------|
-| Autenticação | |
-| Autorização | |
-| CORS | |
-| Rate limiting | |
-| LGPD | |
-| Auditoria | |
-
----
-
-## 8. Módulos Planejados
-
-> Roadmap extraído dos insumos — ordem de implementação.
-
-| # | Módulo | Prioridade | Dependências |
-|---|--------|-----------|--------------|
-| 1 |        |           |              |
-
----
-
-## 9. Ambiguidades e Perguntas
-
-> ⚠️ **BLOQUEANTE** — responder antes de gerar docs/Estrutura/.
-
-| # | Pergunta | Contexto | Resposta do usuário |
-|---|----------|----------|---------------------|
-| 1 | ⚠️ | | (aguardando) |
-
----
-
-## 10. Rastreabilidade
-
-| Insumo | Tipo | O que foi extraído |
-|--------|------|--------------------|
-| `{{arquivo}}` | {{tipo}} | {{seções alimentadas}} |
-
----
-
-> **Próximo passo**: Após aprovação, este TRD alimenta a geração de TODOS os documentos de `docs/Estrutura/`.
+# TRD — {{PROJETO}}
+## Technical Requirements Document
+
+> **Artefato gerado pela IA** a partir do processamento de todos os insumos em `workspace/Input/setup_projeto/`.
+> Este é o checkpoint de extração para ESTRUTURAÇÃO do projeto.
+> Após aprovação, gera os documentos de `docs/`.
+
+---
+
+## Meta
+
+| Campo | Valor |
+|-------|-------|
+| Tipo | `setup-projeto` |
+| 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 /setup-projeto). NUNCA por /feature.
+QUEM GERA: Agent Analyzer (Opus) a partir dos outputs dos Readers (Sonnet).
+
+COMO GERAR:
+1. Readers (Sonnet) leem cada arquivo de workspace/Input/setup_projeto/ individualmente
+2. Analyzer (Opus) recebe todos os outputs e:
+   a. Consolida decisões técnicas, stack, arquitetura, modelo base
+   b. Cruza informações entre fontes — detecta contradições
+   c. Identifica gaps — decisões críticas sem resposta viram perguntas §9
+   d. Gera este documento seguindo as 10 seções fixas
+3. Focar em ESTRUTURA do sistema, não em features específicas
+4. Para cada informação, registrar DE QUAL insumo veio (§10)
+
+FORMATOS DE INSUMO (o que extrair de cada):
+- .txt, .md → visão, requisitos técnicos, decisões de arquitetura
+- .sql → modelo de dados base, convenções, tipos
+- .html → protótipos que revelam stack frontend
+- .xml (drawio) → diagramas de arquitetura, fluxos de infra
+- .json → configurações, schemas
+- Outros → extrair o que for relevante
+
+PÓS-APROVAÇÃO:
+- /design gera SDD a partir deste TRD e cria os 5 docs de docs/
+- Mapeamento TRD → doc de Estrutura (1 seção pode alimentar múltiplos docs):
+  §1 Visão → domain.md
+  §2 Stack → architecture.md (stack principal) + conventions.md (alternativas, versionamento)
+  §3 Arquitetura → architecture.md
+  §4 Modelo de Dados → domain.md
+  §5 API → apiContracts.md (rotas, paginação, erros, catálogo) + conventions.md (códigos de erro do domínio)
+  §6 Infraestrutura → architecture.md (ambientes, deploy, CI/CD) + conventions.md (env vars, domínios, monitoramento)
+  §7 Segurança → conventions.md
+  §8 Módulos → backlog faseado (NÃO vira doc de Estrutura)
+
+REGRAS DA EXTRAÇÃO:
+- Categorias FIXAS (as 10 seções abaixo) — não inventar novas
+- SEM texto narrativo — apenas informação estruturada
+- Ambiguidades são BLOQUEANTES (§9) — workflow para até responder
+- Nunca INFERIR decisão técnica — se não está explícito, perguntar
+- Contradição entre fontes → gerar pergunta em §9 citando ambos
+
+RE-EXTRAÇÃO:
+- Merge ADITIVO com TRD existente (não sobrescrever)
+- Seções afetadas marcadas com <!-- ATUALIZADO: re-extração ISO_DATE -->
+
+=============================================================================
+-->
+
+## 1. Visão do Sistema
+
+### O que é?
+<!-- Para que serve o sistema, qual problema resolve -->
+
+### Quem usa?
+
+| Ator | Papel | Permissões gerais |
+|------|-------|--------------------|
+|      |       |                    |
+
+### Integrações externas
+
+| Sistema | Direção | Descrição |
+|---------|---------|-----------|
+|         |         |           |
+
+### Restrições e premissas
+-
+
+---
+
+## 2. Stack e Tecnologias
+
+| Camada | Tecnologia | Versão | Justificativa extraída |
+|--------|-----------|--------|------------------------|
+|        |           |        |                        |
+
+### Ferramentas de desenvolvimento
+
+| Ferramenta | Para quê |
+|-----------|----------|
+|           |          |
+
+---
+
+## 3. Arquitetura
+
+### Containers identificados
+
+| Container | Tecnologia | Responsabilidade |
+|-----------|-----------|-----------------|
+|           |           |                 |
+
+### Padrões de comunicação
+-
+
+### Padrões de design
+-
+
+---
+
+## 4. Modelo de Dados Base
+
+> Extraído de: arquivos `.sql`, texto.
+
+| Tabela | Campos principais | Propósito |
+|--------|-------------------|-----------|
+|        |                   |           |
+
+### Convenções identificadas
+-
+
+---
+
+## 5. Convenções de API
+
+| Aspecto | Convenção extraída |
+|---------|-------------------|
+| Estilo | |
+| Formato | |
+| Versionamento | |
+| Autenticação | |
+| Paginação | |
+| Erros | |
+
+---
+
+## 6. Infraestrutura
+
+| Aspecto | Decisão extraída |
+|---------|-----------------|
+| Hospedagem | |
+| CI/CD | |
+| Containers | |
+| Ambientes | |
+
+---
+
+## 7. Segurança
+
+| Aspecto | Requisito extraído |
+|---------|-------------------|
+| Autenticação | |
+| Autorização | |
+| CORS | |
+| Rate limiting | |
+| LGPD | |
+| Auditoria | |
+
+---
+
+## 8. Módulos Planejados
+
+> Roadmap extraído dos insumos — ordem de implementação.
+
+| # | Módulo | Prioridade | Dependências |
+|---|--------|-----------|--------------|
+| 1 |        |           |              |
+
+---
+
+## 9. Ambiguidades e Perguntas
+
+> ⚠️ **BLOQUEANTE** — responder antes de gerar docs/.
+
+| # | Pergunta | Contexto | Resposta do usuário |
+|---|----------|----------|---------------------|
+| 1 | ⚠️ | | (aguardando) |
+
+---
+
+## 10. Rastreabilidade
+
+| Insumo | Tipo | O que foi extraído |
+|--------|------|--------------------|
+| `{{arquivo}}` | {{tipo}} | {{seções alimentadas}} |
+
+---
+
+> **Próximo passo**: Após aprovação, este TRD alimenta a geração de TODOS os documentos de `docs/`.

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

@@ -2,7 +2,7 @@
 nome: "{{NOME}}"
 tipo: "{{feature|setup}}"
 documento: "{{PRD|TRD}}"
-pm_path: "docs/PM/{{NOME}}/"
+pm_path: "workspace/Input/{{NOME}}/"
 status: "not_started"
 ultima_skill: ""
 atualizado_em: ""

package/templates/{docs/_templates → .github/templates}/feature/projetos.template.yaml

@@ -18,7 +18,7 @@
 # - O campo `areas` define quais prefixos de task escrevem nesse repo
 # - Uma área NÃO pode pertencer a dois repos (mapeamento 1:1)
 # - BANCO pode ir junto com api (se usa EF migrations) ou separado (se repo de migrations)
-# - O campo `stack` deve ser consistente com docs/Estrutura/Stack.md
+# - O campo `stack` deve ser consistente com docs/architecture.md (seção Stack Principal)
 # - O `org` é a organização/user do GitHub
 # =============================================================================