spec-first-copilot 0.2.0 → 0.4.0

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

@@ -1,82 +1,82 @@
-# 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 |
-|------|---------|------|-----------|
-|      |         |      |           |
+# 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/Progresso.template.md

@@ -1,136 +1,136 @@
-# Progresso — {{FEATURE}}
-
-> Visão consolidada do andamento da feature.
-> Organizado por **fases de entrega** — cada fase é um entregável independente.
-> Atualizado automaticamente pelo /dev a cada task concluída.
-
----
-
-## Status Geral: `não iniciado`
-
-<!-- não iniciado → em desenvolvimento → em revisão → concluído → arquivado -->
-
----
-
-<!--
-=============================================================================
-INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
-=============================================================================
-
-COMO GERAR ESTE ARQUIVO:
-
-1. Ler PRD §11 (Fases de Entrega) para definir as fases
-2. Ler TODOS os *_tasks.md da feature
-3. Para cada FASE DE ENTREGA, listar as áreas e contagem de tasks
-4. A visão primária é POR FASE, não por área
-
-COMO ATUALIZAR:
-
-- O /dev atualiza após cada task concluída
-- Status por fase: ⬜ pendente → 🔄 em andamento → ✅ concluída
-- Fase concluída = todas tasks de todas áreas daquela fase estão [x]
-- Ao concluir uma fase: registrar no Histórico + abrir PR
-
-=============================================================================
--->
-
-## Fases de Entrega
-
-| Fase | Nome | Prioridade | Entregável | Status | Tasks |
-|------|------|-----------|------------|--------|-------|
-| 1 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
-| 2 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
-| 3 | {{Nome}} | P2 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
-
----
-
-## Fase 1 — {{Nome}} [P1]
-
-> **Entregável**: {{O que o usuário pode usar}}
-> **Critério de done**: {{Testes E2E que devem passar}}
-> **Branch**: `feature/{{FEATURE}}_fase1`
-> **PR**: (a ser criado)
-
-### Tasks por área
-
-#### {{AREA_1}} ({{N}} tasks)
-
-| Task | Descrição | Tamanho | Repo | Status |
-|------|-----------|---------|------|--------|
-| AREA-001 | | S/M/L | {{repo}} | ⬜ |
-
-#### {{AREA_2}} ({{N}} tasks)
-
-| Task | Descrição | Tamanho | Repo | Status |
-|------|-----------|---------|------|--------|
-| AREA-001 | | S/M/L | {{repo}} | ⬜ |
-
-### Resumo Fase 1
-
-| Área | Total | Feitas | % |
-|------|-------|--------|---|
-| {{AREA_1}} | {{N}} | 0 | 0% |
-| {{AREA_2}} | {{N}} | 0 | 0% |
-| **Total Fase 1** | **{{N}}** | **0** | **0%** |
-
----
-
-## Fase 2 — {{Nome}} [P1]
-
-> **Entregável**: {{...}}
-> **Depende de**: Fase 1 concluída
-
-<!-- Repetir mesma estrutura -->
-
----
-
-## Totais Gerais
-
-| Fase | Total | Feitas | % |
-|------|-------|--------|---|
-| Fase 1 | {{N}} | 0 | 0% |
-| Fase 2 | {{N}} | 0 | 0% |
-| **Total** | **{{N}}** | **0** | **0%** |
-
----
-
-## Ordem de Execução
-
-```
-Fase 1:
-  1. INFRA (setup de repos/ambiente)
-  2. BANCO (schema/migrations)
-  3. BACK (endpoints) ← pode paralelizar com FRONT após BANCO
-  4. FRONT (telas)
-  → PR Fase 1 + testes manuais + merge
-
-Fase 2:
-  1. BANCO (novas tabelas/migrations)
-  2. BACK (endpoints + regras)
-  3. FRONT (telas + integração)
-  → PR Fase 2 + testes manuais + merge
-```
-
----
-
-## Histórico
-
-| Data | Evento | Detalhes |
-|------|--------|----------|
-| | Feature criada | PRD aprovado, SDD gerado |
-
----
-
-## Pós-conclusão (por fase)
-
-- [ ] PR aberto com template detalhado
-- [ ] Ambiente local rodando para testes manuais
-- [ ] Testes automatizados passando (unit + integration + security)
-- [ ] Usuário aprovou e fez merge
-
-## Pós-conclusão (feature completa)
-
-- [ ] Todas fases concluídas e mergeadas
-- [ ] Mergear Delta Specs (SDD §11) nos docs de `docs/Estrutura/`
-- [ ] Atualizar `docs/Desenvolvimento/progresso.md` (visão global)
-- [ ] Atualizar `.ai/memory/napkin.md` se houver aprendizado relevante
+# Progresso — {{FEATURE}}
+
+> Visão consolidada do andamento da feature.
+> Organizado por **fases de entrega** — cada fase é um entregável independente.
+> Atualizado automaticamente pelo /dev a cada task concluída.
+
+---
+
+## Status Geral: `não iniciado`
+
+<!-- não iniciado → em desenvolvimento → em revisão → concluído → arquivado -->
+
+---
+
+<!--
+=============================================================================
+INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
+=============================================================================
+
+COMO GERAR ESTE ARQUIVO:
+
+1. Ler PRD §11 (Fases de Entrega) para definir as fases
+2. Ler TODOS os *_tasks.md da feature
+3. Para cada FASE DE ENTREGA, listar as áreas e contagem de tasks
+4. A visão primária é POR FASE, não por área
+
+COMO ATUALIZAR:
+
+- O /dev atualiza após cada task concluída
+- Status por fase: ⬜ pendente → 🔄 em andamento → ✅ concluída
+- Fase concluída = todas tasks de todas áreas daquela fase estão [x]
+- Ao concluir uma fase: registrar no Histórico + abrir PR
+
+=============================================================================
+-->
+
+## Fases de Entrega
+
+| Fase | Nome | Prioridade | Entregável | Status | Tasks |
+|------|------|-----------|------------|--------|-------|
+| 1 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
+| 2 | {{Nome}} | P1 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
+| 3 | {{Nome}} | P2 | {{Entregável}} | ⬜ pendente | 0/{{N}} |
+
+---
+
+## Fase 1 — {{Nome}} [P1]
+
+> **Entregável**: {{O que o usuário pode usar}}
+> **Critério de done**: {{Testes E2E que devem passar}}
+> **Branch**: `feature/{{FEATURE}}_fase1`
+> **PR**: (a ser criado)
+
+### Tasks por área
+
+#### {{AREA_1}} ({{N}} tasks)
+
+| Task | Descrição | Tamanho | Repo | Status |
+|------|-----------|---------|------|--------|
+| AREA-001 | | S/M/L | {{repo}} | ⬜ |
+
+#### {{AREA_2}} ({{N}} tasks)
+
+| Task | Descrição | Tamanho | Repo | Status |
+|------|-----------|---------|------|--------|
+| AREA-001 | | S/M/L | {{repo}} | ⬜ |
+
+### Resumo Fase 1
+
+| Área | Total | Feitas | % |
+|------|-------|--------|---|
+| {{AREA_1}} | {{N}} | 0 | 0% |
+| {{AREA_2}} | {{N}} | 0 | 0% |
+| **Total Fase 1** | **{{N}}** | **0** | **0%** |
+
+---
+
+## Fase 2 — {{Nome}} [P1]
+
+> **Entregável**: {{...}}
+> **Depende de**: Fase 1 concluída
+
+<!-- Repetir mesma estrutura -->
+
+---
+
+## Totais Gerais
+
+| Fase | Total | Feitas | % |
+|------|-------|--------|---|
+| Fase 1 | {{N}} | 0 | 0% |
+| Fase 2 | {{N}} | 0 | 0% |
+| **Total** | **{{N}}** | **0** | **0%** |
+
+---
+
+## Ordem de Execução
+
+```
+Fase 1:
+  1. INFRA (setup de repos/ambiente)
+  2. BANCO (schema/migrations)
+  3. BACK (endpoints) ← pode paralelizar com FRONT após BANCO
+  4. FRONT (telas)
+  → PR Fase 1 + testes manuais + merge
+
+Fase 2:
+  1. BANCO (novas tabelas/migrations)
+  2. BACK (endpoints + regras)
+  3. FRONT (telas + integração)
+  → PR Fase 2 + testes manuais + merge
+```
+
+---
+
+## Histórico
+
+| Data | Evento | Detalhes |
+|------|--------|----------|
+| | Feature criada | PRD aprovado, SDD gerado |
+
+---
+
+## Pós-conclusão (por fase)
+
+- [ ] PR aberto com template detalhado
+- [ ] Ambiente local rodando para testes manuais
+- [ ] Testes automatizados passando (unit + integration + security)
+- [ ] Usuário aprovou e fez merge
+
+## Pós-conclusão (feature completa)
+
+- [ ] Todas fases concluídas e mergeadas
+- [ ] Mergear Delta Specs (SDD §11) nos docs de `docs/Estrutura/`
+- [ ] Atualizar `docs/Desenvolvimento/progresso.md` (visão global)
+- [ ] Atualizar `.ai/memory/napkin.md` se houver aprendizado relevante