@polymorphism-tech/morph-spec 4.16.0 → 4.18.0

package/framework/skills/level-1-workflows/morph-phase-tasks/references/task-planning-patterns.md

@@ -1,143 +1,143 @@
-# Task Planning Patterns — VSA
-
-> Padrões detalhados de task planning para Vertical Slice Architecture.
-> Referenciado pelos Passos 0.5 e 0.6 de `phase-tasks/SKILL.md`.
-
----
-
-## Padrão VSA (Vertical Slice Architecture)
-
-**Ref:** `framework/standards/architecture/vertical-slice/vertical-slice.md`
-
-### Categorias de tasks VSA
-
-Uma task por slice — Handler + Validator + Endpoint juntos:
-
-| Categoria | Descrição | Arquivo(s) |
-|-----------|-----------|------------|
-| **entity** | Entity class + DbSet no ApplicationDbContext | `Entities/{Entity}.cs`, `Database/ApplicationDbContext.cs` |
-| **errors** | `{Entity}Errors` static class com factory methods | `Features/{Entity}Feature/{Entity}Errors.cs` |
-| **tags** | Constante em ApiTags (se tag nova) | `Constants/ApiTags.cs` |
-| **migration** | `dotnet ef migrations add` + `database update` | `Migrations/...` |
-| **slice** | Slice completo: Handler (+ Request + Response records) + Validator + Endpoint | `Features/{Entity}Feature/{Op}/{Op}Handler.cs`, `...Validator.cs`, `...Endpoint.cs` |
-| **tests** | Unit tests dos handlers | `Tests/Features/{Entity}Feature/...` |
-| **docs** | README, Swagger, comentários | — |
-
-### Ordem obrigatória (bottom-up VSA)
-
-```
-T001: Entity + DbContext DbSet
-   ↓
-T002: {Entity}Errors (factory methods)
-   ↓
-T003: ApiTags constant (se tag ainda não existe)
-   ↓
-T004: Migration (Add{Entity} + database update)
-   ↓
-T005: Slice Create{Entity}     ← Handler+Validator+Endpoint = 1 task
-T006: Slice GetAll{Entity}s    ← Handler+Endpoint = 1 task (sem Validator)
-T007: Slice Get{Entity}ById    ← Handler+Validator+Endpoint = 1 task
-T008: Slice Update{Entity}     ← Handler+Validator+Endpoint = 1 task
-T009: Slice Delete{Entity}     ← Handler+Validator+Endpoint = 1 task
-   ↓
-T010+: Slices customizados (operações extra do VSA Blueprint)
-   ↓
-T0NN: Tests
-```
-
-### Regras VSA para tasks
-
-- 1 task = 1 slice completo (Handler + Validator + Endpoint num único task)
-- `GetAll` NÃO tem Validator — mencionar explicitamente no task
-- Cada task de slice lista os 3 arquivos que devem ser criados no campo `files`
-- Entity task deve incluir a linha `DbSet<{Entity}>` no `ApplicationDbContext`
-- Migration task é separada da entity task (pode rodar em paralelo com errors + tags)
-
-### Exemplos de tasks VSA
-
-```json
-{ "id": "T001", "title": "Criar Entity Book + registrar DbSet no ApplicationDbContext",
-  "category": "entity", "dependencies": [],  "estimatedMinutes": 20,
-  "files": ["Entities/Book.cs", "Database/ApplicationDbContext.cs"] }
-
-{ "id": "T002", "title": "Criar BookErrors (NotFound + outros factory methods)",
-  "category": "errors", "dependencies": ["T001"], "estimatedMinutes": 10,
-  "files": ["Features/BookFeature/BookErrors.cs"] }
-
-{ "id": "T003", "title": "Adicionar ApiTags.Books em Constants/ApiTags.cs",
-  "category": "tags", "dependencies": [], "estimatedMinutes": 5,
-  "files": ["Constants/ApiTags.cs"] }
-
-{ "id": "T004", "title": "Criar migration AddBook + aplicar ao banco",
-  "category": "migration", "dependencies": ["T001"], "estimatedMinutes": 10,
-  "files": ["Migrations/...AddBook.cs"] }
-
-{ "id": "T005", "title": "Implementar slice CreateBook (Handler + Validator + Endpoint)",
-  "category": "slice", "dependencies": ["T001", "T002", "T003", "T004"],
-  "estimatedMinutes": 45,
-  "files": [
-    "Features/BookFeature/CreateBook/CreateBookHandler.cs",
-    "Features/BookFeature/CreateBook/CreateBookValidator.cs",
-    "Features/BookFeature/CreateBook/CreateBookEndpoint.cs"
-  ] }
-
-{ "id": "T006", "title": "Implementar slice GetAllBooks (Handler + Endpoint, sem Validator)",
-  "category": "slice", "dependencies": ["T001", "T004"], "estimatedMinutes": 25,
-  "files": [
-    "Features/BookFeature/GetAllBooks/GetAllBooksHandler.cs",
-    "Features/BookFeature/GetAllBooks/GetAllBooksEndpoint.cs"
-  ] }
-```
-
----
-
-## Estrutura de Task (formato JSON)
-
-```json
-{
-  "id": "T001",
-  "title": "Criar Entity {Nome}",
-  "description": "Implementar entity {Nome} com propriedades X, Y, Z seguindo padrões EF Core",
-  "category": "entity",
-  "dependencies": [],
-  "estimatedMinutes": 30,
-  "status": "pending",
-  "specSections": ["## Domain Model", "## Business Rules"],
-  "contractInterfaces": ["I{Nome}Repository"],
-  "files": [
-    "Entities/{Nome}.cs",
-    "Database/ApplicationDbContext.cs"
-  ]
-}
-```
-
-## Categorias de Tasks (VSA)
-
-| Categoria | Descrição | Exemplos |
-|-----------|-----------|----------|
-| **entity** | Entities, Enums | Entity class, DbSet registration |
-| **errors** | Error factory classes | `{Entity}Errors.cs` |
-| **tags** | API endpoint tags | `ApiTags.cs` constants |
-| **migration** | DB migrations | EF migrations |
-| **slice** | Complete VSA slice | Handler + Validator + Endpoint |
-| **tests** | Unit tests, Integration tests | Handler tests, API tests |
-| **infra** | Docker, Migrations, Scripts | docker-compose, Supabase migrations |
-| **docs** | README, API docs | OpenAPI spec, README update |
-
-## Ordem de Implementação Bottom-Up (VSA)
-
-```
-1. Entity + DbContext registration
-   ↓
-2. Errors + ApiTags
-   ↓
-3. Migrations
-   ↓
-4. Slices (Handler + Validator + Endpoint per operation)
-   ↓
-5. Tests (Unit → Integration)
-   ↓
-6. Infra (Docker, Supabase migrations)
-   ↓
-7. Docs (README, Swagger)
-```
+# Task Planning Patterns — VSA
+
+> Padrões detalhados de task planning para Vertical Slice Architecture.
+> Referenciado pelos Passos 0.5 e 0.6 de `phase-tasks/SKILL.md`.
+
+---
+
+## Padrão VSA (Vertical Slice Architecture)
+
+**Ref:** `framework/standards/architecture/vertical-slice/vertical-slice.md`
+
+### Categorias de tasks VSA
+
+Uma task por slice — Handler + Validator + Endpoint juntos:
+
+| Categoria | Descrição | Arquivo(s) |
+|-----------|-----------|------------|
+| **entity** | Entity class + DbSet no ApplicationDbContext | `Entities/{Entity}.cs`, `Database/ApplicationDbContext.cs` |
+| **errors** | `{Entity}Errors` static class com factory methods | `Features/{Entity}Feature/{Entity}Errors.cs` |
+| **tags** | Constante em ApiTags (se tag nova) | `Constants/ApiTags.cs` |
+| **migration** | `dotnet ef migrations add` + `database update` | `Migrations/...` |
+| **slice** | Slice completo: Handler (+ Request + Response records) + Validator + Endpoint | `Features/{Entity}Feature/{Op}/{Op}Handler.cs`, `...Validator.cs`, `...Endpoint.cs` |
+| **tests** | Unit tests dos handlers | `Tests/Features/{Entity}Feature/...` |
+| **docs** | README, Swagger, comentários | — |
+
+### Ordem obrigatória (bottom-up VSA)
+
+```
+T001: Entity + DbContext DbSet
+   ↓
+T002: {Entity}Errors (factory methods)
+   ↓
+T003: ApiTags constant (se tag ainda não existe)
+   ↓
+T004: Migration (Add{Entity} + database update)
+   ↓
+T005: Slice Create{Entity}     ← Handler+Validator+Endpoint = 1 task
+T006: Slice GetAll{Entity}s    ← Handler+Endpoint = 1 task (sem Validator)
+T007: Slice Get{Entity}ById    ← Handler+Validator+Endpoint = 1 task
+T008: Slice Update{Entity}     ← Handler+Validator+Endpoint = 1 task
+T009: Slice Delete{Entity}     ← Handler+Validator+Endpoint = 1 task
+   ↓
+T010+: Slices customizados (operações extra do VSA Blueprint)
+   ↓
+T0NN: Tests
+```
+
+### Regras VSA para tasks
+
+- 1 task = 1 slice completo (Handler + Validator + Endpoint num único task)
+- `GetAll` NÃO tem Validator — mencionar explicitamente no task
+- Cada task de slice lista os 3 arquivos que devem ser criados no campo `files`
+- Entity task deve incluir a linha `DbSet<{Entity}>` no `ApplicationDbContext`
+- Migration task é separada da entity task (pode rodar em paralelo com errors + tags)
+
+### Exemplos de tasks VSA
+
+```json
+{ "id": "T001", "title": "Criar Entity Book + registrar DbSet no ApplicationDbContext",
+  "category": "entity", "dependencies": [],  "estimatedMinutes": 20,
+  "files": ["Entities/Book.cs", "Database/ApplicationDbContext.cs"] }
+
+{ "id": "T002", "title": "Criar BookErrors (NotFound + outros factory methods)",
+  "category": "errors", "dependencies": ["T001"], "estimatedMinutes": 10,
+  "files": ["Features/BookFeature/BookErrors.cs"] }
+
+{ "id": "T003", "title": "Adicionar ApiTags.Books em Constants/ApiTags.cs",
+  "category": "tags", "dependencies": [], "estimatedMinutes": 5,
+  "files": ["Constants/ApiTags.cs"] }
+
+{ "id": "T004", "title": "Criar migration AddBook + aplicar ao banco",
+  "category": "migration", "dependencies": ["T001"], "estimatedMinutes": 10,
+  "files": ["Migrations/...AddBook.cs"] }
+
+{ "id": "T005", "title": "Implementar slice CreateBook (Handler + Validator + Endpoint)",
+  "category": "slice", "dependencies": ["T001", "T002", "T003", "T004"],
+  "estimatedMinutes": 45,
+  "files": [
+    "Features/BookFeature/CreateBook/CreateBookHandler.cs",
+    "Features/BookFeature/CreateBook/CreateBookValidator.cs",
+    "Features/BookFeature/CreateBook/CreateBookEndpoint.cs"
+  ] }
+
+{ "id": "T006", "title": "Implementar slice GetAllBooks (Handler + Endpoint, sem Validator)",
+  "category": "slice", "dependencies": ["T001", "T004"], "estimatedMinutes": 25,
+  "files": [
+    "Features/BookFeature/GetAllBooks/GetAllBooksHandler.cs",
+    "Features/BookFeature/GetAllBooks/GetAllBooksEndpoint.cs"
+  ] }
+```
+
+---
+
+## Estrutura de Task (formato JSON)
+
+```json
+{
+  "id": "T001",
+  "title": "Criar Entity {Nome}",
+  "description": "Implementar entity {Nome} com propriedades X, Y, Z seguindo padrões EF Core",
+  "category": "entity",
+  "dependencies": [],
+  "estimatedMinutes": 30,
+  "status": "pending",
+  "specSections": ["## Domain Model", "## Business Rules"],
+  "contractInterfaces": ["I{Nome}Repository"],
+  "files": [
+    "Entities/{Nome}.cs",
+    "Database/ApplicationDbContext.cs"
+  ]
+}
+```
+
+## Categorias de Tasks (VSA)
+
+| Categoria | Descrição | Exemplos |
+|-----------|-----------|----------|
+| **entity** | Entities, Enums | Entity class, DbSet registration |
+| **errors** | Error factory classes | `{Entity}Errors.cs` |
+| **tags** | API endpoint tags | `ApiTags.cs` constants |
+| **migration** | DB migrations | EF migrations |
+| **slice** | Complete VSA slice | Handler + Validator + Endpoint |
+| **tests** | Unit tests, Integration tests | Handler tests, API tests |
+| **infra** | Docker, Migrations, Scripts | docker-compose, PostgreSQL migrations |
+| **docs** | README, API docs | OpenAPI spec, README update |
+
+## Ordem de Implementação Bottom-Up (VSA)
+
+```
+1. Entity + DbContext registration
+   ↓
+2. Errors + ApiTags
+   ↓
+3. Migrations
+   ↓
+4. Slices (Handler + Validator + Endpoint per operation)
+   ↓
+5. Tests (Unit → Integration)
+   ↓
+6. Infra (Docker, PostgreSQL migrations)
+   ↓
+7. Docs (README, Swagger)
+```

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

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 2 (UI/UX). Creates design-system.md, mockups.md, c
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.16.0"
+cliVersion: "4.18.0"
 ---
 
 # MORPH UI/UX Design - Phase 2

package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md

@@ -4,7 +4,7 @@ description: Guided workflow for mid-implementation scope escalation — analyze
 user-invocable: true
 argument-hint: "[feature-name]"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.16.0"
+cliVersion: "4.18.0"
 ---
 
 # Scope Escalation Workflow