@polymorphism-tech/morph-spec 4.5.0 → 4.6.0

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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.5.0",
+  "version": "4.6.0",
   "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
   "keywords": [
     "claude-code",

package/src/commands/project/init.js

@@ -4,7 +4,6 @@ import ora from 'ora';
 import chalk from 'chalk';
 import { logger } from '../../utils/logger.js';
 import {
-  getContentDir,
   copyDirectory,
   copyFile,
   pathExists,
@@ -13,9 +12,7 @@ import {
   ensureDir,
   writeFile,
   readFile,
-  updateGitignore,
-  createSymlink,
-  createDirectoryLink
+  updateGitignore
 } from '../../utils/file-copier.js';
 import { saveProjectMorphVersion, getInstalledCLIVersion } from '../../utils/version-checker.js';
 import { installClaudeHooks, installGlobalStatusline } from '../../utils/claude-settings-manager.js';
@@ -122,7 +119,6 @@ Run \`morph-spec detect\` to analyze your project.
     await writeFile(contextReadme, readmeContent);
 
     // 5. Copy framework templates (project-local overrides start from framework defaults)
-    const contentDir = getContentDir();
     const frameworkTemplatesSrc = join(import.meta.dirname, '..', '..', '..', 'framework', 'templates');
     const templatesDest = join(frameworkDestDir, 'templates');
     let templatesCopied = false;
@@ -151,14 +147,12 @@ Run \`morph-spec detect\` to analyze your project.
       await copyFile(agentsSrc, agentsDest);
     }
 
-    // 8. Copy .claude commands and create symlinks for skills
+    // 8. Copy .claude commands and install skills
     // Source: framework/ (canonical for all stacks)
     spinner.text = 'Setting up Claude Code integration...';
     const frameworkDir = join(import.meta.dirname, '..', '..', '..', 'framework');
     const claudeDest = join(targetPath, '.claude');
 
-    let symlinkCount = 0;
-    let copyCount = 0;
     let commandsCopied = false;
 
     // Copy commands directory (slash commands): framework/commands/ → .claude/commands/
@@ -171,55 +165,6 @@ Run \`morph-spec detect\` to analyze your project.
       logger.warn('  ⚠ framework/commands/ source missing — commands not installed');
     }
 
-    // Create directory links for skill categories (or copy if linking fails)
-    // Source: framework/skills/ → .claude/skills/
-    {
-      const skillsSrc = join(frameworkDir, 'skills');
-      const skillsDest = join(claudeDest, 'skills');
-
-      if (await pathExists(skillsSrc)) {
-        await ensureDir(skillsDest);
-
-        const entries = await fs.readdir(skillsSrc, { withFileTypes: true });
-
-        let linkedCategories = 0;
-        let copiedCategories = 0;
-        let totalSkillFiles = 0;
-
-        // Link category directories (specialists/, infra/, checklists/, etc.)
-        for (const entry of entries) {
-          if (entry.isDirectory()) {
-            const categorySrc = join(skillsSrc, entry.name);
-            const categoryDest = join(skillsDest, entry.name);
-
-            // Count .md files for reporting
-            const categoryEntries = await fs.readdir(categorySrc, { withFileTypes: true });
-            const mdFiles = categoryEntries.filter(e => e.isFile() && e.name.endsWith('.md'));
-            totalSkillFiles += mdFiles.length;
-
-            const result = await createDirectoryLink(categorySrc, categoryDest);
-            if (result === 'copy') {
-              copiedCategories++;
-            } else {
-              linkedCategories++;
-            }
-          } else if (entry.isFile() && entry.name.endsWith('.md')) {
-            // Handle .md files in skills root
-            totalSkillFiles++;
-            const result = await createSymlink(join(skillsSrc, entry.name), join(skillsDest, entry.name), 'file');
-            if (result === 'symlink') {
-              linkedCategories++;
-            } else {
-              copiedCategories++;
-            }
-          }
-        }
-
-        symlinkCount = linkedCategories > 0 ? totalSkillFiles : 0;
-        copyCount = linkedCategories === 0 ? totalSkillFiles : 0;
-      }
-    }
-
     // 9a. Install path-scoped rules to .claude/rules/ (native Claude Code pattern)
     spinner.text = 'Installing path-scoped rules to .claude/rules/...';
     const rulesSrc = join(frameworkDir, 'rules');
@@ -542,13 +487,8 @@ Run \`morph-spec detect\` to analyze your project.
       }
     }
 
-    if (symlinkCount > 0) {
-      const linkType = process.platform === 'win32' ? 'junction-linked' : 'symlinked';
-      logger.dim(`  ✓ .claude/skills/ (${symlinkCount} ${linkType})`);
-    } else if (copyCount > 0) {
-      logger.dim(`  ✓ .claude/skills/ (${copyCount} copied)`);
-      logger.warn(`  ⚠ Directory links not supported (copied instead). Skills won't auto-update.`);
-    }
+    logger.dim('  ✓ .claude/skills/ (installed as skill directories)');
+    logger.dim('  ✓ .claude/agents/ (native subagents installed)');
 
     logger.blank();
 

package/src/commands/project/update.js

@@ -14,8 +14,6 @@ import {
   copyFile,
   pathExists,
   ensureDir,
-  createDirectoryLink,
-  createSymlink,
   readJson,
   writeJson
 } from '../../utils/file-copier.js';
@@ -239,8 +237,6 @@ export async function updateCommand(options) {
     const frameworkDir = join(__dirname, '..', '..', '..', 'framework');
     const claudeDest = join(targetPath, '.claude');
 
-    let symlinkCount = 0;
-    let copyCount = 0;
     let commandsCopied = false;
 
     // Copy commands directory (slash commands): framework/commands/ → .claude/commands/
@@ -253,55 +249,6 @@ export async function updateCommand(options) {
       logger.warn('  ⚠ framework/commands/ source missing — commands not updated');
     }
 
-    // Create directory links for skill categories (or copy if linking fails)
-    // Source: framework/skills/ → .claude/skills/
-    {
-      const skillsSrc = join(frameworkDir, 'skills');
-      const skillsDest = join(claudeDest, 'skills');
-
-      if (await pathExists(skillsSrc)) {
-        await ensureDir(skillsDest);
-
-        const entries = await fs.readdir(skillsSrc, { withFileTypes: true });
-
-        let linkedCategories = 0;
-        let copiedCategories = 0;
-        let totalSkillFiles = 0;
-
-        // Link category directories (specialists/, infra/, checklists/, etc.)
-        for (const entry of entries) {
-          if (entry.isDirectory()) {
-            const categorySrc = join(skillsSrc, entry.name);
-            const categoryDest = join(skillsDest, entry.name);
-
-            // Count .md files for reporting
-            const categoryEntries = await fs.readdir(categorySrc, { withFileTypes: true });
-            const mdFiles = categoryEntries.filter(e => e.isFile() && e.name.endsWith('.md'));
-            totalSkillFiles += mdFiles.length;
-
-            const result = await createDirectoryLink(categorySrc, categoryDest);
-            if (result === 'copy') {
-              copiedCategories++;
-            } else {
-              linkedCategories++;
-            }
-          } else if (entry.isFile() && entry.name.endsWith('.md')) {
-            // Handle .md files in skills root
-            totalSkillFiles++;
-            const result = await createSymlink(join(skillsSrc, entry.name), join(skillsDest, entry.name), 'file');
-            if (result === 'symlink') {
-              linkedCategories++;
-            } else {
-              copiedCategories++;
-            }
-          }
-        }
-
-        symlinkCount = linkedCategories > 0 ? totalSkillFiles : 0;
-        copyCount = linkedCategories === 0 ? totalSkillFiles : 0;
-      }
-    }
-
     // Sync morph skills to .claude/skills/ for native Claude Code discovery
     updateSpinner.text = 'Syncing morph skills to .claude/skills/...';
     await installSkills(targetPath);
@@ -365,16 +312,8 @@ export async function updateCommand(options) {
     logger.dim('  ✓ .morph/framework/agents.json');
     if (commandsCopied) logger.dim('  ✓ .claude/commands/');
 
-    if (symlinkCount > 0) {
-      const linkType = process.platform === 'win32' ? 'junction-linked' : 'symlinked';
-      logger.dim(`  ✓ .claude/skills/ (${symlinkCount} ${linkType})`);
-    } else if (copyCount > 0) {
-      logger.dim(`  ✓ .claude/skills/ (${copyCount} copied)`);
-      logger.warn(`  ⚠ Directory links not supported (copied instead). Skills won't auto-update.`);
-    }
-
     logger.dim(`  ✓ .claude/settings.local.json (${hooksResult.installed} hooks installed)`);
-    logger.dim('  ✓ .claude/skills/ (flat .md for /skill-name discovery)');
+    logger.dim('  ✓ .claude/skills/ (skills installed as directories)');
     logger.dim('  ✓ .claude/agents/ (native subagents refreshed)');
     logger.dim('  ✓ .claude/rules/ (path-scoped rules synced)');
     logger.dim('  ✓ .claude/CLAUDE.md (runtime quick reference)');

package/src/lib/detectors/claude-config-detector.js

@@ -144,9 +144,7 @@ function detectCustomSkills(globalClaudeDir, projectClaudeDir) {
     for (const file of walkMdFiles(projectSkills)) {
       const name = extractSkillName(file);
       // Skip morph-spec framework skills (they're managed by init)
-      if (file.includes('level-0-meta') || file.includes('level-1-workflows') ||
-          file.includes('level-2-domains') || file.includes('level-3-technologies') ||
-          file.includes('level-4-patterns')) {
+      if (file.includes('level-0-meta') || file.includes('level-1-workflows')) {
         continue;
       }
       skills.push({

package/src/utils/agents-installer.js

@@ -171,14 +171,14 @@ export function collectSkillFiles(dir) {
 }
 
 /**
- * Installs level-2-domains skill files as native Claude Code subagents
+ * Installs domain agent files as native Claude Code subagents
  * in .claude/agents/ with memory:project, model:sonnet, maxTurns:20.
  *
  * @param {string} projectDir - Target project directory
  * @param {string} frameworkDir - Path to morph-spec framework/ directory
  */
 export async function installDomainAgents(projectDir, frameworkDir = 'framework') {
-  const domainsDir = join(frameworkDir, 'skills', 'level-2-domains');
+  const domainsDir = join(frameworkDir, 'agents');
   if (!existsSync(domainsDir)) return;
 
   const targetDir = join(projectDir, '.claude', 'agents');