@polymorphism-tech/morph-spec 1.0.0

package/content/.claude/skills/integrations/clerk-auth.md

@@ -0,0 +1,290 @@
+# Clerk Auth
+
+Especialista em autenticação com Clerk para aplicações .NET/Blazor.
+
+## Responsabilidades
+
+1. **Configurar Clerk** em projetos .NET
+2. **Implementar autenticação** com SDK oficial
+3. **Gerenciar sessões** e tokens
+4. **Proteger endpoints** e páginas
+
+## Triggers
+
+Keywords: `clerk`, `auth`, `login`, `signup`, `authentication`, `session`, `jwt`, `user`
+
+## Sobre o Clerk
+
+- **Plataforma de autenticação** SaaS moderna
+- **SDK oficial C#** lançado em Janeiro/2025
+- **Suporta**: Email/senha, Social login, MFA, Passkeys
+- **Dashboard** para gerenciar usuários
+- **Ideal para**: SaaS B2C, MVPs rápidos
+
+## Instalação
+
+```bash
+dotnet add package Clerk.Net.AspNetCore.Security
+```
+
+## Configuração Básica
+
+```csharp
+// appsettings.json
+{
+  "Clerk": {
+    "SecretKey": "${CLERK_SECRET_KEY}",
+    "PublishableKey": "pk_test_xxx"  // Para frontend
+  }
+}
+
+// Program.cs
+builder.Services.AddClerk(builder.Configuration);
+
+// Ou manualmente
+builder.Services.AddClerk(options =>
+{
+    options.SecretKey = builder.Configuration["Clerk:SecretKey"]!;
+});
+
+// Adicionar autenticação
+builder.Services.AddAuthentication(ClerkAuthenticationDefaults.AuthenticationScheme)
+    .AddClerk(options =>
+    {
+        options.Authority = "https://clerk.{your-instance}.com";
+        options.ValidAudiences = new[] { "your-app-id" };
+    });
+
+builder.Services.AddAuthorization();
+
+// Pipeline
+app.UseAuthentication();
+app.UseAuthorization();
+```
+
+## Proteger Endpoints (Minimal API)
+
+```csharp
+// Endpoint protegido
+app.MapGet("/api/profile", async (ClaimsPrincipal user, IClerkClient clerk) =>
+{
+    var userId = user.FindFirstValue(ClaimTypes.NameIdentifier);
+
+    if (userId is null)
+        return Results.Unauthorized();
+
+    var clerkUser = await clerk.Users.GetUserAsync(userId);
+
+    return Results.Ok(new
+    {
+        Id = clerkUser.Id,
+        Email = clerkUser.EmailAddresses.FirstOrDefault()?.EmailAddress,
+        Name = $"{clerkUser.FirstName} {clerkUser.LastName}"
+    });
+})
+.RequireAuthorization();
+
+// Endpoint público
+app.MapGet("/api/public", () => "Hello World!")
+    .AllowAnonymous();
+```
+
+## Proteger Endpoints (Controllers)
+
+```csharp
+[ApiController]
+[Route("api/[controller]")]
+[Authorize]  // Requer autenticação
+public class ProfileController : ControllerBase
+{
+    private readonly IClerkClient _clerk;
+
+    public ProfileController(IClerkClient clerk)
+    {
+        _clerk = clerk;
+    }
+
+    [HttpGet]
+    public async Task<IActionResult> GetProfile()
+    {
+        var userId = User.FindFirstValue(ClaimTypes.NameIdentifier);
+
+        if (userId is null)
+            return Unauthorized();
+
+        var user = await _clerk.Users.GetUserAsync(userId);
+
+        return Ok(new
+        {
+            user.Id,
+            Email = user.EmailAddresses.FirstOrDefault()?.EmailAddress,
+            Name = $"{user.FirstName} {user.LastName}"
+        });
+    }
+
+    [HttpGet("admin")]
+    [Authorize(Roles = "admin")]  // Requer role admin
+    public IActionResult AdminOnly()
+    {
+        return Ok("Admin access granted");
+    }
+}
+```
+
+## Blazor Server
+
+```csharp
+// Program.cs
+builder.Services.AddClerk(builder.Configuration);
+builder.Services.AddAuthentication(ClerkAuthenticationDefaults.AuthenticationScheme)
+    .AddClerk();
+
+// App.razor
+<CascadingAuthenticationState>
+    <Router AppAssembly="@typeof(App).Assembly">
+        <Found Context="routeData">
+            <AuthorizeRouteView RouteData="@routeData" DefaultLayout="@typeof(MainLayout)">
+                <NotAuthorized>
+                    <RedirectToLogin />
+                </NotAuthorized>
+            </AuthorizeRouteView>
+        </Found>
+    </Router>
+</CascadingAuthenticationState>
+
+// Components/RedirectToLogin.razor
+@inject NavigationManager Navigation
+
+@code {
+    protected override void OnInitialized()
+    {
+        Navigation.NavigateTo($"/sign-in?redirect_url={Uri.EscapeDataString(Navigation.Uri)}", forceLoad: true);
+    }
+}
+```
+
+## Páginas Protegidas
+
+```razor
+@* Pages/Dashboard.razor *@
+@page "/dashboard"
+@attribute [Authorize]
+
+<h1>Dashboard</h1>
+
+<AuthorizeView>
+    <Authorized>
+        <p>Bem-vindo, @context.User.Identity?.Name!</p>
+    </Authorized>
+</AuthorizeView>
+
+@* Verificar role específica *@
+<AuthorizeView Roles="admin">
+    <Authorized>
+        <AdminPanel />
+    </Authorized>
+    <NotAuthorized>
+        <p>Acesso restrito a administradores.</p>
+    </NotAuthorized>
+</AuthorizeView>
+```
+
+## Clerk Client para Operações
+
+```csharp
+// Buscar usuário
+var user = await _clerk.Users.GetUserAsync(userId);
+
+// Listar usuários
+var users = await _clerk.Users.GetUserListAsync(new()
+{
+    Limit = 10,
+    Offset = 0
+});
+
+// Atualizar metadata
+await _clerk.Users.UpdateUserMetadataAsync(userId, new()
+{
+    PublicMetadata = new Dictionary<string, object>
+    {
+        ["plan"] = "pro",
+        ["company"] = "Acme Inc"
+    }
+});
+
+// Deletar usuário
+await _clerk.Users.DeleteUserAsync(userId);
+```
+
+## Webhooks
+
+```csharp
+// Controllers/ClerkWebhookController.cs
+[ApiController]
+[Route("api/webhooks/clerk")]
+public class ClerkWebhookController : ControllerBase
+{
+    private readonly IUserService _userService;
+
+    public ClerkWebhookController(IUserService userService)
+    {
+        _userService = userService;
+    }
+
+    [HttpPost]
+    public async Task<IActionResult> HandleWebhook([FromBody] ClerkWebhookPayload payload)
+    {
+        // Verificar signature (importante em produção!)
+
+        switch (payload.Type)
+        {
+            case "user.created":
+                await _userService.SyncUserAsync(payload.Data);
+                break;
+
+            case "user.updated":
+                await _userService.UpdateUserAsync(payload.Data);
+                break;
+
+            case "user.deleted":
+                await _userService.DeleteUserAsync(payload.Data.Id);
+                break;
+        }
+
+        return Ok();
+    }
+}
+```
+
+## Clerk vs Azure Identity
+
+| Aspecto | Clerk | Azure Identity |
+|---------|-------|----------------|
+| **Setup** | Mais rápido | Mais complexo |
+| **Custo** | Freemium (5k MAU grátis) | Grátis (Azure AD) |
+| **Multi-tenant** | Built-in | Requer config |
+| **Social login** | 20+ providers | Limitado |
+| **UI components** | Pré-construídos | Precisa criar |
+| **Ideal para** | SaaS B2C | Enterprise/Azure |
+
+## Documentação de Referência
+
+- [Clerk C# SDK](https://clerk.com/changelog/2025-01-09-csharp-sdk)
+- [Clerk.Net GitHub](https://github.com/Hawxy/Clerk.Net)
+- [Clerk Documentation](https://clerk.com/docs)
+- [Webhooks](https://clerk.com/docs/integrations/webhooks)
+
+## Checklist de Integração
+
+- [ ] Secret Key no Key Vault (não hardcoded)
+- [ ] Publishable Key para frontend
+- [ ] Authentication scheme configurado
+- [ ] Authorization policies definidas
+- [ ] Webhook endpoint para sync de usuários
+- [ ] Verificação de webhook signature
+- [ ] Redirect após login configurado
+- [ ] Error handling para sessões expiradas
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/content/.claude/skills/specialists/azure-architect.md

@@ -0,0 +1,142 @@
+# Azure Architect
+
+Especialista em infraestrutura Azure com foco em Infrastructure as Code (Bicep).
+
+## Responsabilidades
+
+1. **Desenhar infraestrutura Azure** para projetos
+2. **Criar templates Bicep** para provisionar recursos
+3. **Estimar custos** antes de aprovar recursos
+4. **Garantir zero portal** - tudo via código
+
+## Triggers
+
+Ativado automaticamente em todo projeto MORPH-SPEC (Core Agent).
+
+Keywords: `azure`, `infrastructure`, `bicep`, `deploy`, `container apps`, `sql`, `storage`, `provision`
+
+## Princípio: Zero Portal
+
+> **NUNCA** criar recursos Azure manualmente no portal. Tudo via Bicep.
+
+## Estrutura IaC
+
+```
+infra/
+├── main.bicep                # Entry point
+├── parameters.dev.json       # Ambiente dev
+├── parameters.prod.json      # Ambiente prod
+└── modules/
+    ├── container-app.bicep   # Container Apps
+    ├── sql-database.bicep    # Azure SQL
+    ├── storage.bicep         # Storage Account
+    ├── key-vault.bicep       # Key Vault
+    ├── app-insights.bicep    # Monitoring
+    └── service-bus.bicep     # Mensageria
+```
+
+## Template Bicep Base
+
+```bicep
+// infra/main.bicep
+targetScope = 'resourceGroup'
+
+@description('Environment name')
+param environment string = 'dev'
+
+@description('Location for resources')
+param location string = resourceGroup().location
+
+@description('Application name')
+param appName string
+
+// Variables
+var resourcePrefix = '${appName}-${environment}'
+
+// Container App Environment
+module containerAppEnv 'modules/container-app-env.bicep' = {
+  name: 'containerAppEnv'
+  params: {
+    name: '${resourcePrefix}-env'
+    location: location
+  }
+}
+
+// Container App
+module containerApp 'modules/container-app.bicep' = {
+  name: 'containerApp'
+  params: {
+    name: resourcePrefix
+    location: location
+    environmentId: containerAppEnv.outputs.id
+  }
+}
+```
+
+## Recursos Recomendados por Tier
+
+### Free Tier (Sem aprovação)
+
+| Recurso | Config | Custo |
+|---------|--------|-------|
+| Azure SQL | Free 32GB | $0 |
+| Container Apps | Scale to zero | ~$0 |
+| Storage | LRS 5GB | ~$0 |
+| App Insights | Free tier | $0 |
+
+### Basic Tier (Até $10/mês)
+
+| Recurso | Config | Custo |
+|---------|--------|-------|
+| Azure SQL | Basic DTU | ~$5 |
+| Service Bus | Basic | ~$0.05 |
+| Key Vault | Standard | ~$0.03 |
+
+## Comandos de Deploy
+
+```powershell
+# Criar resource group
+az group create --name rg-{app}-{env} --location brazilsouth
+
+# Deploy com Bicep
+az deployment group create \
+  --resource-group rg-{app}-{env} \
+  --template-file infra/main.bicep \
+  --parameters @infra/parameters.{env}.json
+
+# Validar antes de deploy
+az deployment group what-if \
+  --resource-group rg-{app}-{env} \
+  --template-file infra/main.bicep \
+  --parameters @infra/parameters.{env}.json
+```
+
+## Quando usar SDK .NET vs Bicep
+
+| Recurso | Abordagem | Motivo |
+|---------|-----------|--------|
+| SQL, Storage, Container Apps | Bicep | Infra estática, declarativa |
+| Azure AI, Fabric | SDK .NET | Recursos dinâmicos, runtime |
+| Secrets | Key Vault + Bicep | Segurança |
+
+## Documentação de Referência
+
+- [Azure Bicep](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/)
+- [Container Apps](https://learn.microsoft.com/en-us/azure/container-apps/)
+- [Azure SQL](https://learn.microsoft.com/en-us/azure/azure-sql/)
+- [Azure SDK for .NET](https://learn.microsoft.com/en-us/dotnet/azure/)
+- [Pricing Calculator](https://azure.microsoft.com/en-us/pricing/calculator/)
+
+## Checklist de Infraestrutura
+
+- [ ] Bicep válido (`az bicep build`)
+- [ ] Parâmetros para dev e prod
+- [ ] Custos estimados e documentados
+- [ ] Secrets no Key Vault (não hardcoded)
+- [ ] Logs configurados (App Insights)
+- [ ] Scale-to-zero onde possível
+- [ ] Naming convention consistente
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/content/.claude/skills/specialists/cost-guardian.md

@@ -0,0 +1,110 @@
+# Cost Guardian
+
+Guardião de custos para garantir que recursos Azure sejam cost-effective e aprovados.
+
+## Responsabilidades
+
+1. **Validar custos** de cada recurso proposto
+2. **Alertar** sobre recursos caros ou desnecessários
+3. **Bloquear** recursos não aprovados
+4. **Recomendar** alternativas free/low-cost
+
+## Triggers
+
+Ativado automaticamente em todo projeto MORPH-SPEC (Core Agent).
+
+Keywords: `cost`, `budget`, `pricing`, `expensive`, `free tier`, `optimize`
+
+## Limites de Custo
+
+| Nível | Limite Mensal | Requisito |
+|-------|---------------|-----------|
+| **Sem aprovação** | Free tier apenas | Nenhum |
+| **Com aprovação** | Até $10/mês | Confirmação do usuário |
+| **Acima de $10** | Justificativa detalhada | ADR documentado |
+
+## Recursos Free Tier (Sempre Aprovados)
+
+| Recurso | Limite Free | Notas |
+|---------|-------------|-------|
+| Azure SQL | 32GB, S0 | Suficiente para MVP |
+| Container Apps | Scale-to-zero | Paga só quando usa |
+| Storage | 5GB LRS | Blobs, Tables |
+| App Insights | 5GB/mês logs | Monitoring básico |
+| Functions | 1M exec/mês | Serverless |
+| Cosmos DB | 1000 RU/s | 25GB grátis |
+
+## Recursos que Requerem Aprovação
+
+| Recurso | Custo Estimado | Quando Usar |
+|---------|----------------|-------------|
+| Azure SQL Basic | ~$5/mês | Performance melhor |
+| Service Bus Basic | ~$0.05/msg | Mensageria |
+| Redis Cache | ~$15/mês | Cache distribuído |
+| VM B1s | ~$7/mês | Workloads específicos |
+
+## Recursos Bloqueados (Sem Justificativa)
+
+| Recurso | Custo | Alternativa |
+|---------|-------|-------------|
+| Premium Storage | >$20/mês | Standard LRS |
+| Dedicated SQL | >$100/mês | Azure SQL Basic |
+| AKS | >$50/mês | Container Apps |
+| Synapse | >$100/mês | SQL + Scripts |
+
+## Template de Estimativa de Custos
+
+```markdown
+## Estimativa de Custos - {Feature}
+
+### Recursos Necessários
+
+| Recurso | SKU | Custo/Mês | Justificativa |
+|---------|-----|-----------|---------------|
+| Container Apps | Consumption | ~$0 | Scale-to-zero |
+| Azure SQL | Free 32GB | $0 | Dentro do limite |
+| Storage | LRS 1GB | ~$0.02 | Blobs de relatórios |
+
+### Total Estimado: ~$0.02/mês
+
+### Aprovação
+- [x] Free tier (sem aprovação necessária)
+- [ ] Até $10 (requer confirmação)
+- [ ] Acima de $10 (requer ADR)
+```
+
+## Como Estimar Custos
+
+1. Use [Azure Pricing Calculator](https://azure.microsoft.com/pricing/calculator/)
+2. Considere região Brazil South (pode ser mais caro)
+3. Inclua custos de transferência de dados
+4. Projete para 1 mês de uso típico
+5. Documente no `decisions.md`
+
+## Alertas Automáticos
+
+Quando detectar:
+- Recurso premium sem justificativa
+- Redundância desnecessária (ex: 2 instâncias em dev)
+- Storage sem lifecycle policy
+- Logs sem retenção definida
+
+**Ação**: Bloquear e sugerir alternativa.
+
+## Otimizações Recomendadas
+
+1. **Container Apps**: Sempre scale-to-zero em dev
+2. **SQL**: Free tier até precisar de mais
+3. **Storage**: LRS em dev, GRS só em prod se necessário
+4. **Logs**: Retenção de 30 dias max em dev
+5. **Backups**: Desabilitar em dev
+
+## Documentação de Referência
+
+- [Azure Pricing](https://azure.microsoft.com/pricing/)
+- [Free Services](https://azure.microsoft.com/free/free-account-faq/)
+- [Cost Management](https://learn.microsoft.com/en-us/azure/cost-management-billing/)
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*