@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/framework/skills/level-1-workflows/phase-implement.md

@@ -0,0 +1,254 @@
+---
+name: phase-implement
+description: >
+  MORPH-SPEC Phase 5 (Implement). Executes tasks.md task-by-task with checkpoint validation every 3 tasks, producing code and recap.md. Called by /morph-apply.
+argument-hint: "[feature-name]"
+disable-model-invocation: true
+context: fork
+agent: general-purpose
+user-invocable: false
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
+# MORPH Implement - FASE 5
+
+> INTERNAL: Workflow skill used by /morph-apply during automated phase orchestration. Not a user command.
+
+Implemente as tasks definidas na FASE 4, com checkpoints a cada 3 tasks e recap final.
+
+## Pré-requisitos
+
+- [ ] FASE 4 (Tasks) concluída
+- [ ] `tasks.md` ou `tasks.json` aprovado pelo usuário
+- [ ] Tasks gate (`morph-spec approve $ARGUMENTS tasks`) aprovado
+- [ ] Todos os outputs de design existem (spec.md, contracts.cs, decisions.md)
+
+## Ferramentas Recomendadas
+
+> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
+
+| Ação | Ferramenta | Alternativa |
+|------|------------|-------------|
+| Ler task details | **Read** tasks.json, spec.md, contracts.cs | — |
+| Criar novos arquivos | **Write** source files | — |
+| Modificar arquivos existentes | **Edit** source files | — |
+| Consultar API de biblioteca | **Context7 MCP** `query_docs()` | **WebSearch** + **WebFetch** |
+| Executar migrations | **Supabase MCP** `query()` | **Bash** `npx supabase migration ...` |
+| Build do projeto | **Bash** `dotnet build` ou `npm run build` | — |
+| Rodar testes | **Bash** `dotnet test` ou `npm test` | — |
+| Checkpoint validation | **Bash** `npx morph-spec validate-feature ...` | — |
+| Marcar task concluída | **Bash** `npx morph-spec task done $ARGUMENTS T001` | — |
+| Smoke test no browser | **Playwright MCP** `browser_navigate()` + `browser_snapshot()` | Manual |
+| Verificar erros de console | **Playwright MCP** `browser_console_messages()` | — |
+| Screenshot para recap | **Playwright MCP** `browser_take_screenshot()` | — |
+| Criar PR | **Bash** `gh pr create ...` | **GitHub MCP** `create_pull_request()` |
+| Atualizar state | **Bash** `npx morph-spec state set ...` | — |
+
+**MCPs desta fase:** Supabase (migrations, RLS), Context7 (API lookup), Playwright (smoke test), GitHub (PRs).
+
+**Anti-padrões:**
+- ❌ Task agent para editar um único arquivo (use Edit direto)
+- ✅ Task agent para implementar service layer em 5+ arquivos (multi-file legítimo)
+- ❌ Bash `cat` para criar arquivos (use Write tool)
+- ❌ Bash `sed` para modificar código (use Edit tool)
+- ❌ Implementar sem ler contracts.cs primeiro (contracts são a fonte de verdade!)
+
+---
+
+## Workflow
+
+### CHECKPOINT DE ENTRADA: Verificar Pré-requisitos
+
+**⏸️ Antes de iniciar implementação:**
+
+- [ ] `tasks.md` ou `tasks.json` existe e foi aprovado?
+- [ ] Tasks gate aprovado (`morph-spec approve $ARGUMENTS tasks`)?
+- [ ] `spec.md` atualizado com clarificações?
+- [ ] `contracts.cs` corresponde ao schema real?
+- [ ] Build base do projeto compila sem erros?
+
+```bash
+npx morph-spec state get $ARGUMENTS
+npx morph-spec approval-status $ARGUMENTS
+```
+
+**❌ Se alguma checkbox NÃO estiver marcada:**
+→ Voltar para a fase correspondente
+
+---
+
+### Passo 1: Carregar Contexto Completo
+
+Leia TODOS os outputs antes de implementar:
+
+1. `.morph/features/$ARGUMENTS/3-tasks/tasks.md` — Lista de tasks
+2. `.morph/features/$ARGUMENTS/1-design/spec.md` — Especificação completa
+3. `.morph/features/$ARGUMENTS/1-design/contracts.cs` — Interfaces e DTOs
+4. `.morph/features/$ARGUMENTS/1-design/decisions.md` — ADRs
+5. `.morph/features/$ARGUMENTS/1-design/schema-analysis.md` — Schema real (se existir)
+6. `.morph/features/$ARGUMENTS/2-ui/design-system.md` — Design tokens (se existir)
+
+### Passo 2: Iniciar Primeira Task
+
+```bash
+npx morph-spec task next $ARGUMENTS
+npx morph-spec task start $ARGUMENTS T001
+```
+
+Para cada task:
+
+1. **Ler a task description** completa
+2. **Ler contracts.cs** para DTOs/interfaces relevantes
+3. **Implementar** usando Write (novo) ou Edit (existente)
+4. **Verificar** — build, lint, testes
+5. **Marcar como done:**
+```bash
+npx morph-spec task done $ARGUMENTS T001
+```
+
+### Passo 3: Checkpoint a Cada 3 Tasks
+
+**A cada 3 tasks completadas:**
+
+```bash
+# Save checkpoint
+npx morph-spec checkpoint-save $ARGUMENTS
+
+# Run validation
+npx morph-spec validate-feature $ARGUMENTS --phase implement
+```
+
+**Se validação falhar:**
+1. NÃO avançar para próxima task
+2. Corrigir issues reportados
+3. Re-rodar validação
+4. Só então prosseguir
+
+### Passo 4: Test-Driven Development (Recomendado)
+
+Para cada task de implementação:
+
+1. **Escrever teste primeiro** (unit test para service/domain)
+2. **Rodar teste** — deve falhar (RED)
+3. **Implementar** o mínimo para passar
+4. **Rodar teste** — deve passar (GREEN)
+5. **Refatorar** se necessário (REFACTOR)
+
+```bash
+# .NET
+dotnet test --filter "FullyQualifiedName~{TestClass}"
+
+# Node.js
+npm test -- test/path/to/test.js
+```
+
+### Passo 5: Smoke Test com Playwright (se UI)
+
+Após implementar componentes visuais:
+
+```javascript
+// Navegar para a página
+await mcp__playwright__browser_navigate({ url: 'http://localhost:5000/feature-page' });
+
+// Capturar estado da página
+await mcp__playwright__browser_snapshot();
+
+// Verificar erros de console
+await mcp__playwright__browser_console_messages({ level: 'error' });
+
+// Screenshot para recap
+await mcp__playwright__browser_take_screenshot({ type: 'png' });
+```
+
+### Passo 6: Gerar `recap.md`
+
+Após TODAS as tasks completadas:
+
+```bash
+npx morph-spec generate recap $ARGUMENTS
+```
+
+Ou crie manualmente `.morph/features/$ARGUMENTS/4-implement/recap.md`:
+
+```markdown
+# Recap — {Feature Name}
+
+## Summary
+{1-2 parágrafos descrevendo o que foi implementado}
+
+## Tasks Completed
+- [x] T001: {título}
+- [x] T002: {título}
+- ...
+
+## Key Decisions During Implementation
+- {Decisão 1}: {Razão}
+- {Decisão 2}: {Razão}
+
+## Files Created/Modified
+{Lista de arquivos}
+
+## Tests
+- Unit tests: X passing
+- Integration tests: Y passing
+
+## Validation Results
+{Output do morph-spec validate-feature}
+
+## Screenshots
+{Se UI, incluir screenshots}
+```
+
+### Passo 7: Atualizar State
+
+```bash
+npx morph-spec state set $ARGUMENTS phase implement
+npx morph-spec state set $ARGUMENTS status done
+npx morph-spec state mark-output $ARGUMENTS recap
+```
+
+---
+
+## Integração com Superpowers
+
+> Disponível quando o plugin `superpowers` está instalado.
+
+| Skill | Quando Usar | Invocação |
+|-------|-------------|-----------|
+| `test-driven-development` | Para cada task de implementação | `Skill(superpowers:test-driven-development)` |
+| `systematic-debugging` | Quando testes falham ou erros inesperados | `Skill(superpowers:systematic-debugging)` |
+| `requesting-code-review` | Após implementação completa | `Skill(superpowers:requesting-code-review)` |
+| `verification-before-completion` | Antes de marcar feature como done | Use `verification-before-completion` (morph-spec version) |
+
+---
+
+## Outputs Gerados
+
+- Código fonte implementado (vários arquivos)
+- Testes unitários e de integração
+- `.morph/features/$ARGUMENTS/4-implement/recap.md` — Resumo da implementação
+
+## Critérios de Conclusão
+
+- [x] Todas as tasks completadas
+- [x] Build compila sem erros
+- [x] Testes passando
+- [x] Validation pipeline passa
+- [x] `recap.md` gerado
+- [x] State atualizado para `status: done`
+- [x] Checkpoints salvos a cada 3 tasks
+
+---
+
+## Outputs desta Fase
+
+<!-- morph:outputs:implement -->
+| Output | Caminho |
+|--------|---------|
+| `recap` | `.morph/features/{feature}/4-implement/recap.md` |
+<!-- /morph:outputs -->
+
+---
+
+Feature completa! Considere criar um PR e rodar `morph-spec session-summary $ARGUMENTS`.

