spec-first-copilot 0.1.0

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

@@ -0,0 +1,99 @@
+# Modelo de Dados
+
+> Schema completo, relações, índices, convenções de nomenclatura e estratégia de migrations.
+
+---
+
+<!--
+=============================================================================
+INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
+=============================================================================
+
+ORIGEM: Gerado pelo /setup-projeto a partir do TRD §4.
+ATUALIZAÇÃO: /merge-delta a cada feature que adiciona/altera tabelas (Delta Specs do SDD §3 e §11).
+
+COMO GERAR:
+1. Ler TRD §4 (Modelo de Dados Base) — tabelas iniciais, convenções
+2. Gerar diagrama ER textual com TODAS as relações
+3. Para cada tabela: campos com tipos EXATOS (varchar(255), não "string")
+4. Convenções de nomenclatura são FIXAS após setup — não mudam por feature
+5. Estratégia de migrations deve ser concreta (ferramenta, naming, rollback)
+
+REGRAS:
+- Tipos devem ser do banco escolhido (PostgreSQL, MySQL, etc.), não genéricos
+- Toda FK deve ter ON DELETE/ON UPDATE definido
+- Índices precisam de justificativa (query que justifica)
+- Convenções definidas aqui são LEI — SDDs e tasks seguem à risca
+- Diagrama ER deve ser atualizado a cada merge-delta
+
+=============================================================================
+-->
+
+## Diagrama ER
+
+```
+<!-- Representação textual do ER -->
+<!-- Formato: [tabela_a] 1---N [tabela_b] (campo_fk) -->
+```
+
+## Convenções de Nomenclatura
+
+| Elemento | Convenção | Exemplo |
+|----------|-----------|---------|
+| Tabelas | snake_case, plural | `clientes`, `pedidos` |
+| Colunas | snake_case | `nome_completo`, `criado_em` |
+| PKs | `id` (UUID ou SERIAL) | `id UUID PRIMARY KEY DEFAULT gen_random_uuid()` |
+| FKs | `{tabela_singular}_id` | `cliente_id`, `cidade_id` |
+| Índices | `idx_{tabela}_{colunas}` | `idx_clientes_cpf` |
+| Unique | `uq_{tabela}_{colunas}` | `uq_clientes_email` |
+| Timestamps | `criado_em`, `atualizado_em` | `TIMESTAMPTZ NOT NULL DEFAULT now()` |
+| Soft delete | `ativo` (boolean) | `ativo BOOLEAN DEFAULT true` |
+| Auditoria | `criado_por`, `atualizado_por` | `UUID REFERENCES usuarios(id)` |
+
+## Catálogo de Tabelas
+
+<!-- Repetir bloco para cada tabela -->
+
+### {{tabela}}
+
+> Descrição breve da tabela.
+
+| Coluna | Tipo | Nullable | Default | Constraint | Descrição |
+|--------|------|----------|---------|------------|-----------|
+|        |      |          |         |            |           |
+
+**Relações:**
+- `campo_id` → `tabela_ref(id)` — ON DELETE CASCADE / SET NULL / RESTRICT
+
+**Índices:**
+
+| Nome | Colunas | Tipo | Justificativa |
+|------|---------|------|---------------|
+|      |         | btree / unique / gin | <!-- Qual query justifica este índice? --> |
+
+## Estratégia de Migrations
+
+| Aspecto | Convenção |
+|---------|-----------|
+| Ferramenta | <!-- Ex: knex, prisma, flyway, alembic --> |
+| Nomenclatura | <!-- Ex: 001_create_tabela.sql, YYYYMMDD_descricao --> |
+| Rollback | <!-- Toda migration TEM rollback? Testado como? --> |
+| Execução | <!-- Sequencial? Transacional? --> |
+| Dados existentes | <!-- Como lidar com migrations em tabelas com dados? --> |
+
+## Regras Globais de Dados
+
+| Regra | Descrição |
+|-------|-----------|
+| Soft delete | <!-- Todas as tabelas usam? Quais exceções? --> |
+| Auditoria | <!-- criado_por/atualizado_por em todas? --> |
+| Timestamps | <!-- criado_em/atualizado_em obrigatórios? --> |
+| Encoding | <!-- UTF-8? Collation? --> |
+
+---
+
+## Changelog
+
+| Data | Feature | Tipo | Descrição |
+|------|---------|------|-----------|
+|      |         |      |           |

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

@@ -0,0 +1,138 @@
+# Segurança
+
+> Autenticação, autorização, CORS, rate limiting, LGPD, auditoria e proteção de dados.
+
+---
+
+<!--
+=============================================================================
+INSTRUÇÕES PARA O AGENTE (não incluir no arquivo gerado)
+=============================================================================
+
+ORIGEM: Gerado pelo /setup-projeto a partir do TRD §7.
+ATUALIZAÇÃO: /merge-delta quando features adicionam permissões, dados pessoais ou políticas.
+
+COMO GERAR:
+1. Ler TRD §7 (Segurança) — autenticação, autorização, CORS, LGPD
+2. Autenticação: método, expiração, hash, refresh strategy
+3. Autorização: papéis e matriz de permissões (RBAC/ABAC)
+4. LGPD: mapear TODOS dados pessoais com base legal
+5. Auditoria: definir O QUE é logado, ONDE e POR QUANTO TEMPO
+
+REGRAS:
+- Matriz de permissões é DINÂMICA — cresce a cada feature (via merge-delta)
+- Dados pessoais da LGPD precisam de base legal ESPECÍFICA
+- Nunca armazenar senhas em texto plano (hash obrigatório)
+- Secrets nunca no código — sempre variáveis de ambiente
+- Rate limiting obrigatório em endpoints públicos (login, registro)
+- Auditoria obrigatória para operações destrutivas (delete, update de dados sensíveis)
+
+=============================================================================
+-->
+
+## Autenticação
+
+| Aspecto | Implementação |
+|---------|--------------|
+| Método | <!-- JWT? Session? OAuth2? --> |
+| Expiração access token | <!-- Ex: 15min --> |
+| Refresh token | <!-- Existe? Expiração? Rotação? --> |
+| Hash de senha | <!-- bcrypt rounds? argon2? --> |
+| Header | <!-- Authorization: Bearer {token} --> |
+| Armazenamento (client) | <!-- httpOnly cookie? localStorage? --> |
+
+### Fluxo de autenticação
+
+```
+<!-- Descrever o fluxo: login → token → refresh → logout -->
+```
+
+## Autorização
+
+### Modelo
+
+| Aspecto | Decisão |
+|---------|---------|
+| Tipo | <!-- RBAC / ABAC / RBAC + ABAC --> |
+| Onde é verificado | <!-- Middleware? Decorator? Service? --> |
+| Granularidade | <!-- Por rota? Por recurso? Por campo? --> |
+
+### Papéis
+
+| Papel | Descrição | Herda de |
+|-------|-----------|----------|
+|       |           | <!-- Hierarquia: admin herda de user? --> |
+
+### Matriz de Permissões
+
+> Atualizada a cada feature via /merge-delta.
+
+| Recurso | Ação | {{role_1}} | {{role_2}} | {{role_N}} |
+|---------|------|------------|------------|------------|
+|         | criar | | | |
+|         | ler | | | |
+|         | editar | | | |
+|         | deletar | | | |
+
+## CORS
+
+| Aspecto | Configuração |
+|---------|-------------|
+| Allowed Origins | <!-- Configurável por ambiente --> |
+| Allowed Methods | `GET, POST, PUT, PATCH, DELETE` |
+| Allowed Headers | `Authorization, Content-Type` |
+| Credentials | <!-- true/false --> |
+| Max Age | <!-- Preflight cache em segundos --> |
+
+## Rate Limiting
+
+| Categoria | Limite | Janela | Resposta |
+|-----------|--------|--------|----------|
+| Login/Registro | <!-- Ex: 5 req --> | <!-- Ex: 15min --> | 429 + Retry-After |
+| API autenticada | <!-- Ex: 100 req --> | <!-- Ex: 1min --> | 429 + Retry-After |
+| API pública | <!-- Ex: 30 req --> | <!-- Ex: 1min --> | 429 + Retry-After |
+| Upload | <!-- Ex: 10 req --> | <!-- Ex: 1h --> | 429 + Retry-After |
+
+## LGPD / Privacidade
+
+### Dados pessoais coletados
+
+| Dado | Base legal | Finalidade | Retenção | Criptografado? |
+|------|-----------|------------|----------|----------------|
+|      | <!-- Consentimento / Contrato / Legítimo interesse / Obrigação legal --> | | | |
+
+### Direitos do titular
+
+| Direito | Implementação | Endpoint/Fluxo |
+|---------|--------------|----------------|
+| Acesso aos dados | | <!-- Como o usuário acessa? --> |
+| Correção | | |
+| Exclusão (right to be forgotten) | | <!-- Soft delete? Hard delete? Anonimização? --> |
+| Portabilidade | | <!-- Formato de exportação? --> |
+| Revogação de consentimento | | |
+
+## Auditoria
+
+| O que é logado | Quando | Onde armazena | Retenção |
+|----------------|--------|---------------|----------|
+| Login/Logout | sempre | | |
+| Alteração de dados sensíveis | sempre | | |
+| Operações destrutivas (DELETE) | sempre | | |
+| Falhas de autenticação | sempre | | |
+| Mudanças de permissão | sempre | | |
+
+## Proteção de Dados em Trânsito e Repouso
+
+| Aspecto | Implementação |
+|---------|--------------|
+| TLS | <!-- Versão mínima? --> |
+| Dados sensíveis em repouso | <!-- Criptografia? Quais campos? --> |
+| Backup | <!-- Criptografado? Frequência? --> |
+
+---
+
+## Changelog
+
+| Data | Feature | Tipo | Descrição |
+|------|---------|------|-----------|
+|      |         |      |           |

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

@@ -0,0 +1,78 @@
+# 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

@@ -0,0 +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 |
+|------|---------|------|-----------|
+|      |         |      |           |

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

@@ -0,0 +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`).