@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/docs/api/styles/prettify.css

@@ -0,0 +1,80 @@
+.pln {
+  color: #ddd;
+}
+
+/* string content */
+.str {
+  color: #61ce3c;
+}
+
+/* a keyword */
+.kwd {
+  color: #fbde2d;
+}
+
+/* a comment */
+.com {
+  color: #aeaeae;
+}
+
+/* a type name */
+.typ {
+  color: #8da6ce;
+}
+
+/* a literal value */
+.lit {
+  color: #fbde2d;
+}
+
+/* punctuation */
+.pun {
+  color: #ddd;
+}
+
+/* lisp open bracket */
+.opn {
+  color: #000000;
+}
+
+/* lisp close bracket */
+.clo {
+  color: #000000;
+}
+
+/* a markup tag name */
+.tag {
+  color: #8da6ce;
+}
+
+/* a markup attribute name */
+.atn {
+  color: #fbde2d;
+}
+
+/* a markup attribute value */
+.atv {
+  color: #ddd;
+}
+
+/* a declaration */
+.dec {
+  color: #EF5050;
+}
+
+/* a variable name */
+.var {
+  color: #c82829;
+}
+
+/* a function name */
+.fun {
+  color: #4271ae;
+}
+
+/* Specify class=linenums on a pre to get line numbering */
+ol.linenums {
+  margin-top: 0;
+  margin-bottom: 0;
+  padding-bottom: 2px;
+}

package/docs/examples.md