package/framework/skills/level-1-workflows/phase-setup.md

@@ -1,3 +1,12 @@
+---
+name: phase-setup
+description: >
+  MORPH-SPEC Phase 1 (Setup). Reads project context, identifies the stack, activates relevant agents, and creates the feature folder structure. Called at the start of every feature.
+argument-hint: "[feature-name]"
+user-invocable: false
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
 # MORPH Setup - FASE 1
 
 > INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
@@ -10,14 +19,51 @@ Inicialize o contexto e prepare o ambiente para uma feature aprovada.
 - [ ] Proposal foi aprovado pelo usuário
 - [ ] Agentes foram detectados e registrados no state
 
+## Ferramentas Recomendadas
+
+> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
+
+| Ação | Ferramenta | Alternativa |
+|------|------------|-------------|
+| Verificar state | **Bash** `npx morph-spec state get` | — |
+| Detectar agentes + standards | **Bash** `npx morph-spec detect-agents --json` | — |
+| Ler contexto do projeto | **Read** `.morph/context/README.md` | — |
+| Ler config | **Read** `.morph/config.json` | — |
+| Escanear estrutura do projeto | **Glob** `src/**/*.{ts,tsx,cs}` | — |
+| Metadata do repositório | **GitHub MCP** `get_repo()` | **Bash** `gh repo view --json` |
+| Atualizar state | **Bash** `npx morph-spec state set` | — |
+
+**MCPs desta fase:** GitHub (opcional — metadata do repo).
+
+**Anti-padrões:**
+- ❌ Task agent para detectar stack (detect-agents CLI já faz isso)
+- ❌ WebSearch para info local do projeto (use Read/Glob)
+- ❌ Ler agents.json manualmente (detect-agents retorna standards processados)
+
+---
+
 ## Workflow
 
