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

package/templates/docs/_templates/estrutura/Stack.template.md

@@ -1,78 +0,0 @@
-# Stack Tecnológica
-
-> Tecnologias escolhidas, versões fixadas, e alternativas descartadas com justificativa.
-
----
-
-<!--
-=============================================================================
-INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
-=============================================================================
-
-ORIGEM: Gerado pelo /setup-projeto a partir do TRD §2.
-ATUALIZAÇÃO: /merge-delta quando features introduzem novas tecnologias ou mudanças de stack (raro — deve gerar ADR).
-
-COMO GERAR:
-1. Ler TRD §2 (Stack e Tecnologias) — todas decisões de tech
-2. Preencher TODAS as camadas, mesmo que "a definir"
-3. Para cada tecnologia: versão EXATA (não "latest")
-4. Justificativa deve ser técnica, não "é popular"
-5. Alternativas descartadas: documentar POR QUE foram rejeitadas (evita rediscussão)
-
-REGRAS:
-- Versões devem ser fixadas (ex: "18.3.1", não "^18.0.0")
-- Cada biblioteca/pacote precisa de justificativa (evita bloat)
-- Alternativas descartadas previnem que o time rediscuta decisões já tomadas
-- Mudanças de stack DEVEM gerar ADR em ADRs.md
-- Camadas são dinâmicas — adicionar conforme necessidade (mobile, infra, etc.)
-
-=============================================================================
--->
-
-## Stack Principal
-
-| Camada | Tecnologia | Versão | Justificativa |
-|--------|-----------|--------|---------------|
-| Frontend | | | |
-| Backend | | | |
-| Banco de Dados | | | |
-| ORM/Query Builder | | | |
-| Autenticação | | | |
-| Testes | | | |
-| CI/CD | | | |
-
-<!-- Adicionar camadas conforme necessidade: Mobile, Cache, Fila, Monitoramento, etc. -->
-
-## Bibliotecas e Dependências
-
-<!-- Repetir seção para cada camada que tenha dependências relevantes -->
-
-### {{Camada}}
-
-| Pacote | Versão | Para quê | Alternativa descartada |
-|--------|--------|----------|----------------------|
-|        |        |          |                      |
-
-## Alternativas Descartadas
-
-> Decisões já tomadas. Se alguém perguntar "por que não usamos X?", a resposta está aqui.
-
-| Tecnologia escolhida | Alternativa considerada | Por que descartamos | Ref ADR |
-|----------------------|------------------------|---------------------|---------|
-|                      |                        |                     |         |
-
-## Convenções de Versionamento
-
-| Aspecto | Convenção |
-|---------|-----------|
-| Versionamento | <!-- Semver? Pinned? --> |
-| Lock files | <!-- package-lock.json? yarn.lock? --> |
-| Atualização | <!-- Dependabot? Manual? Periodicidade? --> |
-
----
-
-## Changelog
-
-| Data | Feature | Tipo | Descrição |
-|------|---------|------|-----------|
-|      |         |      |           |

package/templates/docs/_templates/estrutura/Visao.template.md

@@ -1,82 +0,0 @@
-# Visão do Sistema
-
-> C4 Nível 1 — Contexto do sistema: o que é, quem usa, com o que integra, quais restrições existem.
-
----
-
-<!--
-=============================================================================
-INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
-=============================================================================
-
-ORIGEM: Gerado pelo /setup-projeto a partir do TRD §1.
-ATUALIZAÇÃO: /merge-delta quando features alteram contexto global (novos atores, integrações, restrições).
-
-COMO GERAR:
-1. Ler TRD §1 (Visão do Sistema) — é a fonte primária
-2. Ler TRD §8 (Módulos Planejados) — alimenta o Roadmap
-3. Descrever o sistema em 2-3 frases objetivas (sem jargão de marketing)
-4. Listar TODOS os atores e papéis mencionados nos insumos
-5. Listar TODAS as integrações externas com direção clara
-6. Glossário: termos de domínio que o time precisa compartilhar (DDD ubiquitous language)
-
-REGRAS:
-- Descrição do sistema deve responder: O QUE faz, PARA QUEM, QUAL PROBLEMA resolve
-- Atores devem ter permissões gerais claras (o que pode E o que NÃO pode)
-- Integrações devem ter direção explícita (envia/recebe/ambos)
-- Glossário não é opcional — termos ambíguos geram bugs
-
-=============================================================================
--->
-
-## O que é este sistema?
-
-<!-- Descrição em 2-3 frases. O que ele faz, para quem, qual problema resolve. -->
-
-
-## Usuários e Papéis
-
-| Papel | O que faz | O que NÃO pode fazer | Nível de acesso |
-|-------|-----------|----------------------|-----------------|
-|       |           |                      |                 |
-
-## Integrações Externas
-
-| Sistema/Serviço | Tipo (API/Webhook/Arquivo/Fila) | Direção (Envia/Recebe/Ambos) | Descrição | SLA/Disponibilidade |
-|-----------------|--------------------------------|------------------------------|-----------|---------------------|
-|                 |                                |                              |           |                     |
-
-## Restrições e Premissas
-
-### Restrições técnicas
--
-
-### Restrições de negócio
--
-
-### Premissas
--
-
-## Roadmap de Módulos
-
-> Extraído do TRD §8. Visão de alto nível das funcionalidades planejadas.
-
-| # | Módulo | Prioridade | Dependências | Status |
-|---|--------|-----------|--------------|--------|
-|   |        |           |              | planejado / em desenvolvimento / concluído |
-
-## Glossário
-
-> Termos do domínio usados em todo o projeto. Linguagem ubíqua (DDD).
-
-| Termo | Definição | Exemplo de uso |
-|-------|-----------|----------------|
-|       |           |                |
-
----
-
-## Changelog
-
-| Data | Feature | Tipo | Descrição |
-|------|---------|------|-----------|
-|      |         |      |           |

