@polymorphism-tech/morph-spec 4.13.0 → 4.15.0

package/framework/phases.json

@@ -1,162 +1,162 @@
-{
-  "version": "1.0.0",
-  "phases": {
-    "proposal": {
-      "id": "proposal",
-      "index": 0,
-      "folder": "0-proposal",
-      "displayName": "Proposal",
-      "goals": [
-        "Understand the feature scope",
-        "Agree on high-level approach",
-        "Produce initial proposal document"
-      ],
-      "requiredOutputs": ["proposal"],
-      "optionalOutputs": [],
-      "recommendedMCPs": ["context7"],
-      "pausePoints": [
-        { "id": "proposal", "label": "Approve Proposal" }
-      ],
-      "agentTiers": [1],
-      "requiredSkills": [
-        { "trigger": "beforePhaseStart", "skill": "morph-brainstorming" }
-      ]
-    },
-    "uiux": {
-      "id": "uiux",
-      "index": 2,
-      "folder": "1-ui",
-      "displayName": "UI/UX Design",
-      "optional": true,
-      "goals": [
-        "Define visual design and design system",
-        "Create component inventory and style guide",
-        "Produce wireframes and user flows"
-      ],
-      "requiredOutputs": ["uiDesignSystem"],
-      "optionalOutputs": ["uiMockups", "uiComponents", "uiFlows"],
-      "recommendedMCPs": ["playwright", "context7"],
-      "pausePoints": [
-        { "id": "uiux", "label": "Approve UI/UX Design" }
-      ],
-      "agentTiers": [1, 2, 3],
-      "requiredSkills": [
-        { "trigger": "beforeArchitecturalDecision", "skill": "morph-brainstorming" },
-        { "trigger": "beforePhaseComplete",         "skill": "morph-frontend-review" }
-      ]
-    },
-    "design": {
-      "id": "design",
-      "index": 3,
-      "folder": "2-design",
-      "displayName": "Technical Design",
-      "goals": [
-        "Write technical specification",
-        "Define C# contracts and interfaces",
-        "Analyse schema changes",
-        "Document architectural decisions"
-      ],
-      "requiredOutputs": ["spec", "contracts"],
-      "optionalOutputs": ["schemaAnalysis", "decisions"],
-      "recommendedMCPs": ["context7", "github"],
-      "pausePoints": [
-        { "id": "design", "label": "Approve Design Spec" }
-      ],
-      "agentTiers": [1, 2, 3, 4],
-      "requiredSkills": [
-        { "trigger": "beforePhaseStart",             "skill": "morph-phase-design" },
-        { "trigger": "beforePhaseStart",             "skill": "morph-phase-codebase-analysis" },
-        { "trigger": "beforeArchitecturalDecision",  "skill": "morph-brainstorming" },
-        { "trigger": "onExternalServiceIntegration", "skill": "morph-simulation-checklist" },
-        { "trigger": "beforePhaseComplete",          "skill": "morph-verification-before-completion" }
-      ]
-    },
-    "plan": {
-      "id": "plan",
-      "index": 5,
-      "folder": "3-plan",
-      "displayName": "Implementation Plan",
-      "goals": [
-        "Create detailed implementation plan with exact file paths and code",
-        "Define bite-sized TDD tasks with test-first approach",
-        "Establish execution strategy based on project analysis"
-      ],
-      "requiredOutputs": ["plan"],
-      "optionalOutputs": [],
-      "recommendedMCPs": ["context7", "github"],
-      "pausePoints": [
-        { "id": "plan", "label": "Approve Implementation Plan" }
-      ],
-      "agentTiers": [1, 2],
-      "requiredSkills": [
-        { "trigger": "beforePhaseStart",    "skill": "morph-phase-plan" },
-        { "trigger": "beforePhaseComplete", "skill": "morph-verification-before-completion" }
-      ]
-    },
-    "tasks": {
-      "id": "tasks",
-      "index": 6,
-      "folder": "4-tasks",
-      "displayName": "Task Breakdown",
-      "goals": [
-        "Break approved spec into numbered, atomic tasks",
-        "Order tasks by dependency",
-        "Assign tasks to agent tiers"
-      ],
-      "requiredOutputs": ["tasks"],
-      "optionalOutputs": [],
-      "recommendedMCPs": ["context7", "github"],
-      "pausePoints": [
-        { "id": "tasks", "label": "Approve Task List" }
-      ],
-      "agentTiers": [1, 2, 3],
-      "requiredSkills": [
-        { "trigger": "onParallelTasksIdentified", "skill": "superpowers:dispatching-parallel-agents" },
-        { "trigger": "beforePhaseComplete",       "skill": "morph-verification-before-completion" }
-      ]
-    },
-    "implement": {
-      "id": "implement",
-      "index": 7,
-      "folder": "5-implement",
-      "displayName": "Implementation",
-      "goals": [
-        "Execute approved tasks in order",
-        "Follow framework standards at each step",
-        "Checkpoint every 3 tasks",
-        "Write implementation recap"
-      ],
-      "requiredOutputs": ["recap"],
-      "optionalOutputs": [],
-      "recommendedMCPs": ["context7", "playwright", "github", "vercel"],
-      "pausePoints": [],
-      "agentTiers": [1, 2, 3, 4],
-      "requiredSkills": [
-        { "trigger": "beforeEachTask",    "skill": "superpowers:test-driven-development" },
-        { "trigger": "beforeTaskDone",    "skill": "morph-verification-before-completion" },
-        { "trigger": "onBugOrUnexpected", "skill": "superpowers:systematic-debugging" },
-        { "trigger": "afterAllTasks",     "skill": "morph-post-implementation" },
-        { "trigger": "afterAllTasks",     "skill": "superpowers:requesting-code-review" },
-        { "trigger": "beforePR",          "skill": "morph-checklist" }
-      ]
-    },
-    "sync": {
-      "id": "sync",
-      "index": 8,
-      "folder": null,
-      "displayName": "Sync Standards",
-      "optional": true,
-      "goals": [
-        "Update framework standards from feature learnings",
-        "Capture new patterns to learning library",
-        "Archive completed feature"
-      ],
-      "requiredOutputs": [],
-      "optionalOutputs": [],
-      "recommendedMCPs": [],
-      "pausePoints": [],
-      "agentTiers": [1],
-      "requiredSkills": []
-    }
-  }
-}
+{
+  "version": "1.0.0",
+  "phases": {
+    "proposal": {
+      "id": "proposal",
+      "index": 0,
+      "folder": "0-proposal",
+      "displayName": "Proposal",
+      "goals": [
+        "Understand the feature scope",
+        "Agree on high-level approach",
+        "Produce initial proposal document"
+      ],
+      "requiredOutputs": ["proposal"],
+      "optionalOutputs": [],
+      "recommendedMCPs": ["context7"],
+      "pausePoints": [
+        { "id": "proposal", "label": "Approve Proposal" }
+      ],
+      "agentTiers": [1],
+      "requiredSkills": [
+        { "trigger": "beforePhaseStart", "skill": "morph-brainstorming" }
+      ]
+    },
+    "uiux": {
+      "id": "uiux",
+      "index": 1,
+      "folder": "1-ui",
+      "displayName": "UI/UX Design",
+      "optional": true,
+      "goals": [
+        "Define visual design and design system",
+        "Create component inventory and style guide",
+        "Produce wireframes and user flows"
+      ],
+      "requiredOutputs": ["uiDesignSystem"],
+      "optionalOutputs": ["uiMockups", "uiComponents", "uiFlows"],
+      "recommendedMCPs": ["playwright", "context7"],
+      "pausePoints": [
+        { "id": "uiux", "label": "Approve UI/UX Design" }
+      ],
+      "agentTiers": [1, 2, 3],
+      "requiredSkills": [
+        { "trigger": "beforeArchitecturalDecision", "skill": "morph-brainstorming" },
+        { "trigger": "beforePhaseComplete",         "skill": "morph-frontend-review" }
+      ]
+    },
+    "design": {
+      "id": "design",
+      "index": 2,
+      "folder": "2-design",
+      "displayName": "Technical Design",
+      "goals": [
+        "Write technical specification",
+        "Define contracts and interfaces",
+        "Analyse schema changes",
+        "Document architectural decisions"
+      ],
+      "requiredOutputs": ["spec", "contracts"],
+      "optionalOutputs": ["schemaAnalysis", "decisions"],
+      "recommendedMCPs": ["context7", "github"],
+      "pausePoints": [
+        { "id": "design", "label": "Approve Design Spec" }
+      ],
+      "agentTiers": [1, 2, 3, 4],
+      "requiredSkills": [
+        { "trigger": "beforePhaseStart",             "skill": "morph-phase-design" },
+        { "trigger": "beforePhaseStart",             "skill": "morph-phase-codebase-analysis" },
+        { "trigger": "beforeArchitecturalDecision",  "skill": "morph-brainstorming" },
+        { "trigger": "onExternalServiceIntegration", "skill": "morph-simulation-checklist" },
+        { "trigger": "beforePhaseComplete",          "skill": "morph-verification-before-completion" }
+      ]
+    },
+    "plan": {
+      "id": "plan",
+      "index": 3,
+      "folder": "3-plan",
+      "displayName": "Implementation Plan",
+      "goals": [
+        "Create detailed implementation plan with exact file paths and code",
+        "Define bite-sized TDD tasks with test-first approach",
+        "Establish execution strategy based on project analysis"
+      ],
+      "requiredOutputs": ["plan"],
+      "optionalOutputs": [],
+      "recommendedMCPs": ["context7", "github"],
+      "pausePoints": [
+        { "id": "plan", "label": "Approve Implementation Plan" }
+      ],
+      "agentTiers": [1, 2],
+      "requiredSkills": [
+        { "trigger": "beforePhaseStart",    "skill": "morph-phase-plan" },
+        { "trigger": "beforePhaseComplete", "skill": "morph-verification-before-completion" }
+      ]
+    },
+    "tasks": {
+      "id": "tasks",
+      "index": 4,
+      "folder": "4-tasks",
+      "displayName": "Task Breakdown",
+      "goals": [
+        "Break approved spec into numbered, atomic tasks",
+        "Order tasks by dependency",
+        "Assign tasks to agent tiers"
+      ],
+      "requiredOutputs": ["tasks"],
+      "optionalOutputs": [],
+      "recommendedMCPs": ["context7", "github"],
+      "pausePoints": [
+        { "id": "tasks", "label": "Approve Task List" }
+      ],
+      "agentTiers": [1, 2, 3],
+      "requiredSkills": [
+        { "trigger": "onParallelTasksIdentified", "skill": "superpowers:dispatching-parallel-agents" },
+        { "trigger": "beforePhaseComplete",       "skill": "morph-verification-before-completion" }
+      ]
+    },
+    "implement": {
+      "id": "implement",
+      "index": 5,
+      "folder": "5-implement",
+      "displayName": "Implementation",
+      "goals": [
+        "Execute approved tasks in order",
+        "Follow framework standards at each step",
+        "Checkpoint every 3 tasks",
+        "Write implementation recap"
+      ],
+      "requiredOutputs": ["recap"],
+      "optionalOutputs": [],
+      "recommendedMCPs": ["context7", "playwright", "github", "vercel"],
+      "pausePoints": [],
+      "agentTiers": [1, 2, 3, 4],
+      "requiredSkills": [
+        { "trigger": "beforeEachTask",    "skill": "superpowers:test-driven-development" },
+        { "trigger": "beforeTaskDone",    "skill": "morph-verification-before-completion" },
+        { "trigger": "onBugOrUnexpected", "skill": "superpowers:systematic-debugging" },
+        { "trigger": "afterAllTasks",     "skill": "morph-post-implementation" },
+        { "trigger": "afterAllTasks",     "skill": "superpowers:requesting-code-review" },
+        { "trigger": "beforePR",          "skill": "morph-checklist" }
+      ]
+    },
+    "sync": {
+      "id": "sync",
+      "index": 6,
+      "folder": null,
+      "displayName": "Sync Standards",
+      "optional": true,
+      "goals": [
+        "Update framework standards from feature learnings",
+        "Capture new patterns to learning library",
+        "Archive completed feature"
+      ],
+      "requiredOutputs": [],
+      "optionalOutputs": [],
+      "recommendedMCPs": [],
+      "pausePoints": [],
+      "agentTiers": [1],
+      "requiredSkills": []
+    }
+  }
+}

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