+### CHECKPOINT DE ENTRADA: Verificar Pré-requisitos
+
+**⏸️ Antes de prosseguir com setup:**
+
+- [ ] `proposal.md` existe em `.morph/features/$ARGUMENTS/`?
+- [ ] Proposal foi apresentado e aprovado pelo usuário?
+- [ ] Feature foi registrada no state?
+
+**❌ Se alguma checkbox NÃO estiver marcada:**
+→ Voltar para FASE 0 (Proposal)
+
+---
+
 ### Passo 1: Verificar State
 
 Confirme que a feature existe no state:
 
 ```bash
-npx morph-spec state get {feature-name}
+npx morph-spec state get $ARGUMENTS
 ```
 
 Se não existir, volte para FASE 0 (proposal).
@@ -45,13 +91,13 @@ O output JSON contém `standardsSummary` com todos os standards relevantes para
 ```
 
 **Standards resolution order** (automático):
-1. `.morph/project/standards/*.md` (project overrides - highest priority)
-2. `.morph/standards/*.md` (AI Agent Framework, Azure)
+1. `.morph/context/*.md` (project overrides - highest priority)
+2. `.morph/framework/standards/*.md` (AI Agent Framework, Azure)
 3. `framework/standards/*.md` (Blazor, CSS, .NET)
-4. `.morph/project/standards/inferred.md` (always loaded if exists)
+4. `.morph/context/inferred.md` (always loaded if exists)
 
 **Contexto geral** (leia manualmente):
-- `.morph/project/context/README.md` - Overview do projeto
+- `.morph/context/README.md` - Overview do projeto
 - `.morph/config.json` - Configurações
 
 ### Passo 3: Confirmar Stack
@@ -66,18 +112,18 @@ Baseado no proposal e contexto, confirme:
 Mostre os agentes detectados no proposal:
 
 ```bash
-npx morph-spec state get {feature-name}
+npx morph-spec state get $ARGUMENTS
 ```
 
-Parse o JSON e liste os `activeAgents` com seus emojis e responsabilidades (consulte `.morph/config/agents.json`).
+Parse o JSON e liste os `activeAgents` com seus emojis e responsabilidades (consulte `.morph/framework/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
+npx morph-spec state set $ARGUMENTS phase setup
+npx morph-spec state set $ARGUMENTS status in_progress
 ```
 
 ## Outputs
@@ -103,4 +149,24 @@ npx morph-spec state set {feature-name} status in_progress
 
 ---
 
-Continuar automaticamente para próxima fase (UI/UX se detectado, ou Design).
+## Integração com Superpowers
+
+> Disponível quando o plugin `superpowers` está instalado.
+
+| Skill | Quando Usar | Invocação |
+|-------|-------------|-----------|
+| `using-git-worktrees` | Se feature requer isolamento do workspace | `Skill(superpowers:using-git-worktrees)` |
+
+---
+
+## Outputs desta Fase
+
+<!-- morph:outputs:proposal -->
+| Output | Caminho |
+|--------|---------|
+| `proposal` | `.morph/features/{feature}/0-proposal/proposal.md` |
+<!-- /morph:outputs -->
+
+---
+
+Continuar automaticamente para próxima fase (UI/UX se detectado, ou Design).

package/framework/skills/level-1-workflows/phase-tasks.md

@@ -1,3 +1,13 @@
+---
+name: phase-tasks
+description: >
+  MORPH-SPEC Phase 4 (Tasks). Breaks the approved design into ordered implementation tasks with dependencies and checkpoints, producing tasks.md. Called after clarifications resolve.
+argument-hint: "[feature-name]"
+disable-model-invocation: true
+user-invocable: false
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
 # MORPH Tasks - FASE 4
 
 > INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
@@ -10,11 +20,61 @@ Quebre a especificação em tasks executáveis, defina ordem de execução e est
 - [ ] `spec.md` atualizado com clarificações
 - [ ] Todos os edge cases documentados
 
+## Ferramentas Recomendadas
+
+> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
+
+| Ação | Ferramenta | Alternativa |
+|------|------------|-------------|
+| Ler spec + contracts + decisions | **Read** todos os outputs | — |
+| Analisar complexidade de implementação | **Grep** padrões no código existente | — |
+| Contar padrões similares existentes | **Glob** `**/Services/**/*.cs` | — |
+| Consultar padrões de implementação | **Context7 MCP** `query_docs()` | **WebSearch** |
+| Criar issues no GitHub a partir das tasks | **GitHub MCP** `create_issue()` | **Bash** `gh issue create ...` |
+| Renderizar template de tasks | **Bash** `npx morph-spec template render docs/tasks ...` | — |
+| Atualizar state com total de tasks | **Bash** `npx morph-spec state set ... tasks.total N` | — |
+
+**MCPs desta fase:** Context7 (estimar complexidade), GitHub (criar issues).
+
+**Anti-padrões:**
+- ❌ Task agent para quebrar spec simples (faça diretamente)
+- ✅ Task agent para specs complexos com 50+ requisitos (análise legítima multi-step)
+- ❌ Criar tasks.json sem ler todos os outputs primeiro
+
+---
+
 ## Workflow
 
+### CHECKPOINT DE ENTRADA: Verificar Pré-requisitos
+
+**⏸️ PAUSE - Antes de iniciar o breakdown de tasks:**
+
+- [ ] `spec.md` existe e foi aprovado pelo usuário?
+- [ ] `contracts.cs` existe e corresponde ao schema real?
+- [ ] `schema-analysis.md` foi validado (se aplicável)?
+- [ ] `decisions.md` contém ADRs para todas as escolhas críticas?
+- [ ] Design gate (`morph-spec approve $ARGUMENTS design`) foi aprovado?
+- [ ] Clarificações (FASE 3) foram resolvidas e spec atualizado?
+
+**❌ Se alguma checkbox NÃO estiver marcada:**
+→ Voltar para a fase correspondente e resolver
+
+**✅ Se TODAS as checkboxes estiverem marcadas:**
+→ Prosseguir para análise e breakdown
+
+```bash
+# Verificar estado atual:
+npx morph-spec state get $ARGUMENTS
+# Verificar se design foi aprovado:
+npx morph-spec approval get $ARGUMENTS design
+```
+
+---
+
 ### Passo 1: Analisar Spec
 
-Leia `.morph/project/outputs/{feature}/spec.md` e identifique:
+Leia `.morph/features/$ARGUMENTS/1-design/spec.md` e identifique:
 
 1. **Requisitos funcionais** (FR001, FR002, ...)
 2. **Componentes técnicos** (Entities, Services, Controllers, Pages)
@@ -121,7 +181,7 @@ Para cada task, estime tempo em minutos:
 
 ### Passo 6: Gerar `tasks.json`
 
-Crie `.morph/project/outputs/{feature}/tasks.json` com a estrutura completa de tasks, checkpoints e estimativas.
+Crie `.morph/features/$ARGUMENTS/3-tasks/tasks.md` com a estrutura completa de tasks, checkpoints e estimativas.
 
 ### Passo 7: Incluir Tasks de IaC (se necessário)
 
@@ -130,14 +190,14 @@ 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
+npx morph-spec state set $ARGUMENTS phase tasks
+npx morph-spec state set $ARGUMENTS tasks.total {N}
+npx morph-spec state mark-output $ARGUMENTS tasks
 ```
 
 ## Outputs Gerados
 
