@polymorphism-tech/morph-spec 4.8.19 → 4.9.0

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

@@ -1,271 +1,271 @@
----
-name: phase-tasks
-description: MORPH-SPEC Phase 4 (Tasks). Breaks approved spec into bottom-up ordered implementation tasks (T001...TXXX) with dependencies, checkpoints every 3 tasks, and effort estimates, producing tasks.md. Use after design and clarification phases to create a structured implementation plan before coding starts.
-argument-hint: "[feature-name]"
-disable-model-invocation: true
-user-invocable: false
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep
-cliVersion: "4.8.19"
----
-
-# 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
-
-## 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/tasks-example.md` — filled-in tasks.md showing expected granularity and format.
-> **Script:** `scripts/validate-tasks.mjs` — validates tasks.md structure, T### IDs, and required fields.
-
-| 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 de 1 domínio (faça diretamente)
-- ✅ Task agent para specs multi-domínio (backend + frontend + infra = 3 planners em paralelo)
-- ✅ Task agent quando spec tem 20+ requisitos em múltiplos bounded contexts
-- ❌ Criar tasks.json sem ler todos os outputs primeiro
-- ❌ **(VSA)** Criar tasks separadas para Handler, Validator e Endpoint — um slice = uma task
-- ❌ **(VSA)** Usar categorias DDD (`domain`, `application`, `infrastructure`) em projetos VSA
-- ❌ **(VSA)** Criar task de "Implementar Service layer" — não existe em VSA
-
----
-
-## ✅ PRÉ-VOO OBRIGATÓRIO (antes de iniciar breakdown de tasks)
-
-### 1. Ler todos os prerequisitos em PARALELO
-
-```
-# Uma única chamada, não sequencial:
-Read: .morph/features/{feature}/1-design/spec.md
-    + Read: .morph/features/{feature}/1-design/contracts.cs
-    + Read: .morph/features/{feature}/1-design/decisions.md
-    + Read: .morph/features/{feature}/1-design/schema-analysis.md  (se existir)
-    + Read: .morph/config/config.json                               (→ architecture.style)
-```
-
-### 2. Criar tasks de sessão para visibilidade
-
-```
-TaskCreate: "Analisar spec e definir tasks"   → activeForm: "Analisando spec"
-TaskCreate: "Gerar tasks.md"                  → activeForm: "Gerando tasks.md"
-TaskCreate: "Avanço de fase"                  → activeForm: "Avançando fase"
-```
-
-> **Nota:** As tasks individuais T001-T00N serão criadas como native tasks durante a fase de implementação (`phase-implement`). Aqui mantemos apenas as 3 tasks de alto nível desta sessão de planejamento.
-
----
-
-## 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 0: Detectar Estilo de Arquitetura
-
-Antes de tudo, determine se o projeto é VSA ou DDD:
-
-```bash
-cat .morph/config/config.json | grep -A3 '"architecture"'
-```
-
-**Se `config.architecture.style === "vertical-slice"`** → siga o **Passo 0.5 (VSA)** e pule o Passo 0 DDD.
-**Caso contrário** → siga o **Passo 0.6 (DDD)** abaixo.
-
----
-
-### Passo 0.5: Plano de Tasks — VSA
-
-> Para padrões de tarefas VSA e mapeamento DDD por nível, veja `references/task-planning-patterns.md`
-
-Leia a seção `## Architecture Style: Vertical Slice` do spec.md para o **VSA Blueprint**:
-
-```bash
-grep -A30 "## Architecture Style" ".morph/features/$ARGUMENTS/1-design/spec.md"
-```
-
-Crie uma task por slice (entity → errors → tags → migration → slices CRUD → slices custom → tests). Cada slice = Handler + Validator + Endpoint numa única task. `GetAll` não tem Validator.
-
-**Após definir tasks VSA, pule direto para o Passo 3 (Dependências).**
-
----
-
-### Passo 0.6: Ler Nível de Domínio — DDD
-
-Leia a seção `## Domain Complexity` do spec.md:
-
-```bash
-grep -A15 "## Domain Complexity" ".morph/features/$ARGUMENTS/1-design/spec.md"
-```
-
-> Se a seção não existir, assuma **Nível 1 (CRUD)**.
-
-Use o nível para restringir categorias (Nível 1: domain→infra→application→presentation→tests; Nível 2: adiciona AggregateRoot, ValueObjects, DomainEvents, CQRS handlers; Nível 3: adiciona BC setup, Integration Events). Ver `references/task-planning-patterns.md` para tabela completa.
-
----
-
-### Passo 1: Analisar Spec
-
-> **VSA:** Se veio do Passo 0.5, o breakdown de tasks já foi definido — use os exemplos gerados como base e pule para o Passo 3 (Dependências).
-
-Leia `.morph/features/$ARGUMENTS/1-design/spec.md` e identifique:
-
-1. **Requisitos funcionais** (FR001, FR002, ...)
-2. **Componentes técnicos** (Entities, Services/Slices, Controllers/Endpoints, Pages)
-3. **Infraestrutura** (Bicep, migrations, configs)
-4. **Testes** (Unit tests, integration tests)
-
-### Passo 2: Quebrar em Tasks
-
-> Para estrutura JSON, categorias e ordem de implementação, veja `references/task-planning-patterns.md`
-
-Crie tasks no formato **T{NNN}** seguindo bottom-up: domain → infrastructure → application → presentation → tests → infra → docs.
-
-### 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.md`
-
-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)
-
-Se houver recursos Azure, adicionar tasks de Bicep e migrations.
-
-### Passo 8: Atualizar State
-
-```bash
-npx morph-spec state set $ARGUMENTS tasks.total {N}
-npx morph-spec state mark-output $ARGUMENTS tasks
-```
-
-## Outputs Gerados
-
-- `.morph/features/$ARGUMENTS/3-tasks/tasks.md` - 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
-
----
-
-## 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 -->
-
----
-
+---
+name: morph:phase-tasks
+description: MORPH-SPEC Phase 4 (Tasks). Breaks approved spec into bottom-up ordered implementation tasks (T001...TXXX) with dependencies, checkpoints every 3 tasks, and effort estimates, producing tasks.md. Use after design and clarification phases to create a structured implementation plan before coding starts.
+argument-hint: "[feature-name]"
+disable-model-invocation: true
+user-invocable: false
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+cliVersion: "4.9.0"
+---
+
+# 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
+
+## 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/tasks-example.md` — filled-in tasks.md showing expected granularity and format.
+> **Script:** `scripts/validate-tasks.mjs` — validates tasks.md structure, T### IDs, and required fields.
+
+| 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 de 1 domínio (faça diretamente)
+- ✅ Task agent para specs multi-domínio (backend + frontend + infra = 3 planners em paralelo)
+- ✅ Task agent quando spec tem 20+ requisitos em múltiplos bounded contexts
+- ❌ Criar tasks.json sem ler todos os outputs primeiro
+- ❌ **(VSA)** Criar tasks separadas para Handler, Validator e Endpoint — um slice = uma task
+- ❌ **(VSA)** Usar categorias DDD (`domain`, `application`, `infrastructure`) em projetos VSA
+- ❌ **(VSA)** Criar task de "Implementar Service layer" — não existe em VSA
+
+---
+
+## ✅ PRÉ-VOO OBRIGATÓRIO (antes de iniciar breakdown de tasks)
+
+### 1. Ler todos os prerequisitos em PARALELO
+
+```
+# Uma única chamada, não sequencial:
+Read: .morph/features/{feature}/1-design/spec.md
+    + Read: .morph/features/{feature}/1-design/contracts.cs
+    + Read: .morph/features/{feature}/1-design/decisions.md
+    + Read: .morph/features/{feature}/1-design/schema-analysis.md  (se existir)
+    + Read: .morph/config/config.json                               (→ architecture.style)
+```
+
+### 2. Criar tasks de sessão para visibilidade
+
+```
+TaskCreate: "Analisar spec e definir tasks"   → activeForm: "Analisando spec"
+TaskCreate: "Gerar tasks.md"                  → activeForm: "Gerando tasks.md"
+TaskCreate: "Avanço de fase"                  → activeForm: "Avançando fase"
+```
+
+> **Nota:** As tasks individuais T001-T00N serão criadas como native tasks durante a fase de implementação (`phase-implement`). Aqui mantemos apenas as 3 tasks de alto nível desta sessão de planejamento.
+
+---
+
+## 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-status $ARGUMENTS
+```
+
+---
+
+### Passo 0: Detectar Estilo de Arquitetura
+
+Antes de tudo, determine se o projeto é VSA ou DDD:
+
+```bash
+cat .morph/config/config.json | grep -A3 '"architecture"'
+```
+
+**Se `config.architecture.style === "vertical-slice"`** → siga o **Passo 0.5 (VSA)** e pule o Passo 0 DDD.
+**Caso contrário** → siga o **Passo 0.6 (DDD)** abaixo.
+
+---
+
+### Passo 0.5: Plano de Tasks — VSA
+
+> Para padrões de tarefas VSA e mapeamento DDD por nível, veja `references/task-planning-patterns.md`
+
+Leia a seção `## Architecture Style: Vertical Slice` do spec.md para o **VSA Blueprint**:
+
+```bash
+grep -A30 "## Architecture Style" ".morph/features/$ARGUMENTS/1-design/spec.md"
+```
+
+Crie uma task por slice (entity → errors → tags → migration → slices CRUD → slices custom → tests). Cada slice = Handler + Validator + Endpoint numa única task. `GetAll` não tem Validator.
+
+**Após definir tasks VSA, pule direto para o Passo 3 (Dependências).**
+
+---
+
+### Passo 0.6: Ler Nível de Domínio — DDD
+
+Leia a seção `## Domain Complexity` do spec.md:
+
+```bash
+grep -A15 "## Domain Complexity" ".morph/features/$ARGUMENTS/1-design/spec.md"
+```
+
+> Se a seção não existir, assuma **Nível 1 (CRUD)**.
+
+Use o nível para restringir categorias (Nível 1: domain→infra→application→presentation→tests; Nível 2: adiciona AggregateRoot, ValueObjects, DomainEvents, CQRS handlers; Nível 3: adiciona BC setup, Integration Events). Ver `references/task-planning-patterns.md` para tabela completa.
+
+---
+
+### Passo 1: Analisar Spec
+
+> **VSA:** Se veio do Passo 0.5, o breakdown de tasks já foi definido — use os exemplos gerados como base e pule para o Passo 3 (Dependências).
+
+Leia `.morph/features/$ARGUMENTS/1-design/spec.md` e identifique:
+
+1. **Requisitos funcionais** (FR001, FR002, ...)
+2. **Componentes técnicos** (Entities, Services/Slices, Controllers/Endpoints, Pages)
+3. **Infraestrutura** (Bicep, migrations, configs)
+4. **Testes** (Unit tests, integration tests)
+
+### Passo 2: Quebrar em Tasks
+
+> Para estrutura JSON, categorias e ordem de implementação, veja `references/task-planning-patterns.md`
+
+Crie tasks no formato **T{NNN}** seguindo bottom-up: domain → infrastructure → application → presentation → tests → infra → docs.
+
+### 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.md`
+
+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)
+
+Se houver recursos Azure, adicionar tasks de Bicep e migrations.
+
+### Passo 8: Atualizar State
+
+```bash
+npx morph-spec state set $ARGUMENTS tasks.total {N}
+npx morph-spec state mark-output $ARGUMENTS tasks
+```
+
+## Outputs Gerados
+
+- `.morph/features/$ARGUMENTS/3-tasks/tasks.md` - 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
+
+---
+
+## 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."