@@ -0,0 +1,328 @@
+# MORPH-SPEC Examples Guide
+
+Guia dos exemplos incluídos no framework.
+
+---
+
+## Visão Geral
+
+| Exemplo | Stack | Complexidade | Tempo Est. |
+|---------|-------|--------------|------------|
+| [micro-saas](#micro-saas) | Blazor + Asaas | Alta | 2-3 dias |
+| [api-nextjs](#api-nextjs) | .NET + Next.js | Média | 1-2 dias |
+| [multi-agent](#multi-agent) | Semantic Kernel | Alta | 2-3 dias |
+
+---
+
+## micro-saas
+
+**Localização**: `.morph/examples/micro-saas/`
+
+### Descrição
+
+SaaS completo com multi-tenancy e billing integrado via Asaas.
+
+### Stack
+
+| Camada | Tecnologia |
+|--------|------------|
+| Frontend | Blazor Server |
+| Backend | .NET 8 Minimal APIs |
+| Database | SQL Server |
+| Auth | Clerk |
+| Billing | Asaas |
+| Infra | Azure Container Apps |
+
+### Features
+
+- **Multi-tenancy**: Isolamento completo por tenant
+- **Subscription Management**: Planos Free, Starter, Pro, Enterprise
+- **Payment Methods**: PIX, Boleto, Cartão de Crédito
+- **Dashboard**: Métricas e gestão
+- **User Management**: Convites, roles (Owner, Admin, Member)
+- **Webhooks**: Processamento de eventos Asaas
+
+### Arquivos
+
+```
+micro-saas/
+├── README.md           # Visão geral e arquitetura
+├── spec.md             # Especificação completa
+├── contracts.cs        # 50+ interfaces e DTOs
+├── tasks.md            # 51 tasks organizadas
+└── decisions.md        # 10 ADRs documentados
+```
+
+### ADRs Principais
+
+| ADR | Decisão |
+|-----|---------|
+| ADR-001 | Blazor Server vs WebAssembly |
+| ADR-002 | Asaas vs Stripe |
+| ADR-003 | Clerk vs Azure AD B2C |
+| ADR-004 | Single DB com Query Filters |
+| ADR-005 | Tenant Resolution Strategy |
+
+### Para Começar
+
+```bash
+# 1. Copie o exemplo para seu projeto
+cp -r .morph/examples/micro-saas/ .morph/features/
+
+# 2. Revise a spec
+cat .morph/features/micro-saas/spec.md
+
+# 3. Ajuste para suas necessidades
+# Edite spec.md com seus requisitos específicos
+
+# 4. Implemente
+/morph-apply micro-saas
+```
+
+### Custos Estimados
+
+| Recurso | Custo/mês |
+|---------|-----------|
+| Container Apps | ~$0 (scale-to-zero) |
+| SQL Database | $0 (Free tier) |
+| Storage | ~$0.50 |
+| Asaas | 2.99% + R$0.49/transação |
+| **Total** | **< $5/mês** |
+
+---
+
+## api-nextjs
+
+**Localização**: `.morph/examples/api-nextjs/`
+
+### Descrição
+
+Arquitetura full-stack com API .NET e frontend Next.js.
+
+### Stack
+
+| Camada | Tecnologia |
+|--------|------------|
+| Frontend | Next.js 14 (App Router) |
+| Backend | .NET 8 Minimal APIs |
+| Database | SQL Server |
+| Auth | Clerk |
+| Data Fetching | React Query |
+| UI | Tailwind + shadcn/ui |
+
+### Features
+
+- **Minimal APIs**: Endpoints organizados e documentados
+- **App Router**: Server Components + Client Components
+- **React Query**: Cache, mutations, optimistic updates
+- **TypeScript**: Types compartilhados (contracts.ts)
+- **Forms**: React Hook Form + Zod validation
+- **Dark Mode**: Theme switching
+
+### Arquivos
+
+```
+api-nextjs/
+├── README.md           # Arquitetura e setup
+├── spec.md             # Especificação detalhada
+├── contracts.ts        # Types TypeScript compartilhados
+└── tasks.md            # 67 tasks organizadas
+```
+
+### Estrutura do Projeto
+
+```
+project/
+├── src/
+│   ├── api/            # .NET Backend
+│   │   ├── Api/
+│   │   ├── Application/
+│   │   ├── Domain/
+│   │   └── Infrastructure/
+│   │
+│   └── web/            # Next.js Frontend
+│       ├── app/
+│       ├── components/
+│       ├── hooks/
+│       ├── lib/
+│       └── types/
+│
+└── infra/              # IaC
+```
+
+### Para Começar
+
+```bash
+# 1. Copie o exemplo
+cp -r .morph/examples/api-nextjs/ .morph/features/
+
+# 2. Revise contracts.ts para seu domínio
+# Este arquivo define os types compartilhados
+
+# 3. Ajuste spec.md
+# Modifique entidades e endpoints para seu caso
+
+# 4. Implemente
+/morph-apply api-nextjs
+```
+
+### Patterns Demonstrados
+
+| Pattern | Descrição |
+|---------|-----------|
+| API Client | Fetch wrapper com auth |
+| Query Keys | Organização de cache keys |
+| Data Hooks | useProducts, useOrders |
+| Form Pattern | React Hook Form + Zod |
+| Server Components | Data fetching no servidor |
+
+---
+
+## multi-agent
+
+**Localização**: `.morph/examples/multi-agent/`
+
+### Descrição
+
+Sistema de agentes AI cooperativos com Semantic Kernel.
+
+### Stack
+
+| Camada | Tecnologia |
+|--------|------------|
+| Framework | Semantic Kernel |
+| LLM | Azure OpenAI |
+| Orchestration | Custom Orchestrator |
+| Storage | In-Memory / Cosmos DB |
+| Infra | Azure Container Apps |
+
+### Agentes
+
+| Agente | Responsabilidade |
+|--------|------------------|
+| **Orchestrator** | Coordena outros agentes |
+| **Research** | Busca e RAG |
+| **Analysis** | Análise e comparações |
+| **Writing** | Geração de texto |
+
+### Features
+
+- **Task Decomposition**: Quebra tarefas complexas
+- **Plugin System**: WebSearch, Documents, Calculator
+- **Conversation Memory**: Contexto por sessão
+- **Semantic Memory**: RAG com embeddings
+- **Streaming**: Server-Sent Events
+
+### Arquivos
+
+```
+multi-agent/
+├── README.md           # Visão geral
+├── spec.md             # Especificação detalhada
+├── contracts.cs        # Interfaces e DTOs
+└── tasks.md            # 53 tasks organizadas
+```
+
+### Fluxo de Execução
+
+```
+User Request
+    │
+    ▼
+┌─────────────┐
+│ Orchestrator│ → Decompõe tarefa
+└─────────────┘
+    │
+    ├──► Research Agent → Busca informações
+    │
+    ├──► Analysis Agent → Analisa dados
+    │
+    └──► Writing Agent → Gera output
+          │
+          ▼
+   Consolidated Response
+```
+
+### Para Começar
+
+```bash
+# 1. Configure Azure OpenAI
+# - Crie deployment gpt-4
+# - Crie deployment text-embedding-ada-002
+
+# 2. Copie o exemplo
+cp -r .morph/examples/multi-agent/ .morph/features/
+
+# 3. Configure appsettings
+# Adicione suas credenciais Azure OpenAI
+
+# 4. Implemente
+/morph-apply multi-agent
+```
+
+### Custos Estimados
+
+| Recurso | Custo |
+|---------|-------|
+| GPT-4 | ~$0.03/1K tokens |
+| Embeddings | ~$0.0001/1K tokens |
+| Container Apps | ~$0-10/mês |
+
+**Nota**: Custos variam com uso. Para dev, use gpt-3.5-turbo.
+
+---
+
+## Como Usar os Exemplos
+
+### 1. Estudar a Estrutura
+
+Cada exemplo segue o padrão MORPH-SPEC:
+- `spec.md` - O quê construir
+- `contracts.cs/ts` - Interfaces e tipos
+- `tasks.md` - Como construir
+- `decisions.md` - Por que decisões foram tomadas
+
+### 2. Adaptar para Seu Projeto
+
+1. Copie o exemplo para `.morph/features/`
+2. Edite `spec.md` com seus requisitos
+3. Ajuste `contracts.cs` com suas entidades
+4. Revise `tasks.md` e remova o que não precisa
+
+### 3. Implementar
+
+```bash
+/morph-apply <nome-do-exemplo>
+```
+
+### 4. Customizar Templates
+
+Se precisar de padrões diferentes:
+1. Copie templates de `.morph/templates/`
+2. Modifique conforme necessário
+3. MORPH usará seus templates customizados
+
+---
+
+## Comparação de Complexidade
+
+| Aspecto | micro-saas | api-nextjs | multi-agent |
+|---------|------------|------------|-------------|
+| **Entities** | 6 | 4 | 5 |
+| **Tasks** | 51 | 67 | 53 |
+| **Integrations** | 2 (Asaas, Clerk) | 1 (Clerk) | 2 (OpenAI, Bing) |
+| **IaC Resources** | 5 | 6 | 4 |
+| **Custo Infra** | < $5 | < $10 | Variável |
+
+---
+
+## Próximos Passos
+
+1. Escolha o exemplo mais próximo do seu caso
+2. Leia a `spec.md` completa
+3. Revise os `contracts.*` para entender o modelo
+4. Use como base ou implemente diretamente
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/docs/getting-started.md

@@ -0,0 +1,302 @@
+# Getting Started - MORPH-SPEC
+
+**M**ethodical **O**rchestration for **R**eliable **P**roduction-ready **SPEC**-driven development
+
+> by Polymorphism Tech
+
+---
+
+## Quick Start (5 minutos)
+
+### 1. Copiar para seu projeto
+
+```bash
+# Clone o framework
+git clone https://github.com/polymorphism-tech/morph-framework.git
+
+# Copie o conteúdo 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/
+```
+
+### 2. Configurar
+
+```bash
+cd /seu/projeto/.morph/config
+cp config.template.json config.json
+```
+
+Edite `config.json`:
+```json
+{
+  "project": {
+    "name": "Seu Projeto",
+    "stack": "blazor"
+  },
+  "azure": {
+    "subscriptionId": "sua-subscription",
+    "resourceGroup": "rg-seuprojeto-dev"
+  }
+}
+```
+
+### 3. Usar com Claude Code
+
+Abra seu projeto no Claude Code e use os slash commands:
+
+```
+/morph-proposal minha-feature
+```
+
+O MORPH vai guiar você pelas 5 fases automaticamente.
+
+---
+
+## Estrutura Completa
+
+```
+seu-projeto/
+├── CLAUDE.md                          # Instruções para o AI
+│
+├── .morph/
+│   ├── project.md                     # Contexto do projeto
+│   ├── config/
+│   │   ├── config.json                # Sua configuração
+│   │   └── agents.json                # Definição dos agentes
+│   │
+│   ├── standards/
+│   │   ├── coding.md                  # Padrões de código
+│   │   ├── architecture.md            # Padrões de arquitetura
+│   │   └── azure.md                   # Padrões Azure/IaC
+│   │
+│   ├── templates/
+│   │   ├── spec.md                    # Template de especificação
+│   │   ├── tasks.md                   # Template de tasks
+│   │   ├── contracts.cs               # Template de contratos
+│   │   ├── decisions.md               # Template de ADRs
+│   │   ├── recap.md                   # Template de recap
+│   │   │
+│   │   ├── infra/                     # Templates IaC (Bicep)
+│   │   │   ├── main.bicep
+│   │   │   ├── container-app.bicep
+│   │   │   ├── container-app-env.bicep
+│   │   │   ├── sql-database.bicep
+│   │   │   ├── storage.bicep
+│   │   │   ├── key-vault.bicep
+│   │   │   ├── app-insights.bicep
+│   │   │   └── parameters.*.json
+│   │   │
+│   │   ├── integrations/              # Templates de integração
+│   │   │   ├── asaas-client.cs        # Pagamentos (PIX, Boleto)
+│   │   │   ├── asaas-webhook.cs       # Webhooks Asaas
+│   │   │   ├── clerk-config.cs        # Autenticação Clerk
+│   │   │   └── azure-identity-config.cs
+│   │   │
+│   │   └── saas/                      # Templates SaaS
+│   │       ├── subscription.cs        # Modelo de assinaturas
+│   │       └── tenant.cs              # Multi-tenancy
+│   │
+│   ├── examples/                      # Exemplos completos
+│   │   ├── micro-saas/                # Blazor + Asaas billing
+│   │   ├── api-nextjs/                # .NET API + Next.js
+│   │   └── multi-agent/               # Semantic Kernel agents
+│   │
+│   ├── specs/                         # Specs ativas
+│   ├── features/                      # Features em desenvolvimento
+│   └── archive/                       # Features concluídas
+│
+└── .claude/
+    ├── commands/                      # Slash commands
+    │   ├── morph-proposal.md
+    │   ├── morph-apply.md
+    │   ├── morph-status.md
+    │   ├── morph-archive.md
+    │   ├── morph-infra.md             # Gestão de infra
+    │   └── morph-costs.md             # Estimativa de custos
+    │
+    └── skills/                        # Skills dos agentes
+        ├── specialists/               # 8 agentes especialistas
+        ├── integrations/              # 3 agentes de integração
+        ├── stacks/                    # 3 stacks suportadas
+        └── infra/                     # 3 agentes de infra
+```
+
+---
+
+## O Workflow das 5 Fases
+
+### Fase 1: SETUP
+```
+Gatilho: /morph-proposal <feature>
+```
+- Carrega configuração do projeto
+- Identifica agentes por keywords
+- Cria pasta de outputs
+
+### Fase 2: DESIGN
+- Gera `spec.md`, `contracts.cs`, `decisions.md`
+- Estima custos de infraestrutura
+- **⛔ PARA para aprovação**
+
+### Fase 3: CLARIFY
+- Perguntas de clarificação
+- Resolve ambiguidades
+- Valida edge cases
+
+### Fase 4: TASKS
+- Quebra em tasks (T001, T002...)
+- Define checkpoints
+- **⛔ PARA para aprovação**
+
+### Fase 5: IMPLEMENT
+```
+Gatilho: /morph-apply <feature>
+```
+- Implementa task por task
+- Testes a cada task
+- Checkpoint a cada 3 tasks
+- Gera recap final
+
+---
+
+## Slash Commands
+
+| Comando | Descrição |
+|---------|-----------|
+| `/morph-proposal <feature>` | Inicia nova feature |
+| `/morph-apply <feature>` | Implementa feature aprovada |
+| `/morph-status` | Status do projeto |
+| `/morph-archive <feature>` | Arquiva feature |
+| `/morph-infra <action>` | Gestão de infraestrutura |
+| `/morph-costs` | Estimativa de custos |
+
+---
+
+## Os Agentes (17 total)
+
+### Core (Sempre Ativos)
+| Agente | Responsabilidade |
+|--------|------------------|
+| 📐 Standards Architect | Padrões de código |
+| ☁️ Azure Architect | Infraestrutura cloud |
+| 💰 Cost Guardian | Controle de custos |
+
+### Stack Agents
+| Agente | Keywords |
+|--------|----------|
+| 🔥 Blazor Builder | blazor, razor, component |
+| ⚛️ NextJS Expert | nextjs, react, frontend |
+| 🛒 Shopify Expert | shopify, hydrogen, liquid |
+
+### Specialist Agents
+| Agente | Keywords |
+|--------|----------|
+| 🗄️ EF Modeler | entity, database, migration |
+| 🤖 MS Agent Expert | agent, ai, semantic kernel |
+| ⏰ Hangfire Orchestrator | scheduled, job, background |
+| 🎨 UI/UX Designer | wizard, dashboard, complex |
+| 📋 PO/PM Advisor | unclear, requirements, ROI |
+
+### Integration Agents
+| Agente | Keywords |
+|--------|----------|
+| 💳 Asaas Financial | asaas, payment, pix, boleto |
+| 🔐 Clerk Auth | clerk, auth, login |
+| 🆔 Azure Identity | identity, entra, microsoft |
+
+### Infra Agents
+| Agente | Keywords |
+|--------|----------|
+| 🏗️ Bicep Architect | bicep, iac, provision |
+| 🚀 DevOps Engineer | pipeline, ci/cd, deploy |
+| 📦 Container Specialist | docker, container |
+
+---
+
+## Templates Disponíveis
+
+### IaC (Bicep)
+- `main.bicep` - Entry point
+- `container-app.bicep` - Azure Container Apps
+- `sql-database.bicep` - Azure SQL (Free tier)
+- `storage.bicep` - Storage Account
+- `key-vault.bicep` - Key Vault
+- `app-insights.bicep` - Monitoring
+
+### Integrações
+- `asaas-client.cs` - HTTP client Asaas completo
+- `asaas-webhook.cs` - Controller de webhooks
+- `clerk-config.cs` - Autenticação Clerk
+- `azure-identity-config.cs` - Microsoft Identity
+
+### SaaS
+- `subscription.cs` - Modelo de assinaturas
+- `tenant.cs` - Multi-tenancy completo
+
+---
+
+## Exemplos Incluídos
+
+| Exemplo | Stack | Descrição |
+|---------|-------|-----------|
+| `micro-saas/` | Blazor + Asaas | SaaS com billing integrado |
+| `api-nextjs/` | .NET + Next.js | Full-stack com React |
+| `multi-agent/` | Semantic Kernel | Sistema de agentes AI |
+
+Cada exemplo contém:
+- `README.md` - Visão geral
+- `spec.md` - Especificação completa
+- `contracts.cs` - Interfaces e DTOs
+- `tasks.md` - Breakdown de implementação
+- `decisions.md` - ADRs (onde aplicável)
+
+---
+
+## Limites de Custo
+
+| Nível | Limite | Requisito |
+|-------|--------|-----------|
+| Sem aprovação | Free tier | Nenhum |
+| Com aprovação | Até $10/mês | Confirmação |
+| Acima de $10 | Justificativa | ADR |
+
+### Recursos Free Tier Suportados
+- **Azure SQL** - 32GB grátis
+- **Container Apps** - Scale-to-zero
+- **Storage** - Pay-per-use mínimo
+- **App Insights** - 5GB/mês grátis
+
+---
+
+## Dicas
+
+### Seja específico
+```
+❌ "Quero relatórios"
+✅ "Quero agendar relatórios de vendas por email toda segunda às 8h"
+```
+
+### Use keywords para ativar agentes
+```
+❌ "Quero processar pagamentos"
+✅ "Quero integrar Asaas para receber PIX e boleto"
+```
+
+### Aproveite os checkpoints
+- Revise specs antes de aprovar
+- Valide tasks antes de implementar
+- Use `/morph-status` para ver progresso
+
+---
+
+## Próximos Passos
+
+1. Explore `.morph/examples/` para ver exemplos completos
+2. Leia `.morph/standards/` para entender os padrões
+3. Configure `.morph/config/config.json` para seu projeto
+4. Execute `/morph-proposal` para sua primeira feature!
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*