-- `.morph/project/outputs/{feature}/tasks.json` - Breakdown completo de tasks
+- `.morph/features/$ARGUMENTS/3-tasks/tasks.md` - Breakdown completo de tasks
 
 ## PAUSA OBRIGATÓRIA
 
@@ -161,4 +221,25 @@ Apresente ao usuário 3 ações sugeridas:
 
 ---
 
-Após aprovação: "Planejamento completo! Execute `/morph-apply {feature}` para iniciar implementação."
+## Integração com Superpowers
+
+> Disponível quando o plugin `superpowers` está instalado.
+
+| Skill | Quando Usar | Invocação |
+|-------|-------------|-----------|
+| `writing-plans` | Após breakdown de tasks, para planejar sequência de implementação | `Skill(superpowers:writing-plans)` |
+| `executing-plans` | Para executar o plano de tasks em sessão separada | `Skill(superpowers:executing-plans)` |
+
+---
+
+## Outputs desta Fase
+
+<!-- morph:outputs:tasks -->
+| Output | Caminho |
+|--------|---------|
+| `tasks` | `.morph/features/{feature}/3-tasks/tasks.md` |
+<!-- /morph:outputs -->
+
+---
+
+Após aprovação: "Planejamento completo! Execute `/morph-apply $ARGUMENTS` para iniciar implementação."

