@polymorphism-tech/morph-spec 4.5.0 → 4.7.0

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

@@ -0,0 +1,132 @@
+# Feature Recap: Photo Processing Pipeline
+
+> Example of a well-structured recap.md. Filled-in reference — not a template.
+
+## Summary
+
+| Field | Value |
+|-------|-------|
+| **Feature ID** | photo-processing |
+| **Completed** | 2025-01-22 |
+| **Total Tasks** | 11 / 11 |
+| **Time Spent** | ~9h |
+| **Agents Used** | dotnet-senior, azure-architect, blazor-builder |
+| **Stack** | blazor-azure |
+
+---
+
+## Tasks Completed
+
+| ID | Title | Category | Duration |
+|----|-------|----------|----------|
+| T001 | Define C# contracts and interfaces | Contract | 25min |
+| T002 | Create ProcessingJob entity and enum | Domain | 30min |
+| T003 | EF Core migration and DbContext setup | Infrastructure | 50min |
+| T004 | Azure Blob Storage service | Infrastructure | 45min |
+| T005 | Implement PhotoProcessingService | Service | 65min |
+| T006 | Implement Hangfire background job | Job | 70min |
+| T007 | Upload and status endpoints | API | 40min |
+| T008 | Blazor upload page component | UI | 60min |
+| T009 | Blazor status polling page | UI | 65min |
+| T010 | Unit tests for PhotoProcessingService | Test | 55min |
+| T011 | Integration tests for upload + status API | Test | 70min |
+
+---
+
+## What Was Delivered
+
+### Functionality
+- Photo upload via Blazor form (10MB limit, .jpg/.png only)
+- Azure Blob Storage integration with `uploads/{jobId}/original.jpg` path structure
+- Hangfire background job with 3-retry exponential backoff (5s/30s/120s)
+- Real-time status polling page (5s interval, stops on terminal state)
+- Download redirect for completed jobs
+
+### Backend (.NET)
+- Endpoints: `POST /api/upload`, `GET /api/status/{id}`, `GET /api/download/{id}`
+- Services: `PhotoProcessingService`, `PhotoProcessingJob`
+- Simulation: `FakeBlobStorageService`, `FakePhotoProcessingJob` for dev mode
+
+### Frontend (Blazor)
+- Pages: `Upload.razor`, `ProcessingStatus.razor`
+- Polling via `PeriodicTimer` — no SignalR dependency
+
+---
+
+## Files Created
+
+```
+src/Domain/Entities/ProcessingJob.cs
+src/Domain/Enums/ProcessingStatus.cs
+src/Application/PhotoProcessing/Interfaces/IPhotoProcessingService.cs
+src/Application/PhotoProcessing/Commands/UploadPhotoCommand.cs
+src/Application/PhotoProcessing/Queries/GetJobStatusQuery.cs
+src/Application/PhotoProcessing/DTOs/JobStatusDto.cs
+src/Application/PhotoProcessing/PhotoProcessingService.cs
+src/Application/PhotoProcessing/PhotoProcessingJob.cs
+src/Application/PhotoProcessing/FakePhotoProcessingJob.cs
+src/Infrastructure/Storage/IBlobStorageService.cs
+src/Infrastructure/Storage/AzureBlobStorageService.cs
+src/Infrastructure/Storage/FakeBlobStorageService.cs
+src/Infrastructure/Persistence/Configurations/ProcessingJobConfiguration.cs
+src/Web/Endpoints/PhotoProcessingEndpoints.cs
+src/Web/Pages/Upload.razor + .cs
+src/Web/Pages/ProcessingStatus.razor + .cs
+tests/Unit/Application/PhotoProcessing/PhotoProcessingServiceTests.cs
+tests/Integration/Api/PhotoProcessingEndpointTests.cs
+tests/Integration/Fixtures/PhotoProcessingApiFixture.cs
+```
+
+## Files Modified
+
+```
+src/Infrastructure/Persistence/AppDbContext.cs
+src/Infrastructure/DependencyInjection.cs
+src/Application/DependencyInjection.cs
+src/Web/Program.cs
+```
+
+---
+
+## Architecture Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| PeriodicTimer for polling (not SignalR) | Simpler, no hub overhead, sufficient at MVP scale |
+| FakeBlobStorageService as Singleton | Stores in-memory dict; Scoped would lose state between requests |
+| Hangfire RetryCount on entity (not Hangfire built-in) | Domain owns retry state; allows custom error messages per attempt |
+
+See full ADRs in `decisions.md`
+
+---
+
+## Test Coverage
+
+| Type | Files | Notes |
+|------|-------|-------|
+| Unit | `PhotoProcessingServiceTests.cs` | Happy path, invalid type, size limit, 404, all statuses |
+| Integration | `PhotoProcessingEndpointTests.cs` | POST /upload, GET /status, GET /download (completed + pending) |
+
+---
+
+## Issues Encountered
+
+| Issue | Resolution |
+|-------|-----------|
+| `FakeBlobStorageService` registered as `Scoped` — lost uploads between requests | Changed to `Singleton` per simulation-checklist.md |
+| `PeriodicTimer` not stopping on component dispose | Added `CancellationTokenSource` + dispose pattern in `ProcessingStatus.razor.cs` |
+
+---
+
+## Metrics
+
+| Metric | Value |
+|--------|-------|
+| Tasks Completed | 11 / 11 |
+| Checkpoints Passed | 3 (after T003, T006, T009) |
+| Bugs Found | 2 |
+| Bugs Fixed | 2 |
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/framework/skills/level-1-workflows/{phase-setup.md → phase-setup/SKILL.md}