package/templates/docs/_templates/feature/tasks.template.md

@@ -1,115 +0,0 @@
-# Tasks — {{AREA}} — {{FEATURE}}
-
-> Checklist de implementação organizado por **fases** e **prioridade**.
-> O Coder consulta o `sdd.md` para detalhes técnicos.
-> Este arquivo define O QUE fazer, EM QUE ORDEM, e ONDE.
-
----
-
-## Meta
-
-| Campo | Valor |
-|-------|-------|
-| Feature | `{{FEATURE}}` |
-| Área | {{AREA}} |
-| SDD | [`sdd.md`](./sdd.md) {{SDD_SECTIONS}} |
-| Total de tasks | {{TOTAL}} |
-| Depende de | {{AREA_DEPENDENCIES}} |
-
----
-
-<!--
-=============================================================================
-INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
-=============================================================================
-
-COMO GERAR ESTE ARQUIVO:
-
-1. Ler o SDD completo da feature
-2. Identificar TODAS as áreas afetadas (banco, back, front, mobile, infra...)
-3. Para CADA área, gerar um arquivo `{area}_tasks.md` usando este template
-4. Áreas são DINÂMICAS — determinadas pelo SDD, não pré-definidas
-
-COMO DEFINIR FASES:
-
-- Agrupar tasks por etapa lógica de implementação
-- Fases são SEQUENCIAIS dentro da área (Fase 2 depende de Fase 1)
-- Usar prioridade P1/P2/P3 por fase
-- Nomear fases de forma descritiva (não só "Fase 1")
-- Exemplos de fases por área:
-  
-  BANCO:     Setup → Schema → Índices → Seeds
-  BACKEND:   Setup → DTOs/Validações → Repository/Service → Controller → Testes
-  FRONTEND:  Setup/Rotas → Componentes → Telas → Polish
-  MOBILE:    Setup → Navegação → Telas → Offline → Push
-  INFRA:     Provisão → Config → Deploy → Monitoramento
-
-COMO ESCREVER CADA TASK:
-
-- Formato checklist: `- [ ] **ID**: Título [Tamanho]`
-- ID: {PREFIXO}-{NNN} sequencial (BANCO-001, BACK-001, FRONT-001, MOBILE-001...)
-- Título: verbo no infinitivo + o que fazer
-- Tamanho: S (< 30min), M (30min-2h), L (2h+)
-- Fase: número da fase de entrega (do PRD §11) — OBRIGATÓRIO
-- Repo: nome do repo (de projetos.yaml) — OBRIGATÓRIO
-- Arquivos: EXATAMENTE quais files criar ou alterar (caminhos RELATIVOS ao repo)
-- SDD: seção específica (§3.1, §5 POST /rota, §6 Tela X)
-- Depende: IDs de tasks (mesma área ou cross-area)
-
-REGRAS:
-
-- Task deve ser AUTOCONTIDA: Coder lê SDD + esta task, nada mais
-- NÃO duplicar conteúdo do SDD — apenas referenciar seções
-- NÃO incluir status — vive só no Progresso.md
-- Depende cross-area é permitido (FRONT-004 depende de BACK-009)
-- "Regras desta área" = convenções específicas extraídas do SDD e docs/Estrutura
-
-=============================================================================
--->
-
-## Fase 1 — {{FASE_NOME}} [{{PRIORIDADE}}]
-
-> {{FASE_CONTEXTO — 1 linha explicando o propósito da fase}}
-<!-- Opcional: "Depende de: Área X Fase Y concluída" -->
-
-- [ ] **{{PREFIXO}}-001**: {{Título descritivo}} [{{S|M|L}}]
-  - Fase: {{N}} — {{Nome fase de entrega}}
-  - Repo: `{{repo_name}}`
-  - Arquivos: `{{caminho/arquivo.ext}}`
-  - SDD: {{§N seção específica}}
-  - Depende: {{ID ou —}}
-
-- [ ] **{{PREFIXO}}-002**: {{Título descritivo}} [{{S|M|L}}]
-  - Fase: {{N}} — {{Nome fase de entrega}}
-  - Repo: `{{repo_name}}`
-  - Arquivos: `{{caminho/arquivo1.ext}}`, `{{caminho/arquivo2.ext}}`
-  - SDD: {{§N.M subseção}}
-  - Depende: {{PREFIXO}}-001
-
----
-
-## Fase 2 — {{FASE_NOME}} [{{PRIORIDADE}}]
-
-> {{FASE_CONTEXTO}}
-
-- [ ] **{{PREFIXO}}-003**: {{Título}} [{{S|M|L}}]
-  - Fase: {{N}} — {{Nome fase de entrega}}
-  - Repo: `{{repo_name}}`
-  - Arquivos: `{{caminho/}}`
-  - SDD: {{§N}}
-  - Depende: {{PREFIXO}}-001, {{OUTRA_AREA}}-001
-
-<!-- Repetir fases conforme necessário -->
-
----
-
-## Regras desta área
-
-<!-- Extraídas do SDD e docs/Estrutura/ — específicas para esta área -->
-1. {{Regra 1}}
-2. {{Regra 2}}
-
----
-
-> **Legenda tamanho**: S = < 30min · M = 30min-2h · L = 2h+
-> **Legenda prioridade**: P1 = bloqueia outras áreas · P2 = importante · P3 = nice-to-have