@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

package/content/.claude/{commands/morph-design.md → skills/level-1-workflows/phase-design.md}

@@ -1,275 +1,213 @@
-# MORPH Design - FASE 2
-
-Expanda a proposta em especificação técnica completa, contracts, decisões arquiteturais e estimativa de custos.
-
-## Uso
-
-```
-/morph-design {feature-name}
-```
-
-## Pré-requisitos
-
-- [ ] FASE 1 (Setup) concluída
-- [ ] FASE 1.5 (UI/UX) concluída OU pulada (se não houver front-end)
-- [ ] Proposta aprovada pelo usuário
-
-## Workflow
-
-### Passo 1: Carregar Contexto
-
-Leia os arquivos existentes da feature:
-
-```bash
-# Verificar outputs existentes
-node bin/state-manager.js get {feature-name}
-```
-
-Leia:
-1. `.morph/project/outputs/{feature}/proposal.md` - Proposta inicial
-2. `.morph/project/outputs/{feature}/ui-*.md` - UI/UX specs (se existirem)
-3. `framework/standards/` e `.morph/project/standards/` - Padrões aplicáveis
-
-### Passo 2: Gerar `spec.md`
-
-Crie `.morph/project/outputs/{feature}/spec.md` com:
-
-#### 2.1. Overview
-- **Objetivo:** Resumo de 1-2 parágrafos
-- **Usuários afetados:** Quem vai usar?
-- **Problema resolvido:** Qual dor/necessidade?
-
-#### 2.2. Functional Requirements
-Lista detalhada de requisitos funcionais:
-```markdown
-### FR001: {Requisito}
-**Description:** {O que deve fazer}
-**Acceptance Criteria:**
-- [ ] Critério 1
-- [ ] Critério 2
-**Priority:** High/Medium/Low
-```
-
-#### 2.3. Non-Functional Requirements
-- Performance (tempos de resposta esperados)
-- Segurança (autenticação, autorização)
-- Escalabilidade (volume de dados/usuários)
-- Disponibilidade (uptime esperado)
-
-#### 2.4. Technical Architecture
-- **Camadas:** (Presentation, Application, Domain, Infrastructure)
-- **Patterns:** (Repository, CQRS, DI, etc.)
-- **Dependências:** Bibliotecas/serviços externos necessários
-
-#### 2.5. Data Model
-- Entities principais
-- Relacionamentos (1:1, 1:N, N:N)
-- Campos obrigatórios vs opcionais
-- Validações de negócio
-
-#### 2.6. Infrastructure Requirements
-Se houver recursos Azure:
-- Banco de dados (Azure SQL, Cosmos DB)
-- Storage (Blob Storage)
-- Compute (Container Apps, App Service)
-- Monitoring (App Insights)
-
-**SEMPRE usar Bicep para infra!**
-
-### Passo 3: Gerar `contracts.cs`
-
-Crie `.morph/project/outputs/{feature}/contracts.cs` com:
-
-```csharp
-// Interfaces, DTOs, Enums, Value Objects
-
-namespace {ProjectName}.Features.{FeatureName};
-
-// DTOs (Data Transfer Objects)
-public record {Feature}CreateDto(
-    string Name,
-    DateTime Date
-);
-
-public record {Feature}ResponseDto(
-    Guid Id,
-    string Name,
-    DateTime Date,
-    DateTime CreatedAt
-);
-
-// Interfaces
-public interface I{Feature}Service
-{
-    Task<{Feature}ResponseDto> CreateAsync({Feature}CreateDto dto, CancellationToken ct);
-    Task<{Feature}ResponseDto?> GetByIdAsync(Guid id, CancellationToken ct);
-}
-
-// Enums
-public enum {Feature}Status
-{
-    Pending,
-    Active,
-    Completed
-}
-```
-
-**Padrões obrigatórios:**
-- Records para DTOs (immutable)
-- Interfaces para serviços
-- CancellationToken em métodos async
-- Nullable reference types habilitados
-
-### Passo 4: Iniciar `decisions.md`
-
-Crie `.morph/project/outputs/{feature}/decisions.md` com ADRs relevantes:
-
-```markdown
-# Architectural Decision Records (ADRs)
-
-## ADR-001: {Decisão Arquitetural}
-
-**Status:** Proposed/Accepted/Deprecated
-
-**Context:**
-{Por que esta decisão foi necessária}
-
-**Decision:**
-{O que foi decidido}
-
-**Consequences:**
-**Pros:**
-- Pro 1
-- Pro 2
-
-**Cons:**
-- Con 1
-- Con 2
-
-**Alternatives Considered:**
-- Alternativa 1: {Por que foi rejeitada}
-- Alternativa 2: {Por que foi rejeitada}
-
-**Date:** {YYYY-MM-DD}
-
----
-```
-
-**ADRs obrigatórios:**
-- Escolha de biblioteca UI (se FASE 1.5 executou)
-- Padrões arquiteturais (CQRS, Repository, etc.)
-- Recursos Azure (se houver infra)
-- Integrações externas (APIs, webhooks, etc.)
-
-### Passo 5: Estimar Custos
-
-Se houver recursos Azure na spec (arquivos Bicep):
-
-```bash
-# Calcular custos automaticamente
-node bin/calculate-costs.js .morph/project/outputs/{feature}/infra/*.bicep --verbose
-```
-
-O cost calculator:
-- Parseia arquivos Bicep e extrai recursos + SKUs
-- Calcula custo mensal baseado em pricing table do Azure
-- Valida contra limites configurados em `.morph/config/config.json`
-- Exit code 1 se exceder o limite `requiresADR` (padrão: $10)
-
-**Limites configuráveis** (em config.json):
-- `costs.limits.freeTierOnly`: $0 (apenas free tier)
-- `costs.limits.withApproval`: $10 (requer confirmação do usuário)
-- `costs.limits.requiresADR`: $10 (requer ADR documentado)
-
-**Exemplo de output:**
-```
-╔════════════════════════════════════════════════╗
-║         MORPH-SPEC COST CALCULATOR             ║
-╠════════════════════════════════════════════════╣
-║ sqlDatabase (Basic)              $4.99/mo     ║
-║ containerApp (Consumption)       $0.00/mo     ║
-║ appInsights (Free)               $0.00/mo     ║
-╠════════════════════════════════════════════════╣
-║ Total Monthly Cost:              $4.99        ║
-║ Requires Approval:               YES          ║
-║ Requires ADR:                    NO           ║
-╚════════════════════════════════════════════════╝
-```
-
-**Documente custos em `decisions.md`:**
-
-```markdown
-## ADR-XXX: Infrastructure Costs
-
-**Estimated Monthly Cost:** $X.XX
-
-**Breakdown:**
-- Azure SQL Basic: $5.00
-- Container App (scale-to-zero): $0.00
-- Storage LRS (1GB): $0.02
-- App Insights Free: $0.00
-
-**Total:** $5.02/month
-
-**Approval Required:** {Yes/No - based on $10 threshold}
-
-**Justification:**
-{Se > $10, justificar aqui}
-```
-
-4. Atualizar state com custo:
-
-```bash
-node bin/state-manager.js set {feature-name} costs.estimated {X.XX}
-node bin/state-manager.js set {feature-name} costs.approved {true/false}
-```
-
-### Passo 6: Atualizar State
-
-```bash
-# Marcar fase como design
-node bin/state-manager.js set {feature-name} phase design
-
-# Marcar outputs criados
-node bin/state-manager.js mark-output {feature-name} spec
-node bin/state-manager.js mark-output {feature-name} contracts
-node bin/state-manager.js mark-output {feature-name} decisions
-```
-
-## Outputs Gerados
-
-- `.morph/project/outputs/{feature}/spec.md` - Especificação técnica completa
-- `.morph/project/outputs/{feature}/contracts.cs` - Interfaces, DTOs, Enums
-- `.morph/project/outputs/{feature}/decisions.md` - ADRs (novo ou atualizado)
-- State atualizado com custos estimados
-
-## ⛔ PAUSA OBRIGATÓRIA
-
-Apresente ao usuário 3 ações sugeridas:
-
-1. ✅ **Aprovar design e continuar para clarificação**
-   Prosseguir para `/morph-clarify` (FASE 3)
-
-2. 🔄 **Ajustar escopo/complexidade**
-   Revisar spec.md para reduzir ou expandir funcionalidades
-
-3. 💰 **Revisar custos estimados** (se houver recursos Azure)
-   Ajustar SKUs ou recursos para ficar dentro do budget
-
-4. 📋 **Modificar contracts**
-   Ajustar interfaces/DTOs se necessário
-
-**Formato:** Escolher 3 das opções acima, contextualizadas para a feature
-
-## Critérios de Avanço
-
-- [x] `spec.md` completo com todos os requisitos
-- [x] `contracts.cs` com interfaces e DTOs
-- [x] `decisions.md` com ADRs relevantes
-- [x] Custos estimados e documentados (se houver infra)
-- [x] State atualizado
-- [x] Usuário aprovou design
-
----
-
-**Feature:** $ARGUMENTS
+# MORPH Design - FASE 2
+
+> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+
+Expanda a proposta em especificação técnica completa, contracts, decisões arquiteturais e estimativa de custos.
+
+## Pré-requisitos
+
+- [ ] FASE 1 (Setup) concluída
+- [ ] FASE 1.5 (UI/UX) concluída OU pulada (se não houver front-end)
+- [ ] Proposta aprovada pelo usuário
+
+## Workflow
+
+### Passo 1: Carregar Contexto e Standards
+
+**Obtenha feature state e standards context:**
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+Parse o JSON para obter `activeAgents`, então use standards context (já carregado na FASE 1):
+- Standards relevantes estão em `standardsSummary` do detect-agents
+- Padrões já incluem project overrides + inferred learnings
+
+**Leia outputs existentes:**
+1. `.morph/project/outputs/{feature}/proposal.md` - Proposta inicial
+2. `.morph/project/outputs/{feature}/ui-*.md` - UI/UX specs (se existirem)
+
+**Use standards context ao gerar spec.md:**
+- Architecture standards → guiam Technical Architecture section
+- Coding standards → definem contracts.cs patterns
+- Azure standards → determinam Infrastructure Requirements
+
+### Passo 2: Gerar `spec.md`
+
+Crie `.morph/project/outputs/{feature}/spec.md` com:
+
+#### 2.1. Overview
+- **Objetivo:** Resumo de 1-2 parágrafos
+- **Usuários afetados:** Quem vai usar?
+- **Problema resolvido:** Qual dor/necessidade?
+
+#### 2.2. Functional Requirements
+Lista detalhada de requisitos funcionais:
+```markdown
+### FR001: {Requisito}
+**Description:** {O que deve fazer}
+**Acceptance Criteria:**
+- [ ] Critério 1
+- [ ] Critério 2
+**Priority:** High/Medium/Low
+```
+
+#### 2.3. Non-Functional Requirements
+- Performance (tempos de resposta esperados)
+- Segurança (autenticação, autorização)
+- Escalabilidade (volume de dados/usuários)
+- Disponibilidade (uptime esperado)
+
+#### 2.4. Technical Architecture
+- **Camadas:** (Presentation, Application, Domain, Infrastructure)
+- **Patterns:** (Repository, CQRS, DI, etc.)
+- **Dependências:** Bibliotecas/serviços externos necessários
+
+#### 2.5. Data Model
+- Entities principais
+- Relacionamentos (1:1, 1:N, N:N)
+- Campos obrigatórios vs opcionais
+- Validações de negócio
+
+#### 2.6. Infrastructure Requirements
+Se houver recursos Azure:
+- Banco de dados (Azure SQL, Cosmos DB)
+- Storage (Blob Storage)
+- Compute (Container Apps, App Service)
+- Monitoring (App Insights)
+
+**SEMPRE usar Bicep para infra!**
+
+### Passo 3: Gerar `contracts.cs`
+
+Crie `.morph/project/outputs/{feature}/contracts.cs` com:
+
+```csharp
+// Interfaces, DTOs, Enums, Value Objects
+
+namespace {ProjectName}.Features.{FeatureName};
+
+// DTOs (Data Transfer Objects)
+public record {Feature}CreateDto(
+    string Name,
+    DateTime Date
+);
+
+public record {Feature}ResponseDto(
+    Guid Id,
+    string Name,
+    DateTime Date,
+    DateTime CreatedAt
+);
+
+// Interfaces
+public interface I{Feature}Service
+{
+    Task<{Feature}ResponseDto> CreateAsync({Feature}CreateDto dto, CancellationToken ct);
+    Task<{Feature}ResponseDto?> GetByIdAsync(Guid id, CancellationToken ct);
+}
+
+// Enums
+public enum {Feature}Status
+{
+    Pending,
+    Active,
+    Completed
+}
+```
+
+**Padrões obrigatórios:**
+- Records para DTOs (immutable)
+- Interfaces para serviços
+- CancellationToken em métodos async
+- Nullable reference types habilitados
+
+### Passo 4: Iniciar `decisions.md`
+
+Crie `.morph/project/outputs/{feature}/decisions.md` com ADRs relevantes:
+
+```markdown
+# Architectural Decision Records (ADRs)
+
+## ADR-001: {Decisão Arquitetural}
+
+**Status:** Proposed/Accepted/Deprecated
+
+**Context:**
+{Por que esta decisão foi necessária}
+
+**Decision:**
+{O que foi decidido}
+
+**Consequences:**
+**Pros:**
+- Pro 1
+
+**Cons:**
+- Con 1
+
+**Alternatives Considered:**
+- Alternativa 1: {Por que foi rejeitada}
+
+**Date:** {YYYY-MM-DD}
+```
+
+**ADRs obrigatórios:**
+- Escolha de biblioteca UI (se FASE 1.5 executou)
+- Padrões arquiteturais (CQRS, Repository, etc.)
+- Recursos Azure (se houver infra)
+- Integrações externas (APIs, webhooks, etc.)
+
+### Passo 5: Estimar Custos
+
+Se houver recursos Azure na spec:
+
+**Limites configuráveis** (em config.json):
+- `costs.limits.freeTierOnly`: $0 (apenas free tier)
+- `costs.limits.withApproval`: $10 (requer confirmação do usuário)
+- `costs.limits.requiresADR`: $10 (requer ADR documentado)
+
+Documente custos em `decisions.md` e atualize state:
+
+```bash
+npx morph-spec state set {feature-name} costs.estimated {X.XX}
+npx morph-spec state set {feature-name} costs.approved {true/false}
+```
+
+### Passo 6: Atualizar State
+
+```bash
+npx morph-spec state set {feature-name} phase design
+npx morph-spec state mark-output {feature-name} spec
+npx morph-spec state mark-output {feature-name} contracts
+npx morph-spec state mark-output {feature-name} decisions
+```
+
+## Outputs Gerados
+
+- `.morph/project/outputs/{feature}/spec.md` - Especificação técnica completa
+- `.morph/project/outputs/{feature}/contracts.cs` - Interfaces, DTOs, Enums
+- `.morph/project/outputs/{feature}/decisions.md` - ADRs (novo ou atualizado)
+- State atualizado com custos estimados
+
+## PAUSA OBRIGATÓRIA
+
+Apresente ao usuário 3 ações sugeridas:
+
+1. **Aprovar design e continuar para clarificação**
+2. **Ajustar escopo/complexidade** - Revisar spec.md
+3. **Modificar contracts** - Ajustar interfaces/DTOs
+
+## Critérios de Avanço
+
+- [x] `spec.md` completo com todos os requisitos
+- [x] `contracts.cs` com interfaces e DTOs
+- [x] `decisions.md` com ADRs relevantes
+- [x] Custos estimados e documentados (se houver infra)
+- [x] State atualizado
+- [x] Usuário aprovou design
+
+---
+
+Continuar automaticamente para FASE 3 (Clarify) após aprovação.

package/content/.claude/skills/level-1-workflows/phase-setup.md

@@ -0,0 +1,106 @@
+# MORPH Setup - FASE 1
+
+> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+
+Inicialize o contexto e prepare o ambiente para uma feature aprovada.
+
+## Pré-requisitos
+
+- [ ] Feature tem `proposal.md` criado (FASE 0 concluída)
+- [ ] Proposal foi aprovado pelo usuário
+- [ ] Agentes foram detectados e registrados no state
+
+## Workflow
+
+### Passo 1: Verificar State
+
+Confirme que a feature existe no state:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+Se não existir, volte para FASE 0 (proposal).
+
+### Passo 2: Carregar Contexto e Standards Automaticamente
+
+**Use detect-agents --json para obter standards context:**
+
+```bash
+npx morph-spec detect-agents --json "{feature description from proposal}"
+```
+
+O output JSON contém `standardsSummary` com todos os standards relevantes para cada agente ativo:
+
+```json
+{
+  "standardsSummary": {
+    "blazor-builder": {
+      "standards": ["blazor-lifecycle", "blazor-state", "coding", ...],
+      "fullContent": "# blazor-lifecycle\n\n...",  // Full standards text
+      "count": 10
+    }
+  }
+}
+```
+
+**Standards resolution order** (automático):
+1. `.morph/project/standards/*.md` (project overrides - highest priority)
+2. `content/.morph/standards/*.md` (AI Agent Framework, Azure)
+3. `framework/standards/*.md` (Blazor, CSS, .NET)
+4. `.morph/project/standards/inferred.md` (always loaded if exists)
+
+**Contexto geral** (leia manualmente):
+- `.morph/project/context/README.md` - Overview do projeto
+- `.morph/config.json` - Configurações
+
+### Passo 3: Confirmar Stack
+
+Baseado no proposal e contexto, confirme:
+- Stack tecnológica (Blazor Server, Next.js, etc.)
+- Padrões arquiteturais aplicáveis
+- Componentes reutilizáveis existentes
+
+### Passo 4: Listar Agentes Ativos
+
+Mostre os agentes detectados no proposal:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+Parse o JSON e liste os `activeAgents` com seus emojis e responsabilidades (consulte `.morph/config/agents.json`).
+
+### Passo 5: Atualizar State
+
+Marque a feature como na fase SETUP:
+
+```bash
+npx morph-spec state set {feature-name} phase setup
+npx morph-spec state set {feature-name} status in_progress
+```
+
+## Outputs
+
+**Apresente ao usuário:**
+
+1. **Contexto carregado**:
+   - Nome do projeto
+   - Stack confirmado
+   - Standards aplicáveis
+
+2. **Agentes ativos**:
+   - Lista de agentes com emojis
+   - Responsabilidades de cada um
+
+## Critérios de Avanço
+
+- [x] Contexto do projeto carregado
+- [x] Standards identificados (framework + project)
+- [x] Stack confirmado
+- [x] Agentes listados
+- [x] State atualizado para phase: setup
+
+---
+
+Continuar automaticamente para próxima fase (UI/UX se detectado, ou Design).