@polymorphism-tech/morph-spec 4.7.1 → 4.8.1

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

@@ -1,254 +1,255 @@
----
-name: phase-implement
-description: MORPH-SPEC Phase 5 (Implement). Executes feature tasks using TDD with checkpoint validation every 3 tasks, smoke tests via Playwright, and generates code + recap.md. Use after task list approval when starting feature implementation.
-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/SKILL.md` para guia completo.
-> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
-> **Example:** `references/recap-example.md` — filled-in recap.md showing expected output quality.
-
-| 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 -->
-
----
-
+---
+name: phase-implement
+description: MORPH-SPEC Phase 5 (Implement). Executes feature tasks using TDD with checkpoint validation every 3 tasks, smoke tests via Playwright, and generates code + recap.md. Use after task list approval when starting feature implementation.
+argument-hint: "[feature-name]"
+disable-model-invocation: true
+context: fork
+agent: general-purpose
+user-invocable: false
+cliVersion: "4.8.1"
+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/SKILL.md` para guia completo.
+> **Ref:** `framework/standards/integration/mcp/mcp-tools.md` para referência MCP.
+> **Example:** `references/recap-example.md` — filled-in recap.md showing expected output quality.
+
+| 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`.