@polymorphism-tech/morph-spec 2.2.0 → 2.4.0

package/content/.morph/docs/workflows/design-impl.md

@@ -0,0 +1,37 @@
+# Workflow: DESIGN IMPLEMENTATION (Protótipo → Código)
+
+> **Layer:** 1 | **Load:** on-keyword | **Keywords:** prototipo, prototype, figma, html para, converter design, replicar, from design
+
+## Critérios
+
+- Protótipo HTML existente (pasta com arquivos .html) ou mockups/screenshots
+- Conversão de design visual para código Blazor funcional
+
+## Fases
+
+### 1. ANÁLISE DO PROTÓTIPO
+- Ler todos os arquivos HTML do protótipo
+- Extrair padrões: cores, fontes, espaçamentos, componentes
+- Mapear HTML classes → CSS classes do Design System
+- **PAUSA:** Confirmar mapeamento
+
+### 2. TASKS (lista de telas)
+- Gerar lista de telas para implementar com ordem de dependências
+- **PAUSA:** Aprovar lista
+
+### 3. IMPLEMENT (por tela)
+- Ler HTML do protótipo + arquivo .razor atual (se existir)
+- Reescrever .razor usando Fluent UI/MudBlazor
+- Adicionar CSS ao design-system.css
+- Build para validar + `morph-spec validate-css`
+
+## Outputs
+recap.md, código .razor implementado, CSS atualizado
+
+## Fases Puladas
+Proposal, Design técnico, Clarify, Sync
+
+## Exemplos
+- "Implementar telas baseado no protótipo em /prototipo/"
+- "Converter HTML do Figma para Blazor"
+- "Replicar design do mockup"

package/content/.morph/docs/workflows/fast-track.md

@@ -0,0 +1,29 @@
+# Workflow: FAST TRACK (Trivial)
+
+> **Layer:** 1 | **Load:** on-keyword | **Keywords:** bug, fix, corrigir, ajustar, hotfix, edge case, cor, css
+
+## Critérios
+
+- ≤ 3 arquivos modificados, ≤ 50 linhas, 0 novos componentes
+- Sem infraestrutura, sem decisões arquiteturais
+
+## Fases
+
+### 1. Quick Analysis (FASE 0+1+2 combinadas)
+- Identifica problema em 2-3 parágrafos
+- Propõe solução direta
+- **PAUSA:** Aprovar ou ajustar?
+
+### 2. Implement & Test
+- Implementa diretamente
+- Testa
+- Cria commit descritivo
+
+## Outputs
+Nenhum (ou apenas commit message detalhado)
+
+## Exemplos
+- "Corrigir validação de CPF no formulário"
+- "Ajustar cor do botão primário"
+- "Hotfix: null pointer na home"
+- "Edge case: validação quando campo vazio"

package/content/.morph/docs/workflows/full-morph.md

@@ -0,0 +1,76 @@
+# Workflow: FULL MORPH (Alta Complexidade)
+
+> **Layer:** 1 | **Load:** on-keyword | **Keywords:** sistema, autenticação, integração, pattern, cqrs, subsistema
+
+## Critérios
+
+- > 10 arquivos, > 500 linhas, múltiplos componentes novos
+- Infraestrutura Azure (Bicep), decisões arquiteturais estratégicas
+
+## Fases (TODAS obrigatórias)
+
+### FASE 0.5: CONTEXT (automática)
+1. Detectar framework MORPH (`@polymorphism-tech/morph-spec`)
+2. Detectar/criar estrutura `.morph/project/`
+3. Análise automática: stack (glob patterns), arquitetura (pastas), configs, UI library
+4. Analisar histórico: decisions.md passados, preferências do usuário
+5. Gerar/atualizar `.morph/project/standards/inferred.md`
+6. Ativar agentes baseado em stack + keywords
+
+### FASE 0: PROPOSAL
+1. `npx morph-spec detect "{user-request}"`
+2. Analisar solicitação, identificar stack, estimar complexidade
+3. Gerar proposal.md, registrar agentes no state.json
+- **⛔ PAUSA:** 3 itens (1 ação + 1 pergunta + 1 sugestão)
+
+### FASE 1: SETUP
+1. Ler `.morph/config.json`
+2. Confirmar stack, ativar agentes, criar pasta outputs
+3. Carregar padrões (framework/standards/ > project/standards/)
+
+### FASE 1.5: UI/UX (condicional - se keywords UI detectadas)
+1. **Perguntar ao usuário:** layout, referências visuais, fluxo, imagens
+2. Analisar referências fornecidas
+3. Gerar deliverables AGNÓSTICOS de biblioteca (ui-mockups, ui-components, ui-flows)
+4. Validar acessibilidade (WCAG 2.1) e responsividade
+- **⛔ PAUSA:** Aprovar / Ajustar wireframes / Adicionar fluxos
+
+### FASE 2: DESIGN
+1. Gerar spec.md com requisitos completos
+2. **DECISION POINTS** (cada um requer aprovação):
+   - Biblioteca UI (Fluent UI vs MudBlazor)
+   - Padrões Arquiteturais (CQRS vs simples, Repository vs EF direto)
+   - Estrutura de Dados (entidades, relacionamentos)
+   - Infraestrutura Azure (recursos, SKUs, custos)
+   - Bibliotecas/SDKs (NuGet packages)
+3. Gerar contracts.cs, documentar decisões em decisions.md
+- **⛔ PAUSA:** Aprovar / Ajustar escopo / Modificar contracts
+
+### FASE 3: CLARIFY
+1. Identificar ambiguidades, fazer perguntas, documentar em spec.md, validar edge cases
+
+### FASE 4: TASKS
+1. Quebrar spec em tasks T001-TXXX, definir ordem, checkpoints, dependências
+- **⛔ PAUSA:** Aprovar / Repriorizar / Adicionar-remover tasks
+
+### FASE 5: IMPLEMENT
+1. Implementar task por task
+2. `npx morph-spec task done {feature} {task-id}` após cada task
+3. Framework gerencia checkpoints automaticamente (a cada 3 tasks)
+4. Gerar recap.md ao final
+
+### FASE 6: SYNC (condicional - se complexidade média/alta)
+1. Revisar decisions.md, categorizar (coding, architecture, azure, integrations, ui-ux)
+2. Promover para `.morph/project/standards/{category}.md`
+3. Gerar commit dedicado de sync
+- **⛔ PAUSA:** Aprovar promoção de decisões para standards
+
+## Outputs Completos
+proposal.md, ui-design-system.md, ui-mockups.md, ui-components.md, ui-flows.md, spec.md, contracts.cs, tasks.json, decisions.md, recap.md
+
+## Exemplos
+- "Sistema de relatórios com jobs agendados Hangfire"
+- "Autenticação completa com Clerk (login, signup, OAuth)"
+- "Dashboard com gráficos, tabelas e filtros complexos"
+- "RAG pipeline com Azure AI Search e embeddings"
+- "Infraestrutura Azure completa com Bicep"

