@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

package/docs/validation-checklist.md

@@ -1,266 +1,265 @@
-# MORPH-SPEC Validation Checklist
-
-Checklist para validar o framework em um projeto real.
-
----
-
-## 1. Setup Validation
-
-### 1.1 Instalação
-- [ ] Script `setup.ps1` ou `setup.sh` executa sem erros
-- [ ] Pasta `.morph` criada corretamente
-- [ ] Pasta `.claude` criada corretamente
-- [ ] `CLAUDE.md` copiado para raiz do projeto
-- [ ] Pasta `infra` criada com templates Bicep
-
-### 1.2 Configuração
-- [ ] `config.json` criado a partir do template
-- [ ] Nome do projeto configurado
-- [ ] Stack selecionada (blazor/nextjs/shopify)
-- [ ] Azure subscription configurada (se aplicável)
-
-### 1.3 Estrutura de Arquivos
-- [ ] `.morph/standards/` contém 3 arquivos (coding, architecture, azure)
-- [ ] `.morph/templates/` contém todos os templates
-- [ ] `.morph/templates/infra/` contém 9 arquivos Bicep
-- [ ] `.morph/templates/integrations/` contém 4 arquivos
-- [ ] `.morph/templates/saas/` contém 2 arquivos
-- [ ] `.morph/examples/` contém 3 exemplos
-- [ ] `.claude/commands/` contém 6 comandos
-- [ ] `.claude/skills/` contém 17 skills
-
----
-
-## 2. Slash Commands Validation
-
-### 2.1 /morph-proposal
-- [ ] Comando reconhecido pelo Claude Code
-- [ ] Carrega contexto do projeto
-- [ ] Identifica agentes por keywords
-- [ ] Gera `spec.md` na pasta correta
-- [ ] Gera `contracts.cs` com interfaces/DTOs
-- [ ] Gera `decisions.md` com ADRs
-- [ ] Para e aguarda aprovação
-
-### 2.2 /morph-apply
-- [ ] Comando reconhecido pelo Claude Code
-- [ ] Carrega spec existente
-- [ ] Quebra em tasks
-- [ ] Implementa task por task
-- [ ] Executa testes
-- [ ] Faz checkpoints a cada 3 tasks
-- [ ] Gera `recap.md` ao final
-
-### 2.3 /morph-status
-- [ ] Mostra features em andamento
-- [ ] Mostra fase atual de cada feature
-- [ ] Lista agentes ativos
-
-### 2.4 /morph-infra
-- [ ] `init` cria estrutura de infra
-- [ ] `validate` valida templates Bicep
-- [ ] `plan` mostra recursos que serão criados
-
-### 2.5 /morph-costs
-- [ ] Estima custos dos recursos
-- [ ] Mostra free tier vs paid
-- [ ] Alerta sobre custos acima do limite
-
-### 2.6 /morph-archive
-- [ ] Move feature para archive
-- [ ] Atualiza status
-
----
-
-## 3. Agent Activation Validation
-
-### 3.1 Core Agents (Sempre Ativos)
-- [ ] Standards Architect ativado em todas as features
-- [ ] Azure Architect ativado quando há infra
-- [ ] Cost Guardian monitora custos
-
-### 3.2 Stack Agents
-| Keyword | Agente Esperado | Status |
-|---------|-----------------|--------|
-| "blazor", "razor" | Blazor Builder | [ ] |
-| "nextjs", "react" | NextJS Expert | [ ] |
-| "shopify", "hydrogen" | Shopify Expert | [ ] |
-
-### 3.3 Specialist Agents
-| Keyword | Agente Esperado | Status |
-|---------|-----------------|--------|
-| "database", "entity" | EF Modeler | [ ] |
-| "agent", "ai" | MS Agent Expert | [ ] |
-| "scheduled", "job" | Hangfire Orchestrator | [ ] |
-| "wizard", "dashboard" | UI/UX Designer | [ ] |
-| "unclear", "requirements" | PO/PM Advisor | [ ] |
-
-### 3.4 Integration Agents
-| Keyword | Agente Esperado | Status |
-|---------|-----------------|--------|
-| "asaas", "pix", "boleto" | Asaas Financial | [ ] |
-| "clerk", "auth" | Clerk Auth | [ ] |
-| "identity", "entra" | Azure Identity | [ ] |
-
-### 3.5 Infra Agents
-| Keyword | Agente Esperado | Status |
-|---------|-----------------|--------|
-| "bicep", "iac" | Bicep Architect | [ ] |
-| "pipeline", "ci/cd" | DevOps Engineer | [ ] |
-| "container", "docker" | Container Specialist | [ ] |
-
----
-
-## 4. Templates Validation
-
-### 4.1 Feature Templates
-- [ ] `spec.md` template funciona
-- [ ] `tasks.md` template funciona
-- [ ] `contracts.cs` template funciona
-- [ ] `decisions.md` template funciona
-- [ ] `recap.md` template funciona
-
-### 4.2 Code Templates
-- [ ] `component.razor` compila
-- [ ] `service.cs` compila
-- [ ] `repository.cs` compila
-- [ ] `test.cs` compila
-- [ ] `migration.cs` compila
-- [ ] `agent.cs` compila
-- [ ] `job.cs` compila
-
-### 4.3 IaC Templates
-- [ ] `main.bicep` valida (`az bicep build`)
-- [ ] `container-app.bicep` valida
-- [ ] `container-app-env.bicep` valida
-- [ ] `sql-database.bicep` valida
-- [ ] `storage.bicep` valida
-- [ ] `key-vault.bicep` valida
-- [ ] `app-insights.bicep` valida
-
-### 4.4 Integration Templates
-- [ ] `asaas-client.cs` compila
-- [ ] `asaas-webhook.cs` compila
-- [ ] `clerk-config.cs` compila
-- [ ] `azure-identity-config.cs` compila
-
-### 4.5 SaaS Templates
-- [ ] `subscription.cs` compila
-- [ ] `tenant.cs` compila
-
----
-
-## 5. Workflow Validation
-
-### 5.1 Fase 1: SETUP
-- [ ] Carrega `.morph/project.md`
-- [ ] Carrega `.morph/config/config.json`
-- [ ] Identifica stack do projeto
-- [ ] Cria pasta em `.morph/features/<feature>`
-
-### 5.2 Fase 2: DESIGN
-- [ ] Gera spec baseado na descrição
-- [ ] Consulta `.morph/standards/` para padrões
-- [ ] Gera contracts.cs com DTOs corretos
-- [ ] Estima custos e documenta
-- [ ] PARA para aprovação
-
-### 5.3 Fase 3: CLARIFY
-- [ ] Identifica ambiguidades
-- [ ] Faz perguntas relevantes
-- [ ] Atualiza spec com respostas
-
-### 5.4 Fase 4: TASKS
-- [ ] Quebra spec em tasks numeradas
-- [ ] Define dependências entre tasks
-- [ ] Estabelece checkpoints
-- [ ] PARA para aprovação
-
-### 5.5 Fase 5: IMPLEMENT
-- [ ] Implementa tasks na ordem
-- [ ] Segue padrões de `coding.md`
-- [ ] Executa testes após cada task
-- [ ] Faz checkpoint a cada 3 tasks
-- [ ] Gera recap ao final
-
----
-
-## 6. Cost Validation
-
-### 6.1 Limites
-- [ ] Alerta quando recurso ultrapassa free tier
-- [ ] Bloqueia recursos > $10/mês sem aprovação
-- [ ] Requer ADR para recursos > $10/mês
-
-### 6.2 Estimativas
-- [ ] Container Apps: $0 (scale-to-zero)
-- [ ] SQL Database: $0 (Free tier 32GB)
-- [ ] Storage: < $1/mês
-- [ ] App Insights: $0 (5GB free)
-
----
-
-## 7. End-to-End Test
-
-### 7.1 Cenário: Feature Simples
-```
-/morph-proposal user-profile
-Descrição: "Adicionar página de perfil do usuário com edição de dados"
-```
-
-**Esperado**:
-- [ ] Ativa: Standards Architect, Blazor Builder, EF Modeler
-- [ ] Gera spec com requisitos de perfil
-- [ ] Gera contracts com UserProfileDto
-- [ ] Tasks incluem: criar entity, criar service, criar página
-
-### 7.2 Cenário: Feature com Pagamento
-```
-/morph-proposal subscription-billing
-Descrição: "Implementar cobrança de assinaturas com Asaas, PIX e boleto"
-```
-
-**Esperado**:
-- [ ] Ativa: Asaas Financial, Cost Guardian
-- [ ] Consulta skill `asaas-financial.md`
-- [ ] Usa template `asaas-client.cs`
-- [ ] Usa template `subscription.cs`
-
-### 7.3 Cenário: Feature com Infra
-```
-/morph-proposal deploy-production
-Descrição: "Configurar deploy para produção com Container Apps e SQL"
-```
-
-**Esperado**:
-- [ ] Ativa: Bicep Architect, Container Specialist, Azure Architect
-- [ ] Usa templates de `infra/`
-- [ ] Estima custos
-- [ ] Gera `parameters.prod.json`
-
----
-
-## 8. Issues Found
-
-| # | Descrição | Severidade | Status |
-|---|-----------|------------|--------|
-| 1 | | | |
-| 2 | | | |
-| 3 | | | |
-
----
-
-## 9. Sign-off
-
-| Item | Responsável | Data | Status |
-|------|-------------|------|--------|
-| Setup | | | [ ] |
-| Commands | | | [ ] |
-| Agents | | | [ ] |
-| Templates | | | [ ] |
-| Workflow | | | [ ] |
-| E2E Tests | | | [ ] |
-
----
-
-*MORPH-SPEC by Polymorphism Tech*
+# MORPH-SPEC Validation Checklist
+
+Checklist para validar o framework em um projeto real.
+
+---
+
+## 1. Setup Validation
+
+### 1.1 Instalação
+- [ ] Script `setup.ps1` ou `setup.sh` executa sem erros
+- [ ] Pasta `.morph` criada corretamente
+- [ ] Pasta `.claude` criada corretamente
+- [ ] `CLAUDE.md` copiado para raiz do projeto
+- [ ] Pasta `infra` criada com templates Bicep
+
+### 1.2 Configuração
+- [ ] `config.json` criado a partir do template
+- [ ] Nome do projeto configurado
+- [ ] Stack selecionada (blazor/nextjs)
+- [ ] Azure subscription configurada (se aplicável)
+
+### 1.3 Estrutura de Arquivos
+- [ ] `.morph/standards/` contém 3 arquivos (coding, architecture, azure)
+- [ ] `.morph/templates/` contém todos os templates
+- [ ] `.morph/templates/infra/` contém 9 arquivos Bicep
+- [ ] `.morph/templates/integrations/` contém 4 arquivos
+- [ ] `.morph/templates/saas/` contém 2 arquivos
+- [ ] `.morph/examples/` contém 3 exemplos
+- [ ] `.claude/commands/` contém 6 comandos
+- [ ] `.claude/skills/` contém 17 skills
+
+---
+
+## 2. Slash Commands Validation
+
+### 2.1 /morph-proposal
+- [ ] Comando reconhecido pelo Claude Code
+- [ ] Carrega contexto do projeto
+- [ ] Identifica agentes por keywords
+- [ ] Gera `spec.md` na pasta correta
+- [ ] Gera `contracts.cs` com interfaces/DTOs
+- [ ] Gera `decisions.md` com ADRs
+- [ ] Para e aguarda aprovação
+
+### 2.2 /morph-apply
+- [ ] Comando reconhecido pelo Claude Code
+- [ ] Carrega spec existente
+- [ ] Quebra em tasks
+- [ ] Implementa task por task
+- [ ] Executa testes
+- [ ] Faz checkpoints a cada 3 tasks
+- [ ] Gera `recap.md` ao final
+
+### 2.3 /morph-status
+- [ ] Mostra features em andamento
+- [ ] Mostra fase atual de cada feature
+- [ ] Lista agentes ativos
+
+### 2.4 /morph-infra
+- [ ] `init` cria estrutura de infra
+- [ ] `validate` valida templates Bicep
+- [ ] `plan` mostra recursos que serão criados
+
+### 2.5 /morph-costs
+- [ ] Estima custos dos recursos
+- [ ] Mostra free tier vs paid
+- [ ] Alerta sobre custos acima do limite
+
+### 2.6 /morph-archive
+- [ ] Move feature para archive
+- [ ] Atualiza status
+
+---
+
+## 3. Agent Activation Validation
+
+### 3.1 Core Agents (Sempre Ativos)
+- [ ] Standards Architect ativado em todas as features
+- [ ] Azure Architect ativado quando há infra
+- [ ] Cost Guardian monitora custos
+
+### 3.2 Stack Agents
+| Keyword | Agente Esperado | Status |
+|---------|-----------------|--------|
+| "blazor", "razor" | Blazor Builder | [ ] |
+| "nextjs", "react" | NextJS Expert | [ ] |
+
+### 3.3 Specialist Agents
+| Keyword | Agente Esperado | Status |
+|---------|-----------------|--------|
+| "database", "entity" | EF Modeler | [ ] |
+| "agent", "ai" | MS Agent Expert | [ ] |
+| "scheduled", "job" | Hangfire Orchestrator | [ ] |
+| "wizard", "dashboard" | UI/UX Designer | [ ] |
+| "unclear", "requirements" | PO/PM Advisor | [ ] |
+
+### 3.4 Integration Agents
+| Keyword | Agente Esperado | Status |
+|---------|-----------------|--------|
+| "asaas", "pix", "boleto" | Asaas Financial | [ ] |
+| "clerk", "auth" | Clerk Auth | [ ] |
+| "identity", "entra" | Azure Identity | [ ] |
+
+### 3.5 Infra Agents
+| Keyword | Agente Esperado | Status |
+|---------|-----------------|--------|
+| "bicep", "iac" | Bicep Architect | [ ] |
+| "pipeline", "ci/cd" | DevOps Engineer | [ ] |
+| "container", "docker" | Container Specialist | [ ] |
+
+---
+
+## 4. Templates Validation
+
+### 4.1 Feature Templates
+- [ ] `spec.md` template funciona
+- [ ] `tasks.md` template funciona
+- [ ] `contracts.cs` template funciona
+- [ ] `decisions.md` template funciona
+- [ ] `recap.md` template funciona
+
+### 4.2 Code Templates
+- [ ] `component.razor` compila
+- [ ] `service.cs` compila
+- [ ] `repository.cs` compila
+- [ ] `test.cs` compila
+- [ ] `migration.cs` compila
+- [ ] `agent.cs` compila
+- [ ] `job.cs` compila
+
+### 4.3 IaC Templates
+- [ ] `main.bicep` valida (`az bicep build`)
+- [ ] `container-app.bicep` valida
+- [ ] `container-app-env.bicep` valida
+- [ ] `sql-database.bicep` valida
+- [ ] `storage.bicep` valida
+- [ ] `key-vault.bicep` valida
+- [ ] `app-insights.bicep` valida
+
+### 4.4 Integration Templates
+- [ ] `asaas-client.cs` compila
+- [ ] `asaas-webhook.cs` compila
+- [ ] `clerk-config.cs` compila
+- [ ] `azure-identity-config.cs` compila
+
+### 4.5 SaaS Templates
+- [ ] `subscription.cs` compila
+- [ ] `tenant.cs` compila
+
+---
+
+## 5. Workflow Validation
+
+### 5.1 Fase 1: SETUP
+- [ ] Carrega `.morph/project.md`
+- [ ] Carrega `.morph/config/config.json`
+- [ ] Identifica stack do projeto
+- [ ] Cria pasta em `.morph/features/<feature>`
+
+### 5.2 Fase 2: DESIGN
+- [ ] Gera spec baseado na descrição
+- [ ] Consulta `.morph/standards/` para padrões
+- [ ] Gera contracts.cs com DTOs corretos
+- [ ] Estima custos e documenta
+- [ ] PARA para aprovação
+
+### 5.3 Fase 3: CLARIFY
+- [ ] Identifica ambiguidades
+- [ ] Faz perguntas relevantes
+- [ ] Atualiza spec com respostas
+
+### 5.4 Fase 4: TASKS
+- [ ] Quebra spec em tasks numeradas
+- [ ] Define dependências entre tasks
+- [ ] Estabelece checkpoints
+- [ ] PARA para aprovação
+
+### 5.5 Fase 5: IMPLEMENT
+- [ ] Implementa tasks na ordem
+- [ ] Segue padrões de `coding.md`
+- [ ] Executa testes após cada task
+- [ ] Faz checkpoint a cada 3 tasks
+- [ ] Gera recap ao final
+
+---
+
+## 6. Cost Validation
+
+### 6.1 Limites
+- [ ] Alerta quando recurso ultrapassa free tier
+- [ ] Bloqueia recursos > $10/mês sem aprovação
+- [ ] Requer ADR para recursos > $10/mês
+
+### 6.2 Estimativas
+- [ ] Container Apps: $0 (scale-to-zero)
+- [ ] SQL Database: $0 (Free tier 32GB)
+- [ ] Storage: < $1/mês
+- [ ] App Insights: $0 (5GB free)
+
+---
+
+## 7. End-to-End Test
+
+### 7.1 Cenário: Feature Simples
+```
+/morph-proposal user-profile
+Descrição: "Adicionar página de perfil do usuário com edição de dados"
+```
+
+**Esperado**:
+- [ ] Ativa: Standards Architect, Blazor Builder, EF Modeler
+- [ ] Gera spec com requisitos de perfil
+- [ ] Gera contracts com UserProfileDto
+- [ ] Tasks incluem: criar entity, criar service, criar página
+
+### 7.2 Cenário: Feature com Pagamento
+```
+/morph-proposal subscription-billing
+Descrição: "Implementar cobrança de assinaturas com Asaas, PIX e boleto"
+```
+
+**Esperado**:
+- [ ] Ativa: Asaas Financial, Cost Guardian
+- [ ] Consulta skill `asaas-financial.md`
+- [ ] Usa template `asaas-client.cs`
+- [ ] Usa template `subscription.cs`
+
+### 7.3 Cenário: Feature com Infra
+```
+/morph-proposal deploy-production
+Descrição: "Configurar deploy para produção com Container Apps e SQL"
+```
+
+**Esperado**:
+- [ ] Ativa: Bicep Architect, Container Specialist, Azure Architect
+- [ ] Usa templates de `infra/`
+- [ ] Estima custos
+- [ ] Gera `parameters.prod.json`
+
+---
+
+## 8. Issues Found
+
+| # | Descrição | Severidade | Status |
+|---|-----------|------------|--------|
+| 1 | | | |
+| 2 | | | |
+| 3 | | | |
+
+---
+
+## 9. Sign-off
+
+| Item | Responsável | Data | Status |
+|------|-------------|------|--------|
+| Setup | | | [ ] |
+| Commands | | | [ ] |
+| Agents | | | [ ] |
+| Templates | | | [ ] |
+| Workflow | | | [ ] |
+| E2E Tests | | | [ ] |
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*