@@ -1,7 +1,6 @@
 ---
 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.
+description: MORPH-SPEC Phase 1 (Setup). Reads project context, detects tech stack, activates relevant agents via detect-agents, and confirms the feature environment. Use at the start of every MORPH-SPEC feature workflow after proposal approval to load standards and initialize the context.
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
@@ -21,7 +20,7 @@ Inicialize o contexto e prepare o ambiente para uma feature aprovada.
 
 ## Ferramentas Recomendadas
 
-> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **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.
 
 | Ação | Ferramenta | Alternativa |

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

@@ -1,7 +1,6 @@
 ---
 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.
+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
@@ -22,8 +21,10 @@ Quebre a especificação em tasks executáveis, defina ordem de execução e est
 
 ## Ferramentas Recomendadas
 
-> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **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 |
 |------|------------|-------------|
@@ -72,6 +73,44 @@ npx morph-spec approval get $ARGUMENTS design
 
 ---
 
+### Passo 0: Ler Nível de Domínio
+
+**Ref:** `framework/standards/architecture/ddd/complexity-levels.md`
+
+Antes de quebrar tasks, 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 no spec.md, assuma **Nível 1 (CRUD)** e documente nos pre-requisitos da task.
+
+Use o nível para **restringir** as categorias de tasks às listadas para o nível detectado:
+
+| Nível | Categorias de Tasks |
+|-------|---------------------|
+| **1 — CRUD** | `domain` (Entity simples) → `infrastructure` (Repository, EF Config) → `application` (Service CRUD) → `presentation` (API/Page) → `tests` |
+| **2 — Business Logic** | `domain` (AggregateRoot, ValueObjects, DomainEvents) → `infrastructure` (Repository, EF Config) → `application` (Commands, Queries, Handlers) → `presentation` (API/Page) → `tests` |
+| **3 — Bounded Context** | `domain-bc` (BC setup, Aggregates, Events) → `infrastructure` (BC repositories, EF) → `application` (Commands, Queries, Integration handlers) → `presentation` → `tests` |
+
+**Nível 1:** Nenhuma task adicional obrigatória — apenas o padrão CRUD nas categorias listadas.
+
+**Tasks adicionais obrigatórias por nível:**
+
+**Nível 2 apenas:**
+- `T{N}: Implementar AggregateRoot {EntityName} com factory method e invariants` (domain)
+- `T{N}: Implementar ValueObjects: {lista do Aggregate Blueprint}` (domain)
+- `T{N}: Implementar DomainEvents: {lista do Aggregate Blueprint}` (domain)
+- `T{N}: Implementar Command Handlers com MediatR` (application)
+- `T{N}: Implementar Query Handlers com read models` (application)
+
+**Nível 3 apenas (além do Nível 2):**
+- `T{N}: Configurar namespace/pasta do Bounded Context {BoundedContext}` (infrastructure)
+- `T{N}: Implementar Integration Events para comunicação cross-BC` (domain-bc)
+- `T{N}: Implementar handlers de Integration Events` (application)
+
+---
+
 ### Passo 1: Analisar Spec
 
 Leia `.morph/features/$ARGUMENTS/1-design/spec.md` e identifique:

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