package/content/.morph/docs/workflows/standard.md

@@ -0,0 +1,44 @@
+# Workflow: STANDARD (Média Complexidade)
+
+> **Layer:** 1 | **Load:** on-keyword | **Keywords:** paginação, filtro, refatorar, performance, exportar
+
+## Critérios
+
+- 3-10 arquivos, 50-500 linhas, 1-2 componentes simples
+- Sem infraestrutura complexa, decisões táticas (não estratégicas)
+
+## Fases
+
+### 1. FASE 0: PROPOSAL (simplificada)
+- Análise inicial em 1 parágrafo
+- Detecta agentes relevantes
+- **PAUSA:** Aprovar?
+
+### 2. FASE 2: DESIGN (apenas spec.md)
+- Spec técnico conciso (1-2 páginas)
+- Sem contracts.cs se trivial
+- Decisões táticas em decisions.md
+- **PAUSA:** Aprovar?
+
+### 3. FASE 4: TASKS (se > 5 tasks)
+- Breakdown em tasks
+- **PAUSA:** Aprovar?
+
+### 4. FASE 5: IMPLEMENT
+- Implementa task por task
+- Gera recap.md ao final
+
+## Outputs
+proposal.md, spec.md, recap.md (mínimo necessário)
+
+## Fases Puladas
+- FASE 1 (SETUP) - contexto já carregado
+- FASE 1.5 (UI/UX) - se não tiver front-end significativo
+- FASE 3 (CLARIFY) - se spec for claro
+- FASE 6 (SYNC) - decisões não são estratégicas
+
+## Exemplos
+- "Adicionar paginação na tabela de usuários"
+- "Criar filtro por data no relatório"
+- "Refatorar serviço de email para async"
+- "Adicionar botão de exportar CSV"

package/content/.morph/docs/workflows/ui-refresh.md

@@ -0,0 +1,39 @@
+# Workflow: UI REFRESH (Redesign Visual)
+
+> **Layer:** 1 | **Load:** on-keyword | **Keywords:** redesign, redesenhar, bonito, visual, estetica, modernizar
+
+## Critérios
+
+- Páginas existentes com código funcional
+- Apenas mudanças visuais (CSS, HTML, layout)
+- Sem mudanças em lógica de negócio, sem infraestrutura
+
+## Fases
+
+### 1. ANÁLISE VISUAL (FASE 0+1 combinadas)
+- Listar páginas a redesenhar
+- Identificar componentes compartilhados e design system existente
+- Se protótipo existir: ler e extrair padrões
+- **PAUSA:** Escolher direção estética
+
+### 2. DESIGN SYSTEM (FASE 1.5 simplificada)
+- Definir variáveis CSS novas
+- Listar componentes CSS a criar (checklist)
+- Gerar/atualizar design-system.css
+- **PAUSA:** Aprovar componentes
+
+### 3. IMPLEMENT (por página)
+- Atualizar CSS primeiro, depois cada página .razor
+- Build incremental a cada 2-3 páginas
+- Validar com `morph-spec validate-css`
+
+## Outputs
+design-refresh-checklist.md, CSS atualizado, páginas .razor, recap.md
+
+## Fases Puladas
+Setup completo, Contracts, Tasks detalhadas, Infra, Clarify, Sync
+
+## Exemplos
+- "Redesenhar as páginas do checkout para ficar mais bonito"
+- "Modernizar visual do dashboard"
+- "Aplicar novo design system nas telas existentes"