@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

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

@@ -0,0 +1,227 @@
+# Pre-Flight Check for Azure Deployment
+
+Validates project readiness before deploying to Azure.
+
+## Uso
+
+```
+/morph-preflight azure
+```
+
+## Objetivo
+
+Detectar problemas **antes** do deploy que causariam falhas em produção. Economiza tempo e evita debugging em ambiente Azure.
+
+---
+
+## Validações Executadas
+
+### 1. Package Version Conflicts
+
+**O que verifica:**
+- `Azure.Identity` especificado explicitamente
+- Sem conflitos de versão (NU1605, NU1608)
+- Packages críticos com versões compatíveis
+
+**Como verificar:**
+```bash
+dotnet restore --verbosity normal 2>&1 | grep -E "(NU1605|NU1608|warning)"
+```
+
+**Fix comum:**
+```xml
+<PackageReference Include="Azure.Identity" Version="1.14.2" />
+```
+
+---
+
+### 2. EF Core Migrations
+
+**O que verifica:**
+- Sem pending model changes
+- Migrations aplicáveis existem
+- Migration scripts são válidos
+
+**Como verificar:**
+```bash
+dotnet ef migrations has-pending-model-changes \
+  --project src/Infrastructure \
+  --startup-project src/Web
+```
+
+**Fix comum:**
+```bash
+dotnet ef migrations add <MigrationName> \
+  --project src/Infrastructure \
+  --startup-project src/Web
+```
+
+---
+
+### 3. Dockerfile Validation (se Container Apps)
+
+**O que verifica:**
+- Dockerfile existe
+- Base image é válida
+- Multi-stage build configurado
+- EXPOSE ports corretos
+- ENTRYPOINT definido
+
+**Como verificar:**
+```bash
+docker build --check .
+# Ou validação manual do Dockerfile
+```
+
+---
+
+### 4. Blazor .NET 10 Assets
+
+**O que verifica:**
+- `RequiresAspNetWebAssets` está `true` (se Blazor + .NET 10)
+- Static web assets configurados corretamente
+
+**Como verificar:**
+```bash
+grep -r "RequiresAspNetWebAssets" *.csproj
+```
+
+**Fix:**
+```xml
+<PropertyGroup>
+  <RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>
+</PropertyGroup>
+```
+
+---
+
+### 5. Bicep Syntax Validation
+
+**O que verifica:**
+- Arquivos `.bicep` sem erros de sintaxe
+- Parâmetros obrigatórios definidos
+- Resources com nomes válidos
+
+**Como verificar:**
+```bash
+az bicep build --file infra/main.bicep --stdout > /dev/null
+```
+
+---
+
+### 6. Key Vault Configuration
+
+**O que verifica:**
+- Key Vault URI configurado em `appsettings.json` ou environment
+- Não condiciona Key Vault ao ambiente (bug comum)
+- Managed Identity habilitada
+
+**Como verificar:**
+```bash
+grep -r "KeyVaultUri\|AzureKeyVault" appsettings*.json
+grep -r "IsDevelopment()" Program.cs | grep -i keyvault
+```
+
+**Anti-pattern a detectar:**
+```csharp
+// ❌ ERRADO - Não carrega Key Vault em dev!
+if (!builder.Environment.IsDevelopment())
+{
+    builder.Configuration.AddAzureKeyVault(...);
+}
+```
+
+---
+
+### 7. Connection Strings Security
+
+**O que verifica:**
+- Connection strings não hardcoded em código
+- Secrets em Key Vault ou User Secrets
+- Sem credentials em `appsettings.json` (exceto Development)
+
+**Como verificar:**
+```bash
+# Detectar passwords em appsettings
+grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json | grep -v Development
+```
+
+---
+
+## Output Exemplo
+
+```
+🔍 MORPH Pre-Flight Check: Azure Deployment
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+✅ Packages: No version conflicts detected
+✅ Migrations: No pending model changes
+✅ Dockerfile: Valid multi-stage build
+✅ Blazor Assets: RequiresAspNetWebAssets=true
+✅ Bicep: Syntax valid
+❌ Key Vault: URI not configured in appsettings.Production.json
+⚠️ Connection Strings: Found password in appsettings.Staging.json
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+📋 Summary: 5 passed, 1 failed, 1 warning
+
+❌ BLOCKED: Fix Key Vault configuration before deploy!
+
+Recommended fixes:
+1. Add KeyVaultUri to appsettings.Production.json
+2. Move password from appsettings.Staging.json to Key Vault
+```
+
+---
+
+## Workflow de Uso
+
+### Antes de criar PR para produção
+
+```bash
+/morph-preflight azure
+```
+
+### No pipeline CI/CD
+
+```yaml
+- script: |
+    # Package check
+    dotnet restore 2>&1 | grep -E "NU1605|NU1608" && exit 1
+
+    # Migration check
+    dotnet ef migrations has-pending-model-changes \
+      --project src/Infrastructure \
+      --startup-project src/Web
+    if [ $? -ne 0 ]; then exit 1; fi
+
+    # Bicep check
+    az bicep build --file infra/main.bicep --stdout > /dev/null
+    if [ $? -ne 0 ]; then exit 1; fi
+
+    echo "Pre-flight checks passed!"
+  displayName: 'Pre-flight validation'
+```
+
+---
+
+## Validações Futuras (Roadmap)
+
+- [ ] Cost estimation validation (dentro do budget)
+- [ ] RBAC permissions check
+- [ ] Network security rules validation
+- [ ] Health probe endpoint exists
+- [ ] Application Insights configured
+
+---
+
+## Referências
+
+- [azure.md](../../standards/azure.md) - Padrões Azure
+- [dotnet10-migration.md](../../standards/dotnet10-migration.md) - Breaking changes .NET 10
+- [blazor-efcore.md](../../../../framework/standards/blazor-efcore.md) - EF Core patterns
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

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