@@ -0,0 +1,231 @@
+# Tasks - Photo Processing Pipeline
+
+> Example of a well-structured tasks.md. This is a filled-in reference — not a template.
+> All tasks are atomic (15–60 min), independently commitable, and directly traceable to spec.md.
+
+| Task ID | Type | Title | Status |
+|---------|------|-------|--------|
+| T001 | Contract | Define C# contracts and interfaces | Done |
+| T002 | Domain | Create ProcessingJob entity and enum | Done |
+| T003 | Infra | EF Core migration and DbContext setup | Done |
+| T004 | Infra | Azure Blob Storage service | Done |
+| T005 | Service | Implement PhotoProcessingService | In Progress |
+| T006 | Job | Implement Hangfire background job | Pending |
+| T007 | API | Upload and status endpoints (Minimal API) | Pending |
+| T008 | UI | Blazor upload page component | Pending |
+| T009 | UI | Blazor status polling page | Pending |
+| T010 | Test | Unit tests for PhotoProcessingService | Pending |
+| T011 | Test | Integration tests for upload + status API | Pending |
+
+**Status Values:** `Pending | In Progress | Blocked | Done`
+
+---
+
+## Phase 1: Contracts & Data Model
+
+### T001: Define C# contracts and interfaces
+- **Type:** Contract
+- **Priority:** 1
+- **Estimate:** 30min
+- **Assigned:** dotnet-senior
+- **Dependencies:** None
+
+**Description:**
+Define all service interfaces, command/result records, and DTOs needed for the feature. These become the API contract other tasks depend on — implement data model and services against these interfaces.
+
+**Deliverables:**
+- [ ] Create: `src/Application/PhotoProcessing/Interfaces/IPhotoProcessingService.cs`
+- [ ] Create: `src/Application/PhotoProcessing/Commands/UploadPhotoCommand.cs`
+- [ ] Create: `src/Application/PhotoProcessing/Queries/GetJobStatusQuery.cs`
+- [ ] Create: `src/Application/PhotoProcessing/DTOs/JobStatusDto.cs`
+
+---
+
+### T002: Create ProcessingJob entity and enum
+- **Type:** Domain
+- **Priority:** 1
+- **Estimate:** 30min
+- **Assigned:** dotnet-senior
+- **Dependencies:** T001
+
+**Description:**
+Create the `ProcessingJob` domain entity and `ProcessingStatus` enum per the data model in spec.md. Entity must use private setters and expose domain methods for state transitions (`MarkProcessing()`, `MarkCompleted()`, `MarkFailed()`).
+
+**Deliverables:**
+- [ ] Create: `src/Domain/Entities/ProcessingJob.cs`
+- [ ] Create: `src/Domain/Enums/ProcessingStatus.cs`
+
+---
+
+### T003: EF Core migration and DbContext setup
+- **Type:** Infrastructure
+- **Priority:** 1
+- **Estimate:** 45min
+- **Assigned:** dotnet-senior
+- **Dependencies:** T002
+
+**Description:**
+Add `ProcessingJob` to `AppDbContext`, configure via Fluent API (column lengths, indexes, defaults), and create initial migration. Verify migration applies cleanly to a local SQL Server instance.
+
+**Deliverables:**
+- [ ] Update: `src/Infrastructure/Persistence/AppDbContext.cs`
+- [ ] Create: `src/Infrastructure/Persistence/Configurations/ProcessingJobConfiguration.cs`
+- [ ] Run: `dotnet ef migrations add AddProcessingJob`
+- [ ] Verify: migration applies without errors
+
+---
+
+## Phase 2: Infrastructure Services
+
+### T004: Azure Blob Storage service
+- **Type:** Infrastructure
+- **Priority:** 1
+- **Estimate:** 45min
+- **Assigned:** azure-architect
+- **Dependencies:** None
+
+**Description:**
+Implement `IBlobStorageService` with upload and generate-URL operations using `Azure.Storage.Blobs` SDK. Register as scoped in DI. Add connection string to `appsettings.json` (placeholder) and Key Vault reference for production.
+
+**Deliverables:**
+- [ ] Create: `src/Infrastructure/Storage/IBlobStorageService.cs`
+- [ ] Create: `src/Infrastructure/Storage/AzureBlobStorageService.cs`
+- [ ] Create: `src/Infrastructure/Storage/FakeBlobStorageService.cs` (for simulation mode)
+- [ ] Update: `src/Infrastructure/DependencyInjection.cs`
+
+---
+
+### T005: Implement PhotoProcessingService
+- **Type:** Service
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** dotnet-senior
+- **Dependencies:** T001, T002, T003, T004
+
+**Description:**
+Implement `IPhotoProcessingService` with `UploadAsync` (validate → blob upload → create job → enqueue Hangfire job) and `GetStatusAsync`. Use result pattern for validation errors; throw `NotFoundException` for missing jobs.
+
+**Deliverables:**
+- [ ] Create: `src/Application/PhotoProcessing/PhotoProcessingService.cs`
+- [ ] Update: `src/Application/DependencyInjection.cs`
+
+---
+
+### T006: Implement Hangfire background job
+- **Type:** Job
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** dotnet-senior
+- **Dependencies:** T002, T004
+
+**Description:**
+Implement `IPhotoProcessingJob` that: sets status = Processing → downloads original from Blob → calls AI API → uploads processed photo → sets status = Completed. On exception: increment RetryCount, set Failed if >= 3. Add `[AutomaticRetry(Attempts = 3)]` attribute.
+
+**Deliverables:**
+- [ ] Create: `src/Application/PhotoProcessing/PhotoProcessingJob.cs`
+- [ ] Create: `src/Application/PhotoProcessing/FakePhotoProcessingJob.cs` (simulation mode)
+
+---
+
+## Phase 3: API Endpoints
+
+### T007: Upload and status endpoints (Minimal API)
+- **Type:** API
+- **Priority:** 2
+- **Estimate:** 45min
+- **Assigned:** dotnet-senior
+- **Dependencies:** T005
+
+**Description:**
+Create two endpoints per spec.md:
+- `POST /api/upload` — multipart/form-data, returns `{ jobId }`, maps to `UploadPhotoCommand`
+- `GET /api/status/{jobId}` — returns `JobStatusDto`
+- `GET /api/download/{jobId}` — redirects to Blob URL if Completed, else 404
+
+**Deliverables:**
+- [ ] Create: `src/Web/Endpoints/PhotoProcessingEndpoints.cs`
+- [ ] Update: `src/Web/Program.cs` to register endpoint group
+
+---
+
+## Phase 4: UI Components
+
+### T008: Blazor upload page component
+- **Type:** UI
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** blazor-builder
+- **Dependencies:** T007
+
+**Description:**
+Blazor Server page at `/upload`. File input with client-side validation (type + size before submit). Loading state during upload. Redirect to `/processing/{jobId}` on success. Error message display per spec wireframe.
+
+**Deliverables:**
+- [ ] Create: `src/Web/Pages/Upload.razor`
+- [ ] Create: `src/Web/Pages/Upload.razor.cs`
+
+---
+
+### T009: Blazor status polling page
+- **Type:** UI
+- **Priority:** 3
+- **Estimate:** 1h
+- **Assigned:** blazor-builder
+- **Dependencies:** T007
+
+**Description:**
+Blazor Server page at `/processing/{jobId}`. Polls `GET /api/status/{jobId}` every 5 seconds using `PeriodicTimer`. Shows status label + progress indicator. "Download" button when Completed. "Retry" suggestion when Failed. Stops polling on terminal state.
+
+**Deliverables:**
+- [ ] Create: `src/Web/Pages/ProcessingStatus.razor`
+- [ ] Create: `src/Web/Pages/ProcessingStatus.razor.cs`
+
+---
+
+## Phase 5: Tests
+
+### T010: Unit tests for PhotoProcessingService
+- **Type:** Test
+- **Priority:** 2
+- **Estimate:** 1h
+- **Assigned:** dotnet-senior
+- **Dependencies:** T005
+
+**Description:**
+Unit tests covering: happy path upload, invalid file type rejection, file too large rejection, status retrieval for each status value, not-found case. Use Moq for `IBlobStorageService` and `IProcessingJobRepository`. FluentAssertions for assertions.
+
+**Deliverables:**
+- [ ] Create: `tests/Unit/Application/PhotoProcessing/PhotoProcessingServiceTests.cs`
+
+---
+
+### T011: Integration tests for upload + status API
+- **Type:** Test
+- **Priority:** 3
+- **Estimate:** 1h
+- **Assigned:** dotnet-senior
+- **Dependencies:** T007, T010
+
+**Description:**
+Integration tests using `WebApplicationFactory` + in-memory SQLite (or TestContainers for SQL Server). Tests: POST /api/upload returns 200 with jobId, GET /api/status/{jobId} returns correct status, GET /api/download/{completedJobId} returns redirect.
+
+**Deliverables:**
+- [ ] Create: `tests/Integration/Api/PhotoProcessingEndpointTests.cs`
+- [ ] Create: `tests/Integration/Fixtures/PhotoProcessingApiFixture.cs`
+
+---
+
+## Summary
+
+| Phase | Tasks | Estimate |
+|-------|-------|----------|
+| Contracts & Data Model | T001–T003 | 1h45m |
+| Infrastructure Services | T004–T006 | 2h45m |
+| API Endpoints | T007 | 45m |
+| UI Components | T008–T009 | 2h |
+| Tests | T010–T011 | 2h |
+| **Total** | **11 tasks** | **~9h15m** |
+
+---
+
+*MORPH-SPEC by Polymorphism Tech*

