@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/docs/templates.md

@@ -0,0 +1,418 @@
+# MORPH-SPEC Templates Reference
+
+Documentação completa de todos os templates disponíveis.
+
+---
+
+## Feature Templates
+
+Templates para documentação de features.
+
+### spec.md
+Template de especificação técnica.
+
+**Localização**: `.morph/templates/spec.md`
+
+**Seções**:
+- Visão Geral
+- Requisitos Funcionais
+- Requisitos Não-Funcionais
+- Arquitetura
+- Modelo de Dados
+- APIs
+- Segurança
+
+### tasks.md
+Template de breakdown de tasks.
+
+**Localização**: `.morph/templates/tasks.md`
+
+**Estrutura**:
+```markdown
+| ID | Task | Dependências | Estimativa |
+|----|------|--------------|------------|
+| T001 | Descrição | - | S/M/L |
+```
+
+### contracts.cs
+Template de contratos (interfaces, DTOs).
+
+**Localização**: `.morph/templates/contracts.cs`
+
+**Inclui**:
+- Interfaces de serviço
+- DTOs de request/response
+- Enums
+- Interfaces de repositório
+
+### decisions.md
+Template de Architecture Decision Records.
+
+**Localização**: `.morph/templates/decisions.md`
+
+**Formato ADR**:
+```markdown
+## ADR-001: Título
+
+**Status**: Proposed | Accepted | Deprecated
+
+**Context**: Descrição do contexto
+
+**Decision**: A decisão tomada
+
+**Consequences**: Impactos positivos e negativos
+```
+
+### recap.md
+Template de resumo pós-implementação.
+
+**Localização**: `.morph/templates/recap.md`
+
+---
+
+## Code Templates
+
+Templates para geração de código.
+
+### component.razor
+Componente Blazor com parâmetros e lifecycle.
+
+**Localização**: `.morph/templates/component.razor`
+
+```razor
+@namespace {{Namespace}}.Components
+
+<div class="{{ComponentName | kebab-case}}">
+    @* Content *@
+</div>
+
+@code {
+    [Parameter] public string Title { get; set; }
+
+    protected override async Task OnInitializedAsync()
+    {
+        await base.OnInitializedAsync();
+    }
+}
+```
+
+### service.cs
+Serviço com injeção de dependência.
+
+**Localização**: `.morph/templates/service.cs`
+
+```csharp
+public interface I{{ServiceName}}Service
+{
+    Task<Result> ExecuteAsync(Request request, CancellationToken ct);
+}
+
+public class {{ServiceName}}Service : I{{ServiceName}}Service
+{
+    private readonly IRepository _repository;
+    private readonly ILogger<{{ServiceName}}Service> _logger;
+
+    public {{ServiceName}}Service(
+        IRepository repository,
+        ILogger<{{ServiceName}}Service> logger)
+    {
+        _repository = repository;
+        _logger = logger;
+    }
+}
+```
+
+### repository.cs
+Repositório EF Core.
+
+**Localização**: `.morph/templates/repository.cs`
+
+```csharp
+public interface I{{Entity}}Repository
+{
+    Task<{{Entity}}?> GetByIdAsync(int id, CancellationToken ct);
+    Task<IReadOnlyList<{{Entity}}>> GetAllAsync(CancellationToken ct);
+    Task AddAsync({{Entity}} entity, CancellationToken ct);
+    void Update({{Entity}} entity);
+    void Delete({{Entity}} entity);
+}
+```
+
+### test.cs
+Teste xUnit com FluentAssertions.
+
+**Localização**: `.morph/templates/test.cs`
+
+```csharp
+public class {{ServiceName}}ServiceTests
+{
+    private readonly Mock<IRepository> _repositoryMock;
+    private readonly {{ServiceName}}Service _sut;
+
+    public {{ServiceName}}ServiceTests()
+    {
+        _repositoryMock = new Mock<IRepository>();
+        _sut = new {{ServiceName}}Service(_repositoryMock.Object);
+    }
+
+    [Fact]
+    public async Task Method_Should_ReturnExpected_When_Condition()
+    {
+        // Arrange
+        // Act
+        // Assert
+    }
+}
+```
+
+### migration.cs
+Migration EF Core.
+
+**Localização**: `.morph/templates/migration.cs`
+
+### agent.cs
+Agente AI com Semantic Kernel.
+
+**Localização**: `.morph/templates/agent.cs`
+
+```csharp
+public class {{AgentName}}Agent
+{
+    private readonly Kernel _kernel;
+
+    [KernelFunction("function_name")]
+    [Description("Description of the function")]
+    public async Task<string> ExecuteAsync(
+        [Description("Parameter description")] string input)
+    {
+        // Implementation
+    }
+}
+```
+
+### job.cs
+Background job Hangfire.
+
+**Localização**: `.morph/templates/job.cs`
+
+```csharp
+public class {{JobName}}Job
+{
+    private readonly IService _service;
+    private readonly ILogger<{{JobName}}Job> _logger;
+
+    [AutomaticRetry(Attempts = 3)]
+    public async Task ExecuteAsync(JobParameters parameters)
+    {
+        _logger.LogInformation("Starting job {JobName}", nameof({{JobName}}Job));
+        // Implementation
+    }
+}
+```
+
+---
+
+## IaC Templates (Bicep)
+
+Templates de Infrastructure as Code.
+
+### main.bicep
+Entry point que compõe todos os módulos.
+
+**Localização**: `.morph/templates/infra/main.bicep`
+
+**Parâmetros**:
+- `appName` - Nome da aplicação
+- `environment` - dev/staging/prod
+- `location` - Região Azure
+
+**Módulos incluídos**:
+- Container App Environment
+- Container App
+- SQL Database
+- Storage Account
+- Key Vault
+- Application Insights
+
+### container-app.bicep
+Azure Container Apps com auto-scaling.
+
+**Localização**: `.morph/templates/infra/container-app.bicep`
+
+**Features**:
+- Scale-to-zero
+- HTTP auto-scaling
+- Health probes (liveness + readiness)
+- Environment variables
+- Secrets integration
+
+### container-app-env.bicep
+Managed Environment para Container Apps.
+
+**Localização**: `.morph/templates/infra/container-app-env.bicep`
+
+**Inclui**:
+- Log Analytics workspace
+- Internal/External ingress
+
+### sql-database.bicep
+Azure SQL Database.
+
+**Localização**: `.morph/templates/infra/sql-database.bicep`
+
+**Tiers suportados**:
+- Free (32GB) - Desenvolvimento
+- Basic - Produção pequena
+- Standard - Produção
+
+### storage.bicep
+Storage Account com containers.
+
+**Localização**: `.morph/templates/infra/storage.bicep`
+
+**Containers padrão**:
+- uploads
+- reports
+- backups
+
+### key-vault.bicep
+Azure Key Vault.
+
+**Localização**: `.morph/templates/infra/key-vault.bicep`
+
+**Features**:
+- RBAC authorization
+- Soft delete
+- Purge protection (prod)
+
+### app-insights.bicep
+Application Insights para monitoring.
+
+**Localização**: `.morph/templates/infra/app-insights.bicep`
+
+### parameters.dev.json / parameters.prod.json
+Parâmetros por ambiente.
+
+**Localização**: `.morph/templates/infra/parameters.*.json`
+
+---
+
+## Integration Templates
+
+Templates para integrações externas.
+
+### asaas-client.cs
+Cliente HTTP completo para Asaas.
+
+**Localização**: `.morph/templates/integrations/asaas-client.cs`
+
+**Endpoints**:
+- Customers (CRUD)
+- Payments (PIX, Boleto, Credit Card)
+- Subscriptions
+- Webhooks validation
+
+**Uso**:
+```csharp
+services.AddAsaasClient(options =>
+{
+    options.ApiKey = configuration["Asaas:ApiKey"];
+    options.Environment = AsaasEnvironment.Sandbox;
+});
+```
+
+### asaas-webhook.cs
+Controller para webhooks Asaas.
+
+**Localização**: `.morph/templates/integrations/asaas-webhook.cs`
+
+**Eventos suportados**:
+- PAYMENT_CREATED
+- PAYMENT_RECEIVED
+- PAYMENT_CONFIRMED
+- PAYMENT_OVERDUE
+- PAYMENT_REFUNDED
+- SUBSCRIPTION_*
+
+### clerk-config.cs
+Configuração de autenticação Clerk.
+
+**Localização**: `.morph/templates/integrations/clerk-config.cs`
+
+**Features**:
+- JWT validation
+- User claims
+- Middleware
+- Blazor integration
+
+### azure-identity-config.cs
+Microsoft Identity Platform.
+
+**Localização**: `.morph/templates/integrations/azure-identity-config.cs`
+
+**Modos**:
+- Web App (OpenID Connect)
+- API (JWT Bearer)
+- Blazor Server
+- Downstream APIs (Graph)
+
+---
+
+## SaaS Templates
+
+Templates para aplicações SaaS.
+
+### subscription.cs
+Modelo completo de assinaturas.
+
+**Localização**: `.morph/templates/saas/subscription.cs`
+
+**Entidades**:
+- `Plan` - Planos com limites e features
+- `Subscription` - Assinatura do tenant
+- `SubscriptionPayment` - Histórico de pagamentos
+
+**Features**:
+- Ciclos mensais e anuais
+- Trial period
+- Status machine (Trial → Active → PastDue → Canceled)
+- Integração Asaas
+
+### tenant.cs
+Multi-tenancy completo.
+
+**Localização**: `.morph/templates/saas/tenant.cs`
+
+**Entidades**:
+- `Tenant` - Organização
+- `TenantUser` - Usuários do tenant
+
+**Features**:
+- Múltiplas estratégias de resolução:
+  - Subdomínio (`acme.app.com`)
+  - Header (`X-Tenant-ID`)
+  - Route (`/tenant/{slug}`)
+  - Claim (JWT)
+- EF Core query filters
+- Status management
+
+---
+
+## Como Usar
+
+### 1. Copiar Template
+Os templates são automaticamente aplicados pelo MORPH durante `/morph-apply`.
+
+### 2. Substituir Placeholders
+Placeholders comuns:
+- `{{Namespace}}` - Namespace do projeto
+- `{{ServiceName}}` - Nome do serviço
+- `{{Entity}}` - Nome da entidade
+- `{{ComponentName}}` - Nome do componente
+
+### 3. Customizar
+Edite os templates em `.morph/templates/` para seu estilo.
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/docs/validation-checklist.md

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