package/framework/skills/level-1-workflows/phase-uiux.md

@@ -1,3 +1,12 @@
+---
+name: phase-uiux
+description: >
+  MORPH-SPEC Phase 1.5 (UI/UX). Creates design-system.md, mockups.md, components.md, and flows.md before technical spec. Auto-activates for features with UI keywords.
+argument-hint: "[feature-name]"
+user-invocable: false
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
 # MORPH UI/UX Design - FASE 1.5
 
 > INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
@@ -10,6 +19,36 @@ Fase condicional para features com front-end. Coleta requisitos de UI/UX, gera w
 - [ ] Feature tem keywords de UI detectadas (blazor, ui, component, page, dashboard, wizard, form, chart)
 - [ ] `uiux-designer` agent ativado
 
+## Ferramentas Recomendadas
+
+> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
+
+| Ação | Ferramenta | Alternativa |
+|------|------------|-------------|
+| Verificar design system existente | **Read** `.morph/context/design-system.md` | — |
+| Ler screenshots do usuário | **Read** (arquivo de imagem) | — |
+| Buscar variáveis CSS existentes | **Grep** `--root:` em `*.css,*.scss` | — |
+| Encontrar componentes existentes | **Glob** `**/Components/**/*.razor` ou `**/components/**/*.tsx` | — |
+| Extrair design tokens do Figma | **Figma MCP** `get_file({ fileKey })` | Read CSS/SCSS variables |
+| Documentação de componentes UI | **Context7 MCP** `query_docs({ libraryId, query })` | **WebSearch** + **WebFetch** |
+| Preview de página existente | **Playwright MCP** `browser_navigate()` + `browser_take_screenshot()` | **WebFetch** URL |
+| Inspecionar estrutura da página | **Playwright MCP** `browser_snapshot()` | **WebFetch** + parse manual |
+| Testar layout responsivo | **Playwright MCP** `browser_resize()` + `browser_take_screenshot()` | Manual testing |
+| Referências de design externas | **WebSearch** + **WebFetch** | — |
+| Renderizar templates UI | **Bash** `npx morph-spec template render docs/ui-mockups ...` | — |
+| Gerar design system de CSS existente | **Bash** `npx morph-spec generate design-system --scan` | — |
+| Atualizar state | **Bash** `npx morph-spec state mark-output ...` | — |
+
+**MCPs desta fase:** Figma (design tokens), Playwright (preview, inspeção, responsividade), Context7 (docs de componentes).
+
+**Anti-padrões:**
+- ❌ WebSearch para docs MudBlazor (use Context7 MCP — mais preciso)
+- ❌ Task agent para ler um screenshot (use Read direto na imagem)
+- ❌ Adivinhar props de componentes (use Context7 para API real)
+
+---
+
 ## Workflow
 
 ### Passo 0: Verificar Design System Existe
