spec-first-copilot 0.7.0-beta.1 → 0.7.0

package/templates/.github/templates/feature/Progresso.template.md

@@ -1,141 +1,141 @@
-# Progresso — {{FEATURE}}
-
-> Visão consolidada do andamento da feature.
-> Organizado por **fases de entrega** — cada fase é um entregável independente.
-> Atualizado automaticamente pelo /sf-dev a cada task concluída.
->
-> **Este arquivo rastreia FASES DE ENTREGA, não o pipeline do SFW.**
-> O estado do pipeline (extract_done, design_done, plan_done, dev_in_progress, dev_done, done)
-> vive em `.context.md`. Aqui rastreamos: "as fases de entrega do PRD §11 já foram implementadas?"
-
----
-
-## Status das Fases: `não iniciado`
-
-<!-- não iniciado → em desenvolvimento → em revisão → concluído → arquivado
-(vocabulário PRÓPRIO deste arquivo — não confundir com status da pipeline em .context.md) -->
-
----
-
-<!--
-=============================================================================
-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 specs/{nome}/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 /sf-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. DB (schema/migrations)
-  3. BACK (endpoints) ← pode paralelizar com FRONT após DB
-  4. FRONT (telas)
-  → PR Fase 1 + testes manuais + merge
-
-Fase 2:
-  1. DB (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/`
-- [ ] Atualizar `workspace/Output/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 /sf-dev a cada task concluída.
+>
+> **Este arquivo rastreia FASES DE ENTREGA, não o pipeline do SFW.**
+> O estado do pipeline (extract_done, design_done, plan_done, dev_in_progress, dev_done, done)
+> vive em `.context.md`. Aqui rastreamos: "as fases de entrega do PRD §11 já foram implementadas?"
+
+---
+
+## Status das Fases: `não iniciado`
+
+<!-- não iniciado → em desenvolvimento → em revisão → concluído → arquivado
+(vocabulário PRÓPRIO deste arquivo — não confundir com status da pipeline em .context.md) -->
+
+---
+
+<!--
+=============================================================================
+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 specs/{nome}/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 /sf-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. DB (schema/migrations)
+  3. BACK (endpoints) ← pode paralelizar com FRONT após DB
+  4. FRONT (telas)
+  → PR Fase 1 + testes manuais + merge
+
+Fase 2:
+  1. DB (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 e/ou TRD aprovados, specs/ 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
+- [ ] Rodar /sf-merge-docs (diff semântico PRD+TRD ↔ docs/) atualizou `docs/`
+- [ ] Atualizar `workspace/Output/progresso.md` (visão global)
+- [ ] Atualizar `.ai/memory/napkin.md` se houver aprendizado relevante