@polymorphism-tech/morph-spec 1.0.0

package/README.md

@@ -0,0 +1,279 @@
+<h1 align="center">MORPH-SPEC</h1>
+
+<p align="center">
+  <strong>Desenvolvimento orientado por especificações com agentes AI</strong><br>
+  <em>by Polymorphism Tech</em>
+</p>
+
+<p align="center">
+  <a href="#instalação">Instalação</a> •
+  <a href="#começando">Começando</a> •
+  <a href="#comandos">Comandos</a> •
+  <a href="#agentes">Agentes</a> •
+  <a href="docs/">Documentação</a>
+</p>
+
+---
+
+## O que é MORPH-SPEC?
+
+**M**ethodical **O**rchestration for **R**eliable **P**roduction-ready **SPEC**-driven development
+
+MORPH-SPEC é um framework de desenvolvimento orientado por especificações com **17 agentes AI especializados**. Cada agente tem expertise em tecnologias específicas e segue workflows estruturados para entregar código production-ready.
+
+**Stacks suportadas:** .NET/Blazor, .NET/Next.js, Shopify
+**Infraestrutura:** Azure Bicep (IaC)
+**Ferramenta:** Claude Code
+
+---
+
+## Instalação
+
+### Pré-requisitos
+
+- [Claude Code](https://claude.ai/code) instalado
+- Git
+
+### Instalação Rápida
+
+**Windows (PowerShell):**
+```powershell
+# 1. Clone o repositório
+git clone <url-do-repo>
+
+# 2. Execute o setup no seu projeto
+cd morph-framework
+.\scripts\setup.ps1 -TargetPath "C:\caminho\do\seu\projeto"
+```
+
+**Linux/Mac (Bash):**
+```bash
+# 1. Clone o repositório
+git clone <url-do-repo>
+
+# 2. Execute o setup no seu projeto
+cd morph-framework
+./scripts/setup.sh -t /caminho/do/seu/projeto
+```
+
+### Instalação Manual
+
+```bash
+# 1. Clone o repositório
+git clone <url-do-repo>
+
+# 2. Copie os arquivos para seu projeto
+cp -r morph-framework/content/.morph /seu/projeto/
+cp -r morph-framework/content/.claude /seu/projeto/
+cp morph-framework/content/CLAUDE.md /seu/projeto/
+
+# 3. Configure
+cd /seu/projeto/.morph/config
+cp config.template.json config.json
+# Edite config.json com suas configurações
+```
+
+### Verificar Instalação
+
+Abra seu projeto no Claude Code e execute:
+```
+/morph-status
+```
+
+Se configurado corretamente, você verá o status do projeto.
+
+---
+
+## Começando
+
+### 1. Criar uma Proposta
+
+```
+/morph-proposal minha-feature
+```
+
+Descreva o que quer implementar. O MORPH vai gerar a especificação completa.
+
+### 2. Revisar a Spec
+
+Arquivos gerados em `.morph/features/minha-feature/`:
+- `spec.md` - Especificação técnica
+- `contracts.cs` - Interfaces e DTOs
+- `decisions.md` - Decisões arquiteturais
+
+### 3. Aprovar o Design
+
+Revise os arquivos gerados e aprove (ou peça ajustes).
+
+### 4. Implementar
+
+```
+/morph-apply minha-feature
+```
+
+O MORPH implementa task por task, com testes a cada etapa.
+
+### 5. Arquivar
+
+```
+/morph-archive minha-feature
+```
+
+Move a feature concluída para o arquivo.
+
+---
+
+## Como Funciona
+
+```
+┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
+│  SETUP   │ ─▶ │  DESIGN  │ ─▶ │ CLARIFY  │ ─▶ │  TASKS   │ ─▶ │IMPLEMENT │
+│          │    │          │    │          │    │          │    │          │
+│ Contexto │    │  Spec +  │    │  Q&A +   │    │  Quebra  │    │ Executa  │
+│ + Agents │    │Contracts │    │  Edges   │    │  Tasks   │    │ + Testa  │
+└──────────┘    └──────────┘    └──────────┘    └──────────┘    └──────────┘
+                     ⛔                              ⛔
+                  Aprovação                       Aprovação
+```
+
+**Pontos de aprovação:** O MORPH para em 2 momentos para você revisar antes de continuar.
+
+---
+
+## Comandos
+
+| Comando | Descrição |
+|---------|-----------|
+| `/morph-proposal <nome>` | Cria nova feature |
+| `/morph-apply <nome>` | Implementa feature aprovada |
+| `/morph-status` | Mostra status do projeto |
+| `/morph-archive <nome>` | Arquiva feature concluída |
+| `/morph-infra <ação>` | Gerencia infraestrutura (init, validate, deploy) |
+| `/morph-costs` | Estima custos Azure |
+
+---
+
+## Agentes
+
+### Sempre Ativos
+
+| Agente | Função |
+|--------|--------|
+| 📐 **Standards Architect** | Padrões de código e consistência |
+| ☁️ **Azure Architect** | Infraestrutura cloud e IaC |
+| 💰 **Cost Guardian** | Controle de custos |
+
+### Por Stack
+
+| Agente | Keywords |
+|--------|----------|
+| 🔥 **Blazor Builder** | blazor, razor, component |
+| ⚛️ **NextJS Expert** | nextjs, react, frontend |
+| 🛒 **Shopify Expert** | shopify, hydrogen, liquid |
+
+### Especialistas
+
+| Agente | Keywords |
+|--------|----------|
+| 🗄️ **EF Modeler** | database, entity, migration |
+| 🤖 **MS Agent Expert** | agent, ai, semantic kernel |
+| ⏰ **Hangfire Orchestrator** | scheduled, job, background |
+| 🎨 **UI/UX Designer** | wizard, dashboard, complex form |
+| 📋 **PO/PM Advisor** | unclear, requirements, ROI |
+
+### Integrações
+
+| Agente | Keywords |
+|--------|----------|
+| 💳 **Asaas Financial** | asaas, pix, boleto, payment |
+| 🔐 **Clerk Auth** | clerk, auth, login |
+| 🆔 **Azure Identity** | identity, entra, microsoft auth |
+
+### Infraestrutura
+
+| Agente | Keywords |
+|--------|----------|
+| 🏗️ **Bicep Architect** | bicep, iac, infra |
+| 🚀 **DevOps Engineer** | pipeline, ci/cd, deploy |
+| 📦 **Container Specialist** | docker, container |
+
+---
+
+## Exemplos
+
+| Exemplo | Descrição |
+|---------|-----------|
+| [micro-saas](.morph/examples/micro-saas/) | SaaS completo com Blazor + Asaas billing |
+| [api-nextjs](.morph/examples/api-nextjs/) | .NET API + Next.js frontend |
+| [multi-agent](.morph/examples/multi-agent/) | Sistema multi-agente com Semantic Kernel |
+
+Cada exemplo inclui: `README.md`, `spec.md`, `contracts.cs`, `tasks.md`, `decisions.md`
+
+---
+
+## Estrutura do Projeto
+
+Após a instalação, seu projeto terá:
+
+```
+seu-projeto/
+├── CLAUDE.md                 # Instruções para o AI
+├── .morph/
+│   ├── config/               # Configurações
+│   │   ├── config.json
+│   │   └── agents.json
+│   ├── standards/            # Padrões de código
+│   │   ├── coding.md
+│   │   ├── architecture.md
+│   │   └── azure.md
+│   ├── templates/            # Templates de código e IaC
+│   │   ├── infra/
+│   │   ├── integrations/
+│   │   └── saas/
+│   ├── examples/             # Exemplos completos
+│   ├── features/             # Features em desenvolvimento
+│   └── archive/              # Features concluídas
+└── .claude/
+    ├── commands/             # Slash commands
+    └── skills/               # Skills dos agentes
+```
+
+---
+
+## Templates Incluídos
+
+### IaC (Bicep)
+- `main.bicep`, `container-app.bicep`, `sql-database.bicep`, `storage.bicep`, `key-vault.bicep`, `app-insights.bicep`
+
+### Integrações
+- `asaas-client.cs`, `asaas-webhook.cs`, `clerk-config.cs`, `azure-identity-config.cs`
+
+### SaaS
+- `subscription.cs`, `tenant.cs`
+
+### Código
+- `service.cs`, `repository.cs`, `component.razor`, `agent.cs`, `job.cs`, `test.cs`
+
+---
+
+## Custos
+
+O MORPH segue a filosofia **"Free tier first"**:
+
+| Nível | Limite | Requer |
+|-------|--------|--------|
+| Sem aprovação | Free tier | Nada |
+| Com aprovação | Até $10/mês | Confirmação |
+| Acima de $10 | Justificativa | ADR |
+
+---
+
+## Dúvidas
+
+- 📚 Documentação completa: [`docs/`](docs/)
+- 💡 Exemplos: [`.morph/examples/`](.morph/examples/)
+- 🐛 Problemas: Abra uma issue ou fale no Teams
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/bin/morph-spec.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+import { program } from 'commander';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { readFileSync } from 'fs';
+
+import { initCommand } from '../src/commands/init.js';
+import { updateCommand } from '../src/commands/update.js';
+import { doctorCommand } from '../src/commands/doctor.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
+
+const banner = chalk.cyan(`
+  ███╗   ███╗ ██████╗ ██████╗ ██████╗ ██╗  ██╗
+  ████╗ ████║██╔═══██╗██╔══██╗██╔══██╗██║  ██║
+  ██╔████╔██║██║   ██║██████╔╝██████╔╝███████║
+  ██║╚██╔╝██║██║   ██║██╔══██╗██╔═══╝ ██╔══██║
+  ██║ ╚═╝ ██║╚██████╔╝██║  ██║██║     ██║  ██║
+  ╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝╚═╝     ╚═╝  ╚═╝
+
+  Methodical Orchestration for Reliable Production-ready SPEC-driven development
+  by Polymorphism Tech | v${pkg.version}
+`);
+
+program
+  .name('morph-spec')
+  .description('MORPH-SPEC Framework CLI')
+  .version(pkg.version)
+  .addHelpText('beforeAll', banner);
+
+program
+  .command('init')
+  .description('Initialize MORPH-SPEC in current directory')
+  .option('-f, --force', 'Overwrite existing MORPH installation')
+  .option('-p, --path <path>', 'Target path (default: current directory)')
+  .action(initCommand);
+
+program
+  .command('update')
+  .description('Update MORPH templates and standards to latest version')
+  .option('--templates', 'Update only templates')
+  .option('--standards', 'Update only standards')
+  .action(updateCommand);
+
+program
+  .command('doctor')
+  .description('Check MORPH installation health')
+  .action(doctorCommand);
+
+program.parse();

package/content/.claude/commands/morph-apply.md

@@ -0,0 +1,66 @@
+# Apply MORPH Feature Implementation
+
+Implemente a feature especificada seguindo as tasks definidas.
+
+## Pré-requisitos
+
+Verifique antes de implementar:
+- [ ] Feature existe em `.morph/features/{feature}/`
+- [ ] `spec.md` está aprovado (Status: Approved)
+- [ ] `tasks.md` tem tasks definidas
+- [ ] `contracts.cs` define as interfaces
+
+## Workflow
+
+1. **Carregue o contexto**:
+   - Leia `.morph/features/{feature}/spec.md`
+   - Leia `.morph/features/{feature}/tasks.md`
+   - Leia `.morph/features/{feature}/contracts.cs`
+   - Leia `.morph/standards/` para padrões
+
+2. **Execute tasks em ordem**:
+   - Marque task como `[~] In Progress`
+   - Implemente seguindo os padrões
+   - Marque task como `[x] Completed`
+
+3. **Checkpoints**:
+   - Pause nos checkpoints definidos
+   - Apresente o que foi feito
+   - Aguarde aprovação para continuar
+
+4. **A cada 3 tasks**:
+   - Faça um checkpoint automático
+   - Mostre progresso
+   - Valide com o usuário
+
+5. **Ao finalizar**:
+   - Atualize `recap.md` com resultados
+   - Liste arquivos criados/modificados
+   - Calcule custo real vs estimado
+
+## Padrões Obrigatórios
+
+Siga sempre:
+- `.morph/standards/coding.md` - Nomenclatura e estilo
+- `.morph/standards/architecture.md` - Estrutura de projeto
+- `.morph/standards/azure.md` - Recursos e custos
+
+## Validações
+
+Antes de marcar task como completa:
+- [ ] Código compila
+- [ ] Segue padrões de nomenclatura
+- [ ] Testes unitários (se aplicável)
+- [ ] Sem hardcoded secrets
+
+## Output
+
+Ao final de cada task, mostre:
+1. Task completada
+2. Arquivos criados/modificados
+3. Próxima task
+4. Progresso geral (X/Y tasks)
+
+---
+
+**Feature:** $ARGUMENTS

package/content/.claude/commands/morph-archive.md

@@ -0,0 +1,79 @@
+# Archive MORPH Feature
+
+Arquive uma feature concluída, movendo-a de `features/` para `archive/`.
+
+## Pré-requisitos
+
+Verifique antes de arquivar:
+- [ ] Feature existe em `.morph/features/{feature}/`
+- [ ] Todas as tasks estão completas
+- [ ] `recap.md` está preenchido
+- [ ] Código está em produção (ou staging)
+
+## Workflow
+
+1. **Valide a conclusão**:
+   - Leia `.morph/features/{feature}/tasks.md`
+   - Verifique que todas tasks estão `[x]`
+   - Confirme com o usuário se pode arquivar
+
+2. **Complete o recap**:
+   - Atualize `.morph/features/{feature}/recap.md`
+   - Preencha métricas finais
+   - Documente lições aprendidas
+
+3. **Extraia specs**:
+   - Se a feature define comportamento permanente
+   - Copie spec relevante para `.morph/specs/`
+   - Isso vira a "verdade atual" do sistema
+
+4. **Mova para archive**:
+   ```
+   .morph/features/{feature}/  →  .morph/archive/{feature}/
+   ```
+
+5. **Atualize métricas do projeto**:
+   - Incremente contador de features
+   - Atualize custo total
+   - Atualize tempo total
+
+## Output
+
+Apresente resumo do arquivamento:
+
+```
+╔════════════════════════════════════════════╗
+║         FEATURE ARCHIVED                   ║
+╠════════════════════════════════════════════╣
+║ Feature: {name}                            ║
+║ Completed: {date}                          ║
+╠════════════════════════════════════════════╣
+║ METRICS                                    ║
+╠════════════════════════════════════════════╣
+║ Tasks: {X}/{X} completed                   ║
+║ Time: {X}h (estimated: {Y}h)               ║
+║ Cost Impact: +${X}/month                   ║
+╠════════════════════════════════════════════╣
+║ FILES                                      ║
+╠════════════════════════════════════════════╣
+║ Created: {X} files                         ║
+║ Modified: {Y} files                        ║
+║ Tests: {Z} files ({W}% coverage)           ║
+╠════════════════════════════════════════════╣
+║ ARCHIVED TO                                ║
+╠════════════════════════════════════════════╣
+║ .morph/archive/{feature}/                  ║
+╚════════════════════════════════════════════╝
+```
+
+## Specs Extraídas
+
+Se houver specs extraídas:
+```
+Specs extracted to .morph/specs/:
+- {domain}/spec.md - {description}
+```
+
+---
+
+**Feature to archive:** $ARGUMENTS

package/content/.claude/commands/morph-costs.md

@@ -0,0 +1,206 @@
+# /morph-costs - Cost Estimation and Reporting
+
+Estima e reporta custos de recursos Azure.
+
+## Uso
+
+```
+/morph-costs [action]
+```
+
+### Actions
+
+| Action | Descrição |
+|--------|-----------|
+| `estimate` | Estima custos da feature atual |
+| `report` | Gera relatório de custos do projeto |
+| `compare` | Compara custos entre ambientes |
+
+---
+
+## Workflow
+
+### 1. ESTIMATE - Estimar Custos
+
+Quando o usuário solicitar `/morph-costs estimate`:
+
+1. Ler spec.md da feature atual para identificar recursos
+
+2. Para cada recurso Azure, calcular custo mensal:
+
+   | Recurso | SKU | Custo/Mês |
+   |---------|-----|-----------|
+   | Container Apps | Consumption (scale-to-zero) | ~$0 |
+   | Azure SQL | Free (32GB) | $0 |
+   | Azure SQL | Basic (5 DTU) | ~$5 |
+   | Storage | Standard LRS (1GB) | ~$0.02 |
+   | Key Vault | Standard | ~$0.03/10k ops |
+   | App Insights | Free (5GB/mês) | $0 |
+   | Service Bus | Basic | ~$0.05 |
+
+3. Apresentar estimativa:
+   ```markdown
+   ## Estimativa de Custos - {Feature}
+
+   | Recurso | SKU | Custo/Mês |
+   |---------|-----|-----------|
+   | Container Apps | Consumption | ~$0 |
+   | SQL Database | Free | $0 |
+   | Storage | LRS 1GB | $0.02 |
+   | **TOTAL** | | **$0.02/mês** |
+
+   ### Aprovação
+   ✅ Free tier - nenhuma aprovação necessária
+   ```
+
+4. Verificar contra limites do Cost Guardian:
+   - Free tier apenas: ✅ Aprovado automaticamente
+   - Até $10/mês: ⚠️ Requer confirmação
+   - Acima de $10: ❌ Requer ADR
+
+---
+
+### 2. REPORT - Relatório de Custos
+
+Quando o usuário solicitar `/morph-costs report`:
+
+1. Analisar todos os recursos definidos em `infra/`
+
+2. Gerar relatório consolidado:
+
+   ```markdown
+   ## Relatório de Custos - {Projeto}
+
+   ### Por Ambiente
+
+   | Ambiente | Recursos | Custo/Mês |
+   |----------|----------|-----------|
+   | dev | 6 | ~$0 |
+   | prod | 6 | ~$15 |
+   | **Total** | | **~$15/mês** |
+
+   ### Por Tipo de Recurso
+
+   | Recurso | Dev | Prod |
+   |---------|-----|------|
+   | Container Apps | $0 | $5 |
+   | SQL Database | $0 | $5 |
+   | Storage | $0.02 | $2 |
+   | Key Vault | $0 | $0.50 |
+   | App Insights | $0 | $2.50 |
+
+   ### Recomendações
+   1. ✅ Dev usa free tier corretamente
+   2. ⚠️ Considerar Reserved Capacity para prod (-30%)
+   ```
+
+3. Salvar relatório em `.morph/outputs/costs-report.md`
+
+---
+
+### 3. COMPARE - Comparar Ambientes
+
+Quando o usuário solicitar `/morph-costs compare`:
+
+1. Analisar `parameters.dev.json` e `parameters.prod.json`
+
+2. Gerar comparativo:
+
+   ```markdown
+   ## Comparativo de Custos
+
+   | Recurso | Dev | Prod | Diferença |
+   |---------|-----|------|-----------|
+   | SQL SKU | Free | Basic | +$5 |
+   | Storage SKU | LRS | GRS | +$1 |
+   | Min Replicas | 0 | 1 | +$3 |
+   | **Total** | $0 | $15 | +$15 |
+
+   ### Por que prod custa mais?
+   - SQL Basic: melhor performance, SLA 99.99%
+   - Storage GRS: redundância geográfica
+   - Min replicas 1: sem cold start
+   ```
+
+---
+
+## Pricing Reference
+
+### Free Tier Resources
+
+| Recurso | Limite Grátis |
+|---------|---------------|
+| Azure SQL | 32GB, 100k vCore seconds |
+| Container Apps | Scale-to-zero, 180k vCPU-sec |
+| Storage | 5GB LRS |
+| App Insights | 5GB/mês |
+| Cosmos DB | 1000 RU/s, 25GB |
+| Functions | 1M execuções |
+
+### Costs by Region (Brazil South)
+
+| Recurso | SKU | Preço |
+|---------|-----|-------|
+| Container Apps | Consumption | $0.000012/vCPU-sec |
+| SQL | Basic | $4.99/mês |
+| SQL | S0 | $14.72/mês |
+| Storage | LRS | $0.0184/GB |
+| Storage | GRS | $0.046/GB |
+
+---
+
+## Cost Guardian Rules
+
+### Aprovação Automática (Free Tier)
+- Container Apps com scale-to-zero
+- SQL Free tier
+- Storage Standard LRS até 5GB
+- App Insights free tier
+
+### Requer Confirmação (até $10/mês)
+- SQL Basic
+- Storage adicional
+- Service Bus Basic
+
+### Requer ADR (acima de $10/mês)
+- Recursos Premium
+- Multiple replicas
+- Reserved capacity
+- Qualquer recurso não essencial
+
+---
+
+## Exemplo de Uso
+
+```
+Usuário: /morph-costs estimate
+Claude: Analisando feature "scheduled-reports"...
+
+        ## Estimativa de Custos
+
+        | Recurso | SKU | Custo/Mês |
+        |---------|-----|-----------|
+        | Container Apps | Consumption | ~$0 |
+        | SQL Database | Free | $0 |
+        | Storage | LRS 1GB | $0.02 |
+        | Hangfire | In-process | $0 |
+
+        **TOTAL: ~$0.02/mês**
+
+        ✅ Dentro do free tier - aprovado automaticamente!
+
+Usuário: /morph-costs report
+Claude: ## Relatório de Custos - MyProject
+
+        | Ambiente | Custo/Mês |
+        |----------|-----------|
+        | dev | $0.02 |
+        | prod | $12.50 |
+
+        ⚠️ Prod excede $10/mês.
+        Deseja criar um ADR para justificar? (sim/não)
+```
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*