@@ -27,8 +66,8 @@ Se nenhum design system for detectado (verificar output):
    - 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)
+   - Crie `.morph/context/design-system.md` (project-level, compartilhado)
+   - Ou `.morph/features/$ARGUMENTS/2-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`
@@ -43,7 +82,7 @@ Se nenhum design system for detectado (verificar output):
 Verifique se agentes ativos incluem `uiux-designer`:
 
 ```bash
-npx morph-spec state get {feature-name}
+npx morph-spec state get $ARGUMENTS
 ```
 
 Se `uiux-designer` NÃO estiver nos `activeAgents`, pule esta fase e continue para FASE 2 (Design).
@@ -77,12 +116,14 @@ Escolha entre **Fluent UI Blazor** (recomendado para AI-first) ou **MudBlazor**
 
 ### Passo 4: Gerar Deliverables
 
-Crie os seguintes arquivos em `.morph/project/outputs/{feature}/`:
+Crie os seguintes arquivos em `.morph/features/$ARGUMENTS/`:
+
+> **Use templates:** Utilize `npx morph-spec template render` para gerar os arquivos a partir dos templates em `.morph/framework/templates/docs/`. Templates disponíveis: `ui-design-system`, `ui-mockups`, `ui-components`, `ui-flows`.
 
 #### 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"
