@polymorphism-tech/morph-spec 2.3.0 → 3.0.0

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

@@ -0,0 +1,164 @@
+# MORPH Tasks - FASE 4
+
+> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+
+Quebre a especificação em tasks executáveis, defina ordem de execução e estabeleça checkpoints.
+
+## Pré-requisitos
+
+- [ ] FASE 3 (Clarify) concluída
+- [ ] `spec.md` atualizado com clarificações
+- [ ] Todos os edge cases documentados
+
+## Workflow
+
+### Passo 1: Analisar Spec
+
+Leia `.morph/project/outputs/{feature}/spec.md` e identifique:
+
+1. **Requisitos funcionais** (FR001, FR002, ...)
+2. **Componentes técnicos** (Entities, Services, Controllers, Pages)
+3. **Infraestrutura** (Bicep, migrations, configs)
+4. **Testes** (Unit tests, integration tests)
+
+### Passo 2: Quebrar em Tasks
+
+Crie tasks no formato **T{NNN}** seguindo ordem lógica de implementação.
+
+#### 2.1. Estrutura de Task
+
+```json
+{
+  "id": "T001",
+  "title": "Criar Entity {Nome}",
+  "description": "Implementar entity {Nome} com propriedades X, Y, Z seguindo padrões EF Core",
+  "category": "domain",
+  "dependencies": [],
+  "estimatedMinutes": 30,
+  "status": "pending",
+  "specSections": ["## Domain Model", "## Business Rules"],
+  "contractInterfaces": ["I{Nome}Repository"],
+  "files": [
+    "Domain/Entities/{Nome}.cs",
+    "Infrastructure/Data/Configurations/{Nome}Configuration.cs"
+  ]
+}
+```
+
+#### 2.2. Categorias de Tasks
+
+| Categoria | Descrição | Exemplos |
+|-----------|-----------|----------|
+| **domain** | Entities, Value Objects, Enums | Entity, DomainException |
+| **application** | Services, DTOs, Interfaces | Service, Validator, Mapper |
+| **infrastructure** | DbContext, Repositories, External APIs | EF Config, Repository impl |
+| **presentation** | Controllers, Pages, Components | API endpoint, Blazor page |
+| **tests** | Unit tests, Integration tests | Service tests, API tests |
+| **infra** | Bicep, Migrations, Scripts | Azure resources, DB migration |
+| **docs** | README, API docs, Swagger | OpenAPI spec, README update |
+
+#### 2.3. Ordem de Implementação
+
+**Bottom-up approach:**
+```
+1. Domain (Entities, Enums, Value Objects)
+   ↓
+2. Infrastructure (Repositories, DbContext configs)
+   ↓
+3. Application (Services, DTOs, Business logic)
+   ↓
+4. Presentation (Controllers, Pages, Components)
+   ↓
+5. Tests (Unit → Integration)
+   ↓
+6. Infra (Bicep, Migrations, Deploy scripts)
+   ↓
+7. Docs (README, Swagger, Comments)
+```
+
+### Passo 3: Definir Dependências
+
+Para cada task, especifique dependências:
+
+```json
+{
+  "id": "T005",
+  "title": "Criar {Nome}Service",
+  "dependencies": ["T001", "T002"],
+  "status": "pending"
+}
+```
+
+**Regra:** Task só pode ser executada quando todas as dependências estão `completed`.
+
+### Passo 4: Estabelecer Checkpoints
+
+Defina checkpoints a cada **3 tasks** ou **marcos significativos**:
+
+```json
+{
+  "id": "CHECKPOINT_001",
+  "title": "Domain Layer Completo",
+  "afterTasks": ["T001", "T002", "T003"],
+  "validations": [
+    "Todas as entities criadas",
+    "Migrations aplicadas",
+    "Testes de domain passando"
+  ]
+}
+```
+
+### Passo 5: Estimar Esforço
+
+Para cada task, estime tempo em minutos:
+
+| Complexidade | Tempo Estimado |
+|--------------|----------------|
+| Trivial (CRUD básico) | 15-30 min |
+| Simples (Service, Controller) | 30-60 min |
+| Média (Business logic, validações) | 60-120 min |
+| Complexa (Integrações, AI) | 120-240 min |
+
+### Passo 6: Gerar `tasks.json`
+
+Crie `.morph/project/outputs/{feature}/tasks.json` com a estrutura completa de tasks, checkpoints e estimativas.
+
+### Passo 7: Incluir Tasks de IaC (se necessário)
+
+Se houver recursos Azure, adicionar tasks de Bicep e migrations.
+
+### Passo 8: Atualizar State
+
+```bash
+npx morph-spec state set {feature-name} phase tasks
+npx morph-spec state set {feature-name} tasks.total {N}
+npx morph-spec state mark-output {feature-name} tasks
+```
+
+## Outputs Gerados
+
+- `.morph/project/outputs/{feature}/tasks.json` - Breakdown completo de tasks
+
+## PAUSA OBRIGATÓRIA
+
+Apresente ao usuário 3 ações sugeridas:
+
+1. **Aprovar breakdown e iniciar implementação**
+2. **Repriorizar tasks** - Mudar ordem de execução
+3. **Adicionar/remover tasks** - Ajustar escopo
+
+## Critérios de Avanço
+
+- [x] `tasks.json` criado com todas as tasks
+- [x] Tasks categorizadas corretamente
+- [x] Dependências mapeadas
+- [x] Checkpoints definidos (a cada 3 tasks)
+- [x] Esforço estimado por task
+- [x] Ordem de execução clara
+- [x] Tasks de IaC incluídas (se aplicável)
+- [x] State atualizado com total de tasks
+- [x] Usuário aprovou breakdown
+
+---
+
+Após aprovação: "Planejamento completo! Execute `/morph-apply {feature}` para iniciar implementação."

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

