@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

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

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

@@ -0,0 +1,122 @@
+# Troubleshoot - Buscar Soluções para Erros
+
+Busca soluções para erros e problemas comuns no desenvolvimento .NET/Blazor/Azure.
+
+## Uso
+
+```
+/morph-troubleshoot <descrição do erro ou keywords>
+```
+
+## Exemplos
+
+```bash
+/morph-troubleshoot blazor.web.js 404
+/morph-troubleshoot DbContext second operation
+/morph-troubleshoot Azure.Identity NU1605
+/morph-troubleshoot Include retorna vazio
+/morph-troubleshoot PendingModelChanges
+```
+
+## Workflow de 3 Níveis
+
+### Nível 1: Índice JSON (Primário)
+
+Primeiro, execute o comando CLI para buscar no índice de problemas conhecidos:
+
+```bash
+npx morph-spec troubleshoot {keywords}
+
+# Opções
+--category <cat>     # Filtrar por categoria (blazor, efcore, azure)
+--verbose            # Mostrar conteúdo completo da solução
+--list-categories    # Listar categorias disponíveis
+```
+
+### Nível 2: Grep nos Standards (Automático)
+
+Se o índice retornar poucos resultados, o CLI automaticamente busca nos arquivos:
+- `framework/standards/*.md`
+- `content/.morph/standards/*.md`
+
+### Nível 3: Web Search (Se necessário)
+
+**IMPORTANTE:** Se os níveis 1 e 2 não encontrarem solução, use o tool **WebSearch** nativo do Claude Code para buscar nas seguintes fontes:
+
+**Queries recomendadas:**
+
+```
+# GitHub Issues (.NET)
+site:github.com/dotnet/aspnetcore {erro}
+site:github.com/dotnet/efcore {erro}
+
+# Stack Overflow
+site:stackoverflow.com [blazor] {erro}
+site:stackoverflow.com [entity-framework-core] {erro}
+site:stackoverflow.com [azure] {erro}
+
+# Documentação Microsoft
+site:learn.microsoft.com {erro}
+site:learn.microsoft.com/azure {erro}
+```
+
+**Exemplo de uso do WebSearch:**
+
+Se o usuário perguntar sobre um erro de SignalR:
+1. Primeiro: `npx morph-spec troubleshoot SignalR connection`
+2. Se não encontrar: WebSearch com `site:github.com/dotnet/aspnetcore SignalR connection closed`
+3. Retornar links relevantes formatados
+
+## Categorias Disponíveis
+
+| Categoria | Descrição |
+|-----------|-----------|
+| `blazor` | Blazor Server/WASM, componentes, lifecycle, renderização |
+| `efcore` | Entity Framework Core, DbContext, migrations, queries |
+| `azure` | Azure services, deploy, identity, Key Vault |
+| `auth` | Authentication, authorization, tokens, claims |
+| `deploy` | Deployment, CI/CD, pipelines, containers |
+
+## Formato de Output
+
+Ao encontrar uma solução, apresente no seguinte formato:
+
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔴 CRITICAL: {título do problema}
+
+📁 Arquivo: {caminho do arquivo com solução}
+📂 Seção: {seção específica}
+
+❌ Erro:
+   {padrão de erro que identifica o problema}
+
+💡 Causa:
+   {explicação da causa raiz}
+
+✅ Solução:
+   {código ou passos para resolver}
+
+📚 Ver completo: morph-spec read {arquivo}
+
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Troubleshooting Rápido
+
+### Problemas Mais Comuns
+
+| Erro | Solução Rápida |
+|------|----------------|
+| `blazor.web.js 404` | `<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>` |
+| `PendingModelChangesWarning` | `dotnet ef migrations add <Name>` antes de update |
+| `DbContext second operation` | Usar `IDbContextFactory` para background tasks |
+| `Include() vazio` | Usar `HasMany(x => x.Nav)` em vez de `HasMany<T>()` |
+| `Azure.Identity NU1605` | Especificar versão explícita no .csproj |
+| `Key Vault não carrega` | Não condicionar ao ambiente (IsDevelopment) |
+| `DefaultAzureCredential lento` | Desabilitar credenciais não usadas |
+
+---
+
+**Input:** $ARGUMENTS

package/content/.claude/settings.local.json

@@ -1,15 +1,15 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(dotnet:*)",
-      "Bash(git:*)",
-      "Read",
-      "Write",
-      "Edit",
-      "Glob",
-      "Grep"
-    ],
-    "deny": []
-  },
-  "model": "claude-sonnet-4-20250514"
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(dotnet:*)",
+      "Bash(git:*)",
+      "Read",
+      "Write",
+      "Edit",
+      "Glob",
+      "Grep"
+    ],
+    "deny": []
+  },
+  "model": "claude-sonnet-4-20250514"
+}