@@ -1,101 +1,122 @@
-# Create MORPH Feature Proposal
-
-Crie uma nova proposta de feature seguindo o workflow MORPH.
-
-## Contexto
-
-Leia os seguintes arquivos para entender o projeto:
-- `.morph/project/context/README.md` - Contexto do projeto
-- `framework/standards/` e `.morph/project/standards/` - Padrões técnicos
-- `.morph/config/agents.json` - Agentes disponíveis
-
-## Workflow
-
-1. **Detecte agentes automaticamente**:
-   ```bash
-   node bin/detect-agents.js "$ARGUMENTS"
-   ```
-   Isso retorna quais agentes devem ser ativados baseado em keywords.
-
-2. **Invoque skills dos agentes detectados**:
-   - Para agentes com `skillPath` em agents.json, invoque o Skill correspondente
-   - Exemplo: Se detectou `uiux-designer`, consulte `.claude/skills/specialists/ui-ux-designer.md`
-   - Skills contêm conhecimento especializado, workflows e prompts detalhados
-   - Use conhecimento dos skills para enriquecer a proposta
-
-3. **Analise a solicitação** e identifique:
-   - Problema a resolver
-   - Usuários afetados
-   - Impacto esperado
-
-4. **Crie a estrutura da feature**:
-   ```
-   .morph/project/outputs/{feature-name}/
-   ├── proposal.md    # Proposta inicial
-   ├── spec.md        # Especificação técnica (iniciar)
-   └── tasks.json     # Lista de tasks (iniciar)
-   ```
-
-5. **Preencha `proposal.md`** baseado em `framework/templates/proposal.md`:
-   - Problem Statement
-   - Proposed Solution
-   - Success Metrics
-   - Scope (In/Out)
-   - Estimated Effort
-   - Cost Impact
-   - **Agents Activated** (lista dos agentes detectados)
-
-6. **Inicie `spec.md`** com:
-   - User Stories principais
-   - Arquitetura proposta
-   - Data Model inicial
-
-7. **Inicie `tasks.json`** com:
-   - Tasks de alto nível identificadas (formato JSON)
-   - Checkpoints sugeridos
-
-## State Management
-
-Após criar o proposal, **SEMPRE** registre a feature no state.json:
-
-```bash
-# Criar entrada no state
-node bin/state-manager.js set {feature-name} status draft
-node bin/state-manager.js set {feature-name} phase proposal
-
-# Marcar output como criado
-node bin/state-manager.js mark-output {feature-name} proposal
-
-# Adicionar agentes ativados (todos os detectados)
-# Parsear output do detect-agents.js e adicionar cada um:
-for agent in $(node bin/detect-agents.js --ids-only "$ARGUMENTS"); do
-  node bin/state-manager.js add-agent {feature-name} $agent
-done
-```
-
-**Exemplo completo:**
-```bash
-# Detectar e registrar agentes
-AGENTS=$(node bin/detect-agents.js --ids-only "implementar dashboard com charts")
-# Retorna: standards-architect, azure-architect, ..., uiux-designer
-
-# Para cada agente
-echo "$AGENTS" | while read agent; do
-  node bin/state-manager.js add-agent my-feature "$agent"
-done
-```
-
-## Output
-
-Ao final, apresente:
-1. Resumo da proposta
-2. Agentes ativados (e registrados no state)
-3. Custo estimado
-4. Perguntas de clarificação (se houver)
-5. Solicitar aprovação para prosseguir para DESIGN
-
-**IMPORTANTE:** Confirme que a feature foi registrada no state.json executando `node bin/state-manager.js list`.
-
----
-
-**Feature solicitada:** $ARGUMENTS
+# MORPH Spec Pipeline
+
+Crie ou retome o planejamento de uma feature, guiando automaticamente pelas fases 0→4 com pausas obrigatórias.
+
+---
+
+## 1. Resume Logic
+
+Primeiro, verifique se a feature já existe:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+- **Se existe:** Identifique a fase atual e retome de onde parou (pular fases já concluídas)
+- **Se não existe:** Iniciar do zero (FASE 0)
+
+---
+
+## 2. FASE 0: PROPOSAL
+
+### Workflow
+
+1. **Detecte agentes automaticamente:**
+   ```bash
+   npx morph-spec detect-agents "$ARGUMENTS"
+   ```
+
+2. **Invoque skills dos agentes detectados:**
+   - Para agentes com `skillPath` em agents.json, consulte o Skill correspondente
+   - Use conhecimento dos skills para enriquecer a proposta
+
+3. **Analise a solicitação** e identifique: problema, usuários afetados, impacto
+
+4. **Crie a estrutura:**
+   ```
+   .morph/project/outputs/{feature-name}/
+   ├── proposal.md
+   ├── spec.md (iniciar)
+   └── tasks.json (iniciar)
+   ```
+
+5. **Preencha `proposal.md`** baseado em `framework/templates/proposal.md`
+
+6. **Registre no state:**
+   ```bash
+   npx morph-spec state set {feature-name} status draft
+   npx morph-spec state set {feature-name} phase proposal
+   npx morph-spec state mark-output {feature-name} proposal
+   # Adicionar cada agente detectado:
+   npx morph-spec state add-agent {feature-name} {agent-id}
+   ```
+
+### PAUSA OBRIGATORIA
+
+Apresente: resumo da proposta, agentes ativados, custo estimado, 3 itens de pausa.
+
+---
+
+## 3. Após Aprovação do Proposal → FASE 1: SETUP (auto, sem pausa)
+
+**Ler:** `.claude/skills/workflows/phase-setup.md` para instruções detalhadas.
+
+Resumo: carregar contexto do projeto, confirmar stack, listar agentes ativos, atualizar state.
+
+**Não pausa aqui.** Continuar automaticamente.
+
+---
+
+## 4. FASE 1.5: UI/UX (condicional)
+
+Verificar se `uiux-designer` está nos `activeAgents`:
+- **Se SIM:** Ler `.claude/skills/workflows/phase-uiux.md` e executar. **PAUSA OBRIGATORIA** após gerar deliverables UI.
+- **Se NÃO:** Pular para FASE 2.
+
+---
+
+## 5. FASE 2: DESIGN
+
+**Ler:** `.claude/skills/workflows/phase-design.md` para instruções detalhadas.
+
+Resumo: gerar spec.md, contracts.cs, decisions.md com ADRs, estimar custos.
+
+### PAUSA OBRIGATORIA
+
+Apresente: spec, contracts, decisions, custos. 3 itens de pausa (aprovar, ajustar escopo, modificar contracts).
+
+---
+
+## 6. Após Aprovação do Design → FASE 3: CLARIFY (interativo)
+
+**Ler:** `.claude/skills/workflows/phase-clarify.md` para instruções detalhadas.
+
+Resumo: identificar ambiguidades, gerar 3-7 perguntas, aguardar respostas, atualizar spec com clarificações e edge cases.
+
+**Aguardar respostas do usuário antes de continuar.**
+
+---
+
+## 7. FASE 4: TASKS
+
+**Ler:** `.claude/skills/workflows/phase-tasks.md` para instruções detalhadas.
+
+Resumo: quebrar spec em tasks T001-TXXX, definir dependências, checkpoints, estimativas.
+
+### PAUSA OBRIGATORIA
+
+Apresente: breakdown de tasks, ordem de execução, estimativa total. 3 itens de pausa (aprovar, repriorizar, adicionar/remover).
+
+---
+
+## 8. Planejamento Completo
+
+Após aprovação das tasks:
+
+```
+Planejamento completo! Execute /morph-apply {feature-name} para iniciar implementação.
+```
+
+---
+
+**Feature solicitada:** $ARGUMENTS

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