@@ -1,211 +1,169 @@
-# MORPH UI/UX Design - FASE 1.5
-
-Fase obrigatória para features com front-end. Coleta requisitos de UI/UX, gera wireframes, specs de componentes e fluxos de usuário.
-
-## Uso
-
-```
-/morph-uiux {feature-name}
-```
-
-## Pré-requisitos
-
-- [ ] FASE 1 (Setup) concluída
-- [ ] Feature tem keywords de UI detectadas (blazor, ui, component, page, dashboard, wizard, form, chart)
-- [ ] `uiux-designer` agent ativado
-
-## Workflow
-
-### Passo 1: Detectar Se Fase É Necessária
-
-Verifique se agentes ativos incluem `uiux-designer`:
-
-```bash
-node bin/state-manager.js get {feature-name}
-```
-
-Se `uiux-designer` NÃO estiver nos `activeAgents`, pule esta fase e vá para `/morph-design`.
-
-### Passo 2: Coletar Input do Usuário
-
-**SEMPRE perguntar ao usuário PRIMEIRO:**
-
-1. **Layout e estilo**:
-   - Você tem alguma ideia de layout em mente?
-   - Tem alguma referência visual? (sites, apps, screenshots)
-   - Como imagina o fluxo do usuário?
-
-2. **Componentes e interações**:
-   - Quais os principais componentes desta tela/página?
-   - Quais estados precisam ser considerados? (loading, error, empty, success)
-
-3. **Imagens de referência**:
-   - Tem imagens de exemplo que eu possa analisar?
-   - Se SIM: use Read tool para ler screenshots e extrair padrões
-
-### Passo 3: Decidir Biblioteca UI
-
-Escolha entre **Fluent UI Blazor** (recomendado para AI-first) ou **MudBlazor** (componentes complexos):
-
-**Critérios:**
-- Fluent UI: Para dashboards, forms simples, AI components, Microsoft design language
-- MudBlazor: Para data grids avançadas, charts complexos, material design
-
-**Documente a decisão:**
-```bash
-# Adicionar ADR em decisions.md
-echo "## ADR: UI Library Choice
-
-Decision: [Fluent UI / MudBlazor]
-
-Rationale:
-- {Justificativa baseada nos requisitos}
-
-Date: $(date +%Y-%m-%d)" >> .morph/project/outputs/{feature}/decisions.md
-```
-
-### Passo 4: Gerar Deliverables
-
-Crie os seguintes arquivos em `.morph/project/outputs/{feature}/`:
-
-#### 4.1. `ui-design-system.md`
-
-Design system com:
-- Paleta de cores (primary, secondary, accent, semantic)
-- Tipografia (heading scales, body text, code)
-- Spacing e layout (grid, margins, paddings)
-- Componentes base (buttons, inputs, cards)
-
-#### 4.2. `ui-mockups.md`
-
-Wireframes ASCII + descrições:
-- Layout geral de cada tela/página
-- Posicionamento de componentes
-- Responsividade (desktop, tablet, mobile)
-- Estados (loading, error, empty, success)
-
-Exemplo:
-```
-┌─────────────────────────────────────────┐
-│  Header                   [🔔] [👤]     │
-├─────────────────────────────────────────┤
-│ ┌─────────┐                             │
-│ │ Sidebar │  Main Content Area          │
-│ │  Menu   │  ┌─────────────────────┐   │
-│ │         │  │ Dashboard Card      │   │
-│ │ • Home  │  │ - Chart            │   │
-│ │ • Data  │  │ - Metrics          │   │
-│ └─────────┘  └─────────────────────┘   │
-└─────────────────────────────────────────┘
-```
-
-#### 4.3. `ui-components.md`
-
-Specs técnicas de componentes Fluent UI/MudBlazor:
-- Componente a usar (FluentButton, MudDataGrid, etc.)
-- Props e configurações
-- Eventos e bindings
-- Validações e estados
-
-Exemplo:
-```markdown
-### DashboardCard Component
-
-**Library:** FluentCard
-**Props:**
-- Title: string
-- Subtitle: string (optional)
-- Loading: bool
-
-**Events:**
-- OnRefresh: EventCallback
-
-**Variants:**
-- Default (outline)
-- Filled (accent color)
-- Error (danger color)
-```
-
-#### 4.4. `ui-flows.md`
-
-Fluxos de usuário completos:
-- User stories
-- Diagramas de fluxo (texto/ASCII)
-- Edge cases (o que acontece se...?)
-- Validações e feedback
-
-Exemplo:
-```
-## Fluxo: Adicionar Item
-
-1. User clica "Adicionar Item"
-2. Modal abre com form
-   - Loading: Skeleton placeholders
-   - Error: Toast notification
-3. User preenche campos
-   - Validação em tempo real
-   - Campos required marcados com *
-4. User clica "Salvar"
-   - Success: Modal fecha + toast "Item adicionado"
-   - Error: Modal permanece + mensagem de erro destacada
-```
-
-### Passo 5: Validar Acessibilidade e Responsividade
-
-Documente nos arquivos UI:
-- **WCAG 2.1 Level AA** compliance
-  - Contraste de cores adequado
-  - Labels acessíveis para screen readers
-  - Navegação por teclado
-- **Responsive breakpoints**
-  - Desktop (>1200px)
-  - Tablet (768px - 1199px)
-  - Mobile (<768px)
-
-### Passo 6: Atualizar State
-
-```bash
-# Marcar fase como uiux-design
-node bin/state-manager.js set {feature-name} phase uiux-design
-
-# Marcar outputs criados
-node bin/state-manager.js mark-output {feature-name} ui-design-system
-node bin/state-manager.js mark-output {feature-name} ui-mockups
-node bin/state-manager.js mark-output {feature-name} ui-components
-node bin/state-manager.js mark-output {feature-name} ui-flows
-```
-
-## Outputs Gerados
-
-- `.morph/project/outputs/{feature}/ui-design-system.md`
-- `.morph/project/outputs/{feature}/ui-mockups.md`
-- `.morph/project/outputs/{feature}/ui-components.md`
-- `.morph/project/outputs/{feature}/ui-flows.md`
-- `.morph/project/outputs/{feature}/decisions.md` (atualizado com ADR UI library)
-
-## ⛔ PAUSA OBRIGATÓRIA
-
-Apresente ao usuário 3 ações sugeridas:
-
-1. ✅ **Aprovar UI/UX e prosseguir para design técnico**
-   Continuar para `/morph-design` (FASE 2)
-
-2. 🎨 **Ajustar wireframes/componentes de telas específicas**
-   Revisar mockups ou adicionar mais detalhes
-
-3. 🔄 **Revisar biblioteca UI escolhida (Fluent UI ↔ MudBlazor)**
-   Mudar decisão se justificado
-
-## Critérios de Avanço
-
-- [x] Input do usuário coletado (layout, referências)
-- [x] Biblioteca UI escolhida e justificada (ADR)
-- [x] 4 deliverables criados (design-system, mockups, components, flows)
-- [x] Acessibilidade WCAG 2.1 documentada
-- [x] Responsividade especificada
-- [x] State atualizado
-- [x] Usuário aprovou UI/UX
-
----
-
-**Feature:** $ARGUMENTS
+# MORPH UI/UX Design - FASE 1.5
+
+> INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
+
+Fase condicional para features com front-end. Coleta requisitos de UI/UX, gera wireframes, specs de componentes e fluxos de usuário.
+
+## Pré-requisitos
+
+- [ ] FASE 1 (Setup) concluída
+- [ ] Feature tem keywords de UI detectadas (blazor, ui, component, page, dashboard, wizard, form, chart)
+- [ ] `uiux-designer` agent ativado
+
+## Workflow
+
+### Passo 0: Verificar Design System Existe
+
+**CRITICAL:** Antes de iniciar a FASE UI/UX, verifique se um design system existe:
+
+```bash
+npx morph-spec detect-agents "{feature description}"
+```
+
+Se nenhum design system for detectado (verificar output):
+
+1. **Opção A - Scaffold automático:**
+   - O sistema criará automaticamente um design system ao avançar para implementação
+   - Você pode gerar manualmente agora: `npx morph-spec generate design-system`
+
+2. **Opção B - Criar manualmente:**
+   - Crie `.morph/project/design-system.md` (project-level, compartilhado)
+   - Ou `.morph/project/outputs/{feature}/ui-design-system.md` (feature-specific)
+
+3. **Opção C - Scan existing CSS:**
+   - Se o projeto já tem CSS com variáveis: `npx morph-spec generate design-system --scan`
+
+**⚠️ IMPORTANTE:**
+- Design system é **obrigatório** para features UI
+- Gate automático bloqueará implementação (FASE 5) se design system não existir
+- Melhor criar agora para garantir consistência visual
+
+### Passo 1: Detectar Se Fase É Necessária
+
+Verifique se agentes ativos incluem `uiux-designer`:
+
+```bash
+npx morph-spec state get {feature-name}
+```
+
+Se `uiux-designer` NÃO estiver nos `activeAgents`, pule esta fase e continue para FASE 2 (Design).
+
+### Passo 2: Coletar Input do Usuário
+
+**SEMPRE perguntar ao usuário PRIMEIRO:**
+
+1. **Layout e estilo**:
+   - Você tem alguma ideia de layout em mente?
+   - Tem alguma referência visual? (sites, apps, screenshots)
+   - Como imagina o fluxo do usuário?
+
+2. **Componentes e interações**:
+   - Quais os principais componentes desta tela/página?
+   - Quais estados precisam ser considerados? (loading, error, empty, success)
+
+3. **Imagens de referência**:
+   - Tem imagens de exemplo que eu possa analisar?
+   - Se SIM: use Read tool para ler screenshots e extrair padrões
+
+### Passo 3: Decidir Biblioteca UI
+
+Escolha entre **Fluent UI Blazor** (recomendado para AI-first) ou **MudBlazor** (componentes complexos):
+
+**Critérios:**
+- Fluent UI: Para dashboards, forms simples, AI components, Microsoft design language
+- MudBlazor: Para data grids avançadas, charts complexos, material design
+
+**Documente a decisão em `decisions.md`.**
+
+### Passo 4: Gerar Deliverables
+
+Crie os seguintes arquivos em `.morph/project/outputs/{feature}/`:
+
+#### 4.1. `ui-design-system.md`
+
+**Se design system project-level existe (`.morph/project/design-system.md`):**
+- Referencie-o nos specs: "Uses project design system at .morph/project/design-system.md"
+- Crie `ui-design-system.md` apenas se houver cores/componentes **específicos** da feature
+
+**Se não existe:**
+- Crie design system feature-level completo com:
+  - Paleta de cores (primary, secondary, accent, semantic)
+  - Tipografia (heading scales, body text, code)
+  - Spacing e layout (grid, margins, paddings)
+  - Componentes base (buttons, inputs, cards)
+
+#### 4.2. `ui-mockups.md`
+
+Wireframes ASCII + descrições:
+- Layout geral de cada tela/página
+- Posicionamento de componentes
+- Responsividade (desktop, tablet, mobile)
+- Estados (loading, error, empty, success)
+
+#### 4.3. `ui-components.md`
+
+Specs técnicas de componentes Fluent UI/MudBlazor:
+- Componente a usar (FluentButton, MudDataGrid, etc.)
+- Props e configurações
+- Eventos e bindings
+- Validações e estados
+
+#### 4.4. `ui-flows.md`
+
+Fluxos de usuário completos:
+- User stories
+- Diagramas de fluxo (texto/ASCII)
+- Edge cases (o que acontece se...?)
+- Validações e feedback
+
+### Passo 5: Validar Acessibilidade e Responsividade
+
+Documente nos arquivos UI:
+- **WCAG 2.1 Level AA** compliance
+  - Contraste de cores adequado
+  - Labels acessíveis para screen readers
+  - Navegação por teclado
+- **Responsive breakpoints**
+  - Desktop (>1200px)
+  - Tablet (768px - 1199px)
+  - Mobile (<768px)
+
+### Passo 6: Atualizar State
+
+```bash
+npx morph-spec state set {feature-name} phase uiux-design
+npx morph-spec state mark-output {feature-name} ui-design-system
+npx morph-spec state mark-output {feature-name} ui-mockups
+npx morph-spec state mark-output {feature-name} ui-components
+npx morph-spec state mark-output {feature-name} ui-flows
+```
+
+## Outputs Gerados
+
+- `.morph/project/outputs/{feature}/ui-design-system.md`
+- `.morph/project/outputs/{feature}/ui-mockups.md`
+- `.morph/project/outputs/{feature}/ui-components.md`
+- `.morph/project/outputs/{feature}/ui-flows.md`
+- `.morph/project/outputs/{feature}/decisions.md` (atualizado com ADR UI library)
+
+## PAUSA OBRIGATÓRIA
+
+Apresente ao usuário 3 ações sugeridas:
+
+1. **Aprovar UI/UX e prosseguir para design técnico**
+2. **Ajustar wireframes/componentes de telas específicas**
+3. **Revisar biblioteca UI escolhida (Fluent UI / MudBlazor)**
+
+## Critérios de Avanço
+
+- [x] Input do usuário coletado (layout, referências)
+- [x] Biblioteca UI escolhida e justificada (ADR)
+- [x] 4 deliverables criados (design-system, mockups, components, flows)
+- [x] Acessibilidade WCAG 2.1 documentada
+- [x] Responsividade especificada
+- [x] State atualizado
+- [x] Usuário aprovou UI/UX
+
+---
+
+Continuar automaticamente para FASE 2 (Design) após aprovação.

package/content/.claude/skills/level-2-domains/README.md

@@ -0,0 +1,14 @@
+# Level 2: Domains
+
+Domain expertise skills organized by squad.
+
+**Purpose:** Skills that provide deep domain knowledge (backend, frontend, infra, quality, ai-agents, integrations).
+
+**Squads:**
+- backend/ - Backend Squad (led by dotnet-senior)
+- frontend/ - Frontend Squad (led by ui-designer)
+- infrastructure/ - Infrastructure Squad (led by azure-architect)
+- quality/ - Quality Squad (coordinated by standards-architect)
+- ai-agents/ - AI/Agent specialists
+- integrations/ - External integration specialists
+- architecture/ - Architecture and planning