@@ -3,7 +3,7 @@ name: morph-phase-codebase-analysis
 description: MORPH-SPEC Design sub-phase that analyzes existing codebase and database schema, producing schema-analysis.md with real column names, types, relationships, and field mismatches. Use at the start of Design phase before generating contracts.cs to prevent incorrect field names or types.
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.13.0"
+cliVersion: "4.15.0"
 ---
 
 # MORPH Codebase Analysis - Design Sub-phase

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

@@ -4,10 +4,10 @@ description: MORPH-SPEC Phase 2 (Design). Schema-first interactive design: reads
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Agent
-cliVersion: "4.13.0"
+cliVersion: "4.15.0"
 ---
 
-# MORPH Design — Phase 3
+# MORPH Design — Phase 2
 
 > INTERNAL: Workflow skill used by /morph-proposal during automated phase orchestration. Not a user command.
 

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

@@ -5,7 +5,7 @@ argument-hint: "[feature-name]"
 context: fork
 agent: general-purpose
 user-invocable: false
-cliVersion: "4.13.0"
+cliVersion: "4.15.0"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Agent
 ---
 

package/framework/skills/level-1-workflows/morph-phase-implement/prompts/code-quality-reviewer-prompt.md

@@ -16,7 +16,7 @@ Read these before reviewing:
 ## Review Checklist
 
 1. **Naming Conventions** — PascalCase for types, camelCase for variables, kebab-case for files (or as defined in standards)
-2. **Architecture Compliance** — Code follows the project's architecture pattern (VSA slices, DDD layers, etc.)
+2. **Architecture Compliance** — Code follows the project's VSA architecture pattern (Handler + Validator + Endpoint per feature folder)
 3. **Async Patterns** — CancellationToken propagated, no fire-and-forget, proper await
 4. **Error Handling** — Appropriate exceptions, no swallowed errors, consistent patterns
 5. **Security** — No hardcoded secrets, SQL injection, XSS vectors, or OWASP top 10 issues

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

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 3 (Plan). Generates a detailed implementation plan
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.13.0"
+cliVersion: "4.15.0"
 ---
 
 # MORPH Plan — Phase 3

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

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 4 (Tasks). Breaks approved spec into bottom-up ord
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.13.0"
+cliVersion: "4.15.0"
 ---
 
 # MORPH Tasks — Phase 4