package/framework/skills/level-1-workflows/phase-tasks/scripts/validate-tasks.mjs

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+/**
+ * validate-tasks.mjs
+ *
+ * Validates a MORPH-SPEC tasks.md file for structure and completeness.
+ * Executed locally by Claude via Bash — output returned to Claude.
+ *
+ * Usage:
+ *   node validate-tasks.mjs <tasks-file>
+ *   node validate-tasks.mjs .morph/features/my-feature/3-tasks/tasks.md
+ *
+ * Checks:
+ *   - Summary table exists with T### IDs and valid statuses
+ *   - Each task header has T### format
+ *   - Each task has Type, Priority, Estimate, Dependencies fields
+ *   - Each task has at least one deliverable checkbox
+ *   - Task IDs are sequential (no gaps)
+ *   - Reports counts by status
+ */
+
+import { readFileSync, existsSync } from 'fs';
+
+const taskFile = process.argv[2];
+
+if (!taskFile) {
+  console.error(JSON.stringify({ error: 'Usage: validate-tasks.mjs <tasks-file>' }));
+  process.exit(1);
+}
+
+if (!existsSync(taskFile)) {
+  console.error(JSON.stringify({ error: `File not found: ${taskFile}` }));
+  process.exit(1);
+}
+
+const content = readFileSync(taskFile, 'utf-8');
+const lines = content.split('\n');
+
+const errors = [];
+const warnings = [];
+
+// 1. Parse summary table (| T001 | Type | Title | Status |)
+const tableRows = lines.filter(l => /^\|\s*T\d{3}/.test(l));
+const VALID_STATUSES = new Set(['Pending', 'In Progress', 'Blocked', 'Done']);
+const summaryTasks = [];
+
+for (const row of tableRows) {
+  const parts = row.split('|').map(s => s.trim()).filter(Boolean);
+  if (parts.length < 4) continue;
+  const [id, , , status] = parts;
+  summaryTasks.push({ id, status });
+  if (!VALID_STATUSES.has(status)) {
+    errors.push(`Task ${id}: invalid status '${status}' — must be one of: ${[...VALID_STATUSES].join(', ')}`);
+  }
+}
+
+if (summaryTasks.length === 0) {
+  errors.push('No summary table found — expected rows matching | T### | Type | Title | Status |');
+}
+
+// 2. Parse task headers (### T001: Title)
+const taskHeaders = lines
+  .map((l, i) => ({ line: i + 1, match: l.match(/^###\s+(T\d{3}):\s+(.+)/) }))
+  .filter(r => r.match);
+
+// Check sequential IDs
+const ids = taskHeaders.map(r => parseInt(r.match[1].slice(1)));
+for (let i = 0; i < ids.length; i++) {
+  if (ids[i] !== i + 1) {
+    warnings.push(`Task ID gap or duplicate near T${String(ids[i]).padStart(3, '0')} (expected T${String(i + 1).padStart(3, '0')})`);
+    break;
+  }
+}
+
+// 3. Check each task section has required fields
+for (const { line, match } of taskHeaders) {
+  const taskId = match[1];
+  // Collect lines in this task section (until next ### or end)
+  const start = line; // 1-indexed
+  let end = lines.length;
+  for (let i = start; i < lines.length; i++) {
+    if (i > start - 1 && /^#{1,3}\s/.test(lines[i])) { end = i; break; }
+  }
+  const section = lines.slice(start, end).join('\n');
+
+  if (!/\*\*Type:\*\*/.test(section))       errors.push(`${taskId}: missing **Type:** field`);
+  if (!/\*\*Priority:\*\*/.test(section))   errors.push(`${taskId}: missing **Priority:** field`);
+  if (!/\*\*Estimate:\*\*/.test(section))   errors.push(`${taskId}: missing **Estimate:** field`);
+  if (!/\*\*Dependencies:\*\*/.test(section)) warnings.push(`${taskId}: missing **Dependencies:** field`);
+  if (!/- \[ \]/.test(section))             warnings.push(`${taskId}: no deliverable checkboxes found`);
+}
+
+// 4. Status counts
+const statusCounts = {};
+for (const { status } of summaryTasks) {
+  statusCounts[status] = (statusCounts[status] ?? 0) + 1;
+}
+
+const result = {
+  file: taskFile,
+  valid: errors.length === 0,
+  tasks: {
+    total: summaryTasks.length,
+    byStatus: statusCounts,
+    completed: statusCounts['Done'] ?? 0,
+    remaining: (summaryTasks.length) - (statusCounts['Done'] ?? 0),
+  },
+  errors,
+  warnings,
+};
+
+console.log(JSON.stringify(result, null, 2));
+process.exit(errors.length > 0 ? 1 : 0);

package/framework/skills/level-1-workflows/{phase-uiux.md → phase-uiux/SKILL.md}

@@ -1,7 +1,6 @@
 ---
 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.
+description: MORPH-SPEC Phase 1.5 (UI/UX). Creates design-system.md, mockups.md, components.md, and flows.md using Figma/Playwright/Context7 MCPs. Use after setup for features with frontend UI components, pages, dashboards, forms, wizards, or visual interactions requiring design documentation.
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep
@@ -21,7 +20,7 @@ Fase condicional para features com front-end. Coleta requisitos de UI/UX, gera w
 
 ## Ferramentas Recomendadas
 
-> **Ref:** `framework/skills/level-0-meta/tool-usage-guide.md` para guia completo.
+> **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.
 
 | Ação | Ferramenta | Alternativa |