+**Se design system project-level existe (`.morph/context/design-system.md`):**
+- Referencie-o nos specs: "Uses project design system at .morph/context/design-system.md"
 - Crie `ui-design-system.md` apenas se houver cores/componentes **específicos** da feature
 
 **Se não existe:**
@@ -116,6 +157,24 @@ Fluxos de usuário completos:
 - Edge cases (o que acontece se...?)
 - Validações e feedback
 
+### CHECKPOINT: Validar Deliverables UI
+
+**⏸️ PAUSE - Antes de prosseguir para acessibilidade:**
+
+- [ ] Design system definido (project-level ou feature-level)?
+- [ ] Wireframes cobrem TODOS os estados (loading, error, empty, success)?
+- [ ] Componentes especificados com props reais da biblioteca UI escolhida?
+- [ ] Fluxos de usuário completos com edge cases?
+- [ ] Biblioteca UI escolhida documentada como ADR em `decisions.md`?
+
+**❌ Se alguma checkbox NÃO estiver marcada:**
+→ Voltar e completar o deliverable faltante
+
+**✅ Se TODAS as checkboxes estiverem marcadas:**
+→ Prosseguir para validação de acessibilidade
+
+---
+
 ### Passo 5: Validar Acessibilidade e Responsividade
 
 Documente nos arquivos UI:
@@ -131,20 +190,26 @@ Documente nos arquivos UI:
 ### 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
+npx morph-spec state set $ARGUMENTS phase uiux-design
+npx morph-spec state mark-output $ARGUMENTS ui-design-system
+npx morph-spec state mark-output $ARGUMENTS ui-mockups
+npx morph-spec state mark-output $ARGUMENTS ui-components
+npx morph-spec state mark-output $ARGUMENTS ui-flows
 ```
 
+> **Nota sobre formatos:** Os comandos `mark-output` aceitam TANTO kebab-case (`ui-design-system`)
+> QUANTO camelCase (`uiDesignSystem`). Ambos os formatos funcionam igualmente! Use o que for mais
+> confortável para você. Exemplos:
+> - `npx morph-spec state mark-output my-feature uiDesignSystem` ✅
+> - `npx morph-spec state mark-output my-feature ui-design-system` ✅
+
 ## 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)
+- `.morph/features/$ARGUMENTS/2-ui/design-system.md`
+- `.morph/features/$ARGUMENTS/2-ui/mockups.md`
+- `.morph/features/$ARGUMENTS/2-ui/components.md`
+- `.morph/features/$ARGUMENTS/2-ui/flows.md`
+- `.morph/features/$ARGUMENTS/1-design/decisions.md` (atualizado com ADR UI library)
 
 ## PAUSA OBRIGATÓRIA
 
@@ -166,4 +231,17 @@ Apresente ao usuário 3 ações sugeridas:
 
 ---
 
-Continuar automaticamente para FASE 2 (Design) após aprovação.
+## Outputs desta Fase
+
+<!-- morph:outputs:uiux -->
+| Output | Caminho |
+|--------|---------|
+| `uiDesignSystem` | `.morph/features/{feature}/2-ui/design-system.md` |
+| `uiMockups` | `.morph/features/{feature}/2-ui/mockups.md` |
+| `uiComponents` | `.morph/features/{feature}/2-ui/components.md` |
+| `uiFlows` | `.morph/features/{feature}/2-ui/flows.md` |
+<!-- /morph:outputs -->
+
+---
+
+Continuar automaticamente para FASE 2 (Design) após aprovação.