@@ -1,86 +1,86 @@
-# MORPH Project Status
-
-Mostre o status atual do projeto MORPH e features em desenvolvimento.
-
-## Como Usar
-
-**SEMPRE** use o state-manager CLI para obter status:
-
-```bash
-node bin/state-manager.js list
-```
-
-Este comando automaticamente mostra:
-- Todas as features ativas
-- Fase atual de cada feature
-- Progresso de tasks (X/Y)
-- Agentes ativos
-- Custos estimados
-
-## Verificações Adicionais
-
-### 1. Configuração MORPH
-- [ ] `.morph/project.md` existe e está preenchido
-- [ ] `.morph/config/config.json` configurado
-- [ ] `.morph/standards/` presentes
-
-### 2. Detalhes de Feature Específica
-
-Para obter JSON detalhado de uma feature:
-
-```bash
-node bin/state-manager.js get {feature-name}
-```
-
-### 3. Features Arquivadas
-
-Verifique `.morph/project/archive/` manualmente se necessário:
-- Quantas features concluídas
-- Tempo total gasto
-- Custo acumulado
-
-### 4. Specs Ativas
-
-Verifique `.morph/project/specs/` para specs consolidadas.
-
-## Output
-
-O comando `node bin/state-manager.js list` automaticamente gera um dashboard formatado:
-
-```
-╔════════════════════════════════════════════════════════════════╗
-║                    MORPH-SPEC PROJECT STATUS                   ║
-╠════════════════════════════════════════════════════════════════╣
-║ Project: {PROJECT_NAME}                                        ║
-║ Type: blazor-server                                            ║
-╠════════════════════════════════════════════════════════════════╣
-║ FEATURES                                                       ║
-╠════════════════════════════════════════════════════════════════╣
-║ 📝 {feature-1}                                                 ║
-║    Phase: implement        │ Tasks: 5/12                       ║
-║    Agents: blazor-builder ef-modeler hangfire-orchestrator     ║
-╠════════════════════════════════════════════════════════════════╣
-║ 📝 {feature-2}                                                 ║
-║    Phase: design           │ Tasks: 0/0                        ║
-║    Agents: None                                                ║
-╠════════════════════════════════════════════════════════════════╣
-║ SUMMARY                                                        ║
-╠════════════════════════════════════════════════════════════════╣
-║ Total Features: 2                                              ║
-║ Completed: 0                                                   ║
-║ Estimated Cost: $5.50/month                                    ║
-╚════════════════════════════════════════════════════════════════╝
-```
-
-**Simplesmente execute o comando e mostre o resultado ao usuário.**
-
-## Ações Disponíveis
-
-Sugira próximas ações:
-- `/morph-proposal {feature}` - Criar nova feature
-- `/morph-apply {feature}` - Implementar feature
-- `/morph-archive {feature}` - Arquivar feature concluída
-
----
-
-$ARGUMENTS
+# MORPH Project Status
+
+Mostre o status atual do projeto MORPH e features em desenvolvimento.
+
+## Como Usar
+
+**SEMPRE** use o state-manager CLI para obter status:
+
+```bash
+npx morph-spec state list
+```
+
+Este comando automaticamente mostra:
+- Todas as features ativas
+- Fase atual de cada feature
+- Progresso de tasks (X/Y)
+- Agentes ativos
+- Custos estimados
+
+## Verificações Adicionais
+
+### 1. Configuração MORPH
+- [ ] `.morph/project.md` existe e está preenchido
+- [ ] `.morph/config/config.json` configurado
+- [ ] `.morph/standards/` presentes
+
+### 2. Detalhes de Feature Específica
+
+Para obter JSON detalhado de uma feature:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+### 3. Features Arquivadas
+
+Verifique `.morph/project/archive/` manualmente se necessário:
+- Quantas features concluídas
+- Tempo total gasto
+- Custo acumulado
+
+### 4. Specs Ativas
+
+Verifique `.morph/project/specs/` para specs consolidadas.
+
+## Output
+
+O comando `npx morph-spec state list` automaticamente gera um dashboard formatado:
+
+```
+╔════════════════════════════════════════════════════════════════╗
+║                    MORPH-SPEC PROJECT STATUS                   ║
+╠════════════════════════════════════════════════════════════════╣
+║ Project: {PROJECT_NAME}                                        ║
+║ Type: blazor-server                                            ║
+╠════════════════════════════════════════════════════════════════╣
+║ FEATURES                                                       ║
+╠════════════════════════════════════════════════════════════════╣
+║ 📝 {feature-1}                                                 ║
+║    Phase: implement        │ Tasks: 5/12                       ║
+║    Agents: blazor-builder ef-modeler hangfire-orchestrator     ║
+╠════════════════════════════════════════════════════════════════╣
+║ 📝 {feature-2}                                                 ║
+║    Phase: design           │ Tasks: 0/0                        ║
+║    Agents: None                                                ║
+╠════════════════════════════════════════════════════════════════╣
+║ SUMMARY                                                        ║
+╠════════════════════════════════════════════════════════════════╣
+║ Total Features: 2                                              ║
+║ Completed: 0                                                   ║
+║ Estimated Cost: $5.50/month                                    ║
+╚════════════════════════════════════════════════════════════════╝
+```
+
+**Simplesmente execute o comando e mostre o resultado ao usuário.**
+
+## Ações Disponíveis
+
+Sugira próximas ações:
+- `/morph-proposal {feature}` - Criar nova feature
+- `/morph-apply {feature}` - Implementar feature
+- `/morph-archive {feature}` - Arquivar feature concluída
+
+---
+
+$ARGUMENTS