@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/content/.morph/templates/clarify-questions.md

@@ -1,159 +1,159 @@
-# Checklist de Clarificação - {{FEATURE_NAME_TITLE}}
-
-> Template para FASE 3: CLARIFY
-> Use este checklist para identificar ambiguidades e fazer perguntas estruturadas
-
----
-
-## 🎯 Contexto da Feature
-
-**Feature:** {{FEATURE_NAME}}
-**Fase atual:** CLARIFY
-**Data:** {{DATE}}
-
----
-
-## 📋 Checklist de Clarificação Padrão
-
-### 1. Fluxo de Usuário
-
-- [ ] Existe fluxo gratuito vs pago?
-- [ ] O que acontece em edge cases (erro, timeout, dados inválidos)?
-- [ ] Qual o fluxo de primeiro acesso (onboarding)?
-- [ ] Existem diferentes tipos de usuário com permissões diferentes?
-- [ ] O que acontece se o usuário cancelar no meio do processo?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta específica da feature]_
-2. _[Adicionar pergunta específica da feature]_
-
----
-
-### 2. Integrações Externas
-
-- [ ] Quais campos são obrigatórios para cada API externa?
-- [ ] Há fallbacks se a API externa falhar?
-- [ ] Qual o timeout aceitável para chamadas externas?
-- [ ] Como tratar rate limiting?
-- [ ] Precisa de webhook para eventos da API?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre integração]_
-2. _[Adicionar pergunta sobre integração]_
-
----
-
-### 3. Dados e Persistência
-
-- [ ] Qual a política de retenção de dados?
-- [ ] Precisa de soft delete ou hard delete?
-- [ ] Quais dados são sensíveis e precisam de criptografia?
-- [ ] Precisa de histórico/auditoria de alterações?
-- [ ] Qual o volume esperado de dados?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre dados]_
-2. _[Adicionar pergunta sobre dados]_
-
----
-
-### 4. Performance e Escalabilidade
-
-- [ ] Qual o SLA esperado (tempo de resposta)?
-- [ ] Precisa de cache? Se sim, qual estratégia?
-- [ ] Quantos usuários simultâneos são esperados?
-- [ ] Existem operações que podem ser assíncronas?
-- [ ] Precisa de paginação para listas grandes?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre performance]_
-2. _[Adicionar pergunta sobre performance]_
-
----
-
-### 5. Segurança e Autorização
-
-- [ ] Quem pode acessar esta funcionalidade?
-- [ ] Existem diferentes níveis de permissão?
-- [ ] Precisa de validação de ownership (usuário só vê seus dados)?
-- [ ] Existem dados que não devem ser expostos em logs?
-- [ ] Precisa de CAPTCHA ou proteção contra bots?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre segurança]_
-2. _[Adicionar pergunta sobre segurança]_
-
----
-
-### 6. UI/UX (se aplicável)
-
-- [ ] Qual o estado inicial da tela (vazia, loading, dados)?
-- [ ] O que mostrar quando não há dados?
-- [ ] Quais mensagens de erro/sucesso exibir?
-- [ ] Precisa de confirmação antes de ações destrutivas?
-- [ ] Como tratar formulários muito longos (wizard, seções)?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre UI]_
-2. _[Adicionar pergunta sobre UI]_
-
----
-
-### 7. Notificações e Comunicação
-
-- [ ] Precisa enviar email/SMS/push em algum momento?
-- [ ] Quais eventos disparam notificações?
-- [ ] O usuário pode configurar preferências de notificação?
-- [ ] Precisa de notificações em tempo real (SignalR)?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre notificações]_
-
----
-
-### 8. Regras de Negócio
-
-- [ ] Existem validações específicas do domínio?
-- [ ] Existem limites (máximo de itens, tamanho de arquivo, etc)?
-- [ ] Existem estados/transições de status?
-- [ ] Existem cálculos ou fórmulas específicas?
-- [ ] Existem regras de agendamento (cron, jobs)?
-
-**Perguntas específicas:**
-1. _[Adicionar pergunta sobre regras de negócio]_
-2. _[Adicionar pergunta sobre regras de negócio]_
-
----
-
-## 📝 Respostas Coletadas
-
-> Preencher com as respostas do usuário
-
-| # | Pergunta | Resposta | Impacto no Spec |
-|---|----------|----------|-----------------|
-| 1 | | | |
-| 2 | | | |
-| 3 | | | |
-
----
-
-## ✅ Ações Resultantes
-
-- [ ] Atualizar spec.md com clarificações
-- [ ] Adicionar edge cases identificados
-- [ ] Atualizar contracts.cs se necessário
-- [ ] Documentar decisões em decisions.md
-
----
-
-## 🎯 Status
-
-- **Total de perguntas:** _X_
-- **Perguntas respondidas:** _Y_
-- **Pendentes:** _Z_
-
-**Pronto para avançar para FASE 4: TASKS?** [ ] Sim [ ] Não
-
----
-
-_Gerado por MORPH-SPEC Framework_
+# Checklist de Clarificação - {{FEATURE_NAME_TITLE}}
+
+> Template para FASE 3: CLARIFY
+> Use este checklist para identificar ambiguidades e fazer perguntas estruturadas
+
+---
+
+## 🎯 Contexto da Feature
+
+**Feature:** {{FEATURE_NAME}}
+**Fase atual:** CLARIFY
+**Data:** {{DATE}}
+
+---
+
+## 📋 Checklist de Clarificação Padrão
+
+### 1. Fluxo de Usuário
+
+- [ ] Existe fluxo gratuito vs pago?
+- [ ] O que acontece em edge cases (erro, timeout, dados inválidos)?
+- [ ] Qual o fluxo de primeiro acesso (onboarding)?
+- [ ] Existem diferentes tipos de usuário com permissões diferentes?
+- [ ] O que acontece se o usuário cancelar no meio do processo?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta específica da feature]_
+2. _[Adicionar pergunta específica da feature]_
+
+---
+
+### 2. Integrações Externas
+
+- [ ] Quais campos são obrigatórios para cada API externa?
+- [ ] Há fallbacks se a API externa falhar?
+- [ ] Qual o timeout aceitável para chamadas externas?
+- [ ] Como tratar rate limiting?
+- [ ] Precisa de webhook para eventos da API?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre integração]_
+2. _[Adicionar pergunta sobre integração]_
+
+---
+
+### 3. Dados e Persistência
+
+- [ ] Qual a política de retenção de dados?
+- [ ] Precisa de soft delete ou hard delete?
+- [ ] Quais dados são sensíveis e precisam de criptografia?
+- [ ] Precisa de histórico/auditoria de alterações?
+- [ ] Qual o volume esperado de dados?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre dados]_
+2. _[Adicionar pergunta sobre dados]_
+
+---
+
+### 4. Performance e Escalabilidade
+
+- [ ] Qual o SLA esperado (tempo de resposta)?
+- [ ] Precisa de cache? Se sim, qual estratégia?
+- [ ] Quantos usuários simultâneos são esperados?
+- [ ] Existem operações que podem ser assíncronas?
+- [ ] Precisa de paginação para listas grandes?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre performance]_
+2. _[Adicionar pergunta sobre performance]_
+
+---
+
+### 5. Segurança e Autorização
+
+- [ ] Quem pode acessar esta funcionalidade?
+- [ ] Existem diferentes níveis de permissão?
+- [ ] Precisa de validação de ownership (usuário só vê seus dados)?
+- [ ] Existem dados que não devem ser expostos em logs?
+- [ ] Precisa de CAPTCHA ou proteção contra bots?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre segurança]_
+2. _[Adicionar pergunta sobre segurança]_
+
+---
+
+### 6. UI/UX (se aplicável)
+
+- [ ] Qual o estado inicial da tela (vazia, loading, dados)?
+- [ ] O que mostrar quando não há dados?
+- [ ] Quais mensagens de erro/sucesso exibir?
+- [ ] Precisa de confirmação antes de ações destrutivas?
+- [ ] Como tratar formulários muito longos (wizard, seções)?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre UI]_
+2. _[Adicionar pergunta sobre UI]_
+
+---
+
+### 7. Notificações e Comunicação
+
+- [ ] Precisa enviar email/SMS/push em algum momento?
+- [ ] Quais eventos disparam notificações?
+- [ ] O usuário pode configurar preferências de notificação?
+- [ ] Precisa de notificações em tempo real (SignalR)?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre notificações]_
+
+---
+
+### 8. Regras de Negócio
+
+- [ ] Existem validações específicas do domínio?
+- [ ] Existem limites (máximo de itens, tamanho de arquivo, etc)?
+- [ ] Existem estados/transições de status?
+- [ ] Existem cálculos ou fórmulas específicas?
+- [ ] Existem regras de agendamento (cron, jobs)?
+
+**Perguntas específicas:**
+1. _[Adicionar pergunta sobre regras de negócio]_
+2. _[Adicionar pergunta sobre regras de negócio]_
+
+---
+
+## 📝 Respostas Coletadas
+
+> Preencher com as respostas do usuário
+
+| # | Pergunta | Resposta | Impacto no Spec |
+|---|----------|----------|-----------------|
+| 1 | | | |
+| 2 | | | |
+| 3 | | | |
+
+---
+
+## ✅ Ações Resultantes
+
+- [ ] Atualizar spec.md com clarificações
+- [ ] Adicionar edge cases identificados
+- [ ] Atualizar contracts.cs se necessário
+- [ ] Documentar decisões em decisions.md
+
+---
+
+## 🎯 Status
+
+- **Total de perguntas:** _X_
+- **Perguntas respondidas:** _Y_
+- **Pendentes:** _Z_
+
+**Pronto para avançar para FASE 4: TASKS?** [ ] Sim [ ] Não
+
+---
+
+_Gerado por MORPH-SPEC Framework_