@polymorphism-tech/morph-spec 4.12.0 → 4.14.0

package/framework/hooks/shared/phase-utils.js

@@ -8,15 +8,13 @@
  */
 
 /** Phase order */
-export const PHASE_ORDER = ["proposal","setup","uiux","design","clarify","plan","tasks","implement","sync"];
+export const PHASE_ORDER = ["proposal","uiux","design","plan","tasks","implement","sync"];
 
 /** Map phase → allowed output subdirectory */
 export const PHASE_DIRS = {
   proposal: '0-proposal',
-  setup: '0-proposal',
-  uiux: '2-ui',
-  design: '1-design',
-  clarify: '1-design',
+  uiux: '1-ui',
+  design: '2-design',
   plan: '3-plan',
   tasks: '4-tasks',
   implement: '5-implement',
@@ -28,7 +26,6 @@ export const OUTPUT_PHASE_MAP = {
   proposal: 'proposal',
   schemaAnalysis: 'design',
   spec: 'design',
-  clarifications: 'clarify',
   contracts: 'design',
   contractsTs: 'design',
   contractsVsa: 'design',
@@ -47,7 +44,6 @@ export const FILENAME_TO_OUTPUT = {
   'proposal.md': 'proposal',
   'schema-analysis.md': 'schemaAnalysis',
   'spec.md': 'spec',
-  'clarifications.md': 'clarifications',
   'contracts.cs': 'contracts',
   'contracts.ts': 'contractsTs',
   'contracts-vsa.cs': 'contractsVsa',
@@ -90,7 +86,7 @@ export function extractFeatureName(filePath) {
 /**
  * Extract phase subdirectory from a .morph/features/{feature}/{phaseDir}/... path
  * @param {string} filePath - File path to analyze
- * @returns {string|null} Phase directory (e.g., '0-proposal', '1-design') or null
+ * @returns {string|null} Phase directory (e.g., '0-proposal', '2-design') or null
  */
 export function extractPhaseDir(filePath) {
   const normalized = filePath.replace(/\\/g, '/');

package/framework/hooks/shared/state-reader.js

@@ -110,14 +110,14 @@ export function derivePhaseForFeature(featureName, projectPath) {
     ['5-implement', 'implement'],
     ['4-tasks', 'tasks'],
     ['3-plan', 'plan'],
-    ['2-ui', 'uiux'],
-    ['1-design', 'design'],
+    ['2-design', 'design'],
+    ['1-ui', 'uiux'],
     ['0-proposal', 'proposal'],
   ];
   for (const [folder, phase] of phaseMap) {
     if (existsSync(join(basePath, folder))) return phase;
   }
-  return 'setup';
+  return 'proposal';
 }
 
 /**
@@ -181,6 +181,37 @@ export function getOutputs(featureName, projectPath) {
  * @param {string} [projectPath]
  * @returns {Array<{type: string, path: string}>}
  */
+/**
+ * Get task statistics directly from taskList (preferred over feature.tasks counters).
+ * Excludes expanded tasks from counts, matching calculateProgress() behavior.
+ *
+ * @param {Object} feature - Feature state object
+ * @returns {{ total: number, completed: number, inProgress: number, pending: number }}
+ */
+export function getTaskStats(feature) {
+  const list = feature?.taskList || [];
+  if (list.length > 0) {
+    const active = list.filter(t => t.status !== 'expanded');
+    return {
+      total: active.length,
+      completed: active.filter(t => t.status === 'completed').length,
+      inProgress: active.filter(t => t.status === 'in_progress').length,
+      pending: active.filter(t => t.status === 'pending').length,
+    };
+  }
+  // Fallback: read from legacy counter object
+  const tasks = feature?.tasks;
+  if (tasks && typeof tasks === 'object' && !Array.isArray(tasks)) {
+    return {
+      total: tasks.total || 0,
+      completed: tasks.completed || 0,
+      inProgress: tasks.inProgress || 0,
+      pending: tasks.pending || 0,
+    };
+  }
+  return { total: 0, completed: 0, inProgress: 0, pending: 0 };
+}
+
 export function getMissingOutputs(featureName, projectPath) {
   const feature = getFeature(featureName, projectPath);
   if (!feature?.outputs) return [];

package/framework/phases.json

@@ -1,200 +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" }
-      ]
-    },
-    "setup": {
-      "id": "setup",
-      "index": 1,
-      "folder": null,
-      "displayName": "Setup",
-      "goals": [
-        "Load project context from .morph/context/",
-        "Activate relevant agents by tier and keyword",
-        "Confirm workflow type (fast-track / standard / full-morph)"
-      ],
-      "requiredOutputs": [],
-      "optionalOutputs": [],
-      "recommendedMCPs": ["github"],
-      "pausePoints": [],
-      "agentTiers": [1, 2],
-      "requiredSkills": []
-    },
-    "uiux": {
-      "id": "uiux",
-      "index": 1.5,
-      "folder": "2-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": "onHTMLPrototypeAvailable",    "skill": "morph-replicate" },
-        { "trigger": "beforePhaseComplete",         "skill": "morph-frontend-review" }
-      ]
-    },
-    "design": {
-      "id": "design",
-      "index": 2,
-      "folder": "1-design",
-      "displayName": "Technical Design",
-      "goals": [
-        "Write technical specification",
-        "Define C# contracts and interfaces",
-        "Analyse schema changes",
-        "Document architectural decisions"
-      ],
-      "requiredOutputs": ["spec", "contracts"],
-      "optionalOutputs": ["schemaAnalysis", "clarifications", "decisions"],
-      "recommendedMCPs": ["supabase", "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" }
-      ]
-    },
-    "clarify": {
-      "id": "clarify",
-      "index": 3,
-      "folder": "1-design",
-      "displayName": "Clarification",
-      "goals": [
-        "Resolve open questions and ambiguities",
-        "Update spec with clarification decisions",
-        "Confirm edge cases are handled"
-      ],
-      "requiredOutputs": ["clarifications"],
-      "optionalOutputs": [],
-      "recommendedMCPs": ["context7", "github"],
-      "pausePoints": [],
-      "agentTiers": [1, 2],
-      "requiredSkills": [
-        { "trigger": "beforePhaseStart",    "skill": "morph-phase-clarify" },
-        { "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": ["supabase", "context7", "playwright", "github", "vercel", "docker", "azure"],
-      "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/rules/ai-agents-standards.md

@@ -0,0 +1,15 @@
+---
+paths:
+  - "**/Agents/**"
+  - "**/agents/**"
+  - "**/*Agent*.cs"
+stacks:
+  - dotnet
+---
+
+# Microsoft Agent Framework Standards
+
+@.morph/framework/standards/ai-agents/setup.md
+@.morph/framework/standards/ai-agents/workflows.md
+@.morph/framework/standards/ai-agents/production.md
+@.morph/framework/standards/integration/mcp/mcp-tools.md

package/framework/rules/asaas-standards.md

@@ -0,0 +1,13 @@
+---
+paths:
+  - "**/Payment*/**"
+  - "**/Billing/**"
+  - "**/Asaas/**"
+  - "**/Financial/**"
+stacks:
+  - dotnet
+---
+
+# Asaas Payment Integration Standards
+
+@.morph/framework/standards/backend/integrations/asaas/asaas-api.md

package/framework/rules/clerk-standards.md

@@ -0,0 +1,13 @@
+---
+paths:
+  - "**/Auth/**"
+  - "**/auth/**"
+  - "**/Identity/**"
+  - "**/Clerk/**"
+stacks:
+  - dotnet
+---
+
+# Clerk Authentication Standards
+
+@.morph/framework/standards/backend/integrations/clerk/clerk-auth.md

package/framework/rules/csharp-standards.md

@@ -4,10 +4,14 @@ paths:
   - "**/*.csproj"
 stacks:
   - dotnet
-  - blazor
 ---
 
-# C# and .NET Standards
+# C# and .NET VSA Standards
 
-@.morph/framework/standards/core/coding.md
-@.morph/framework/standards/backend/dotnet/core.md
+@.morph/framework/standards/architecture/vertical-slice/vertical-slice.md
+@.morph/framework/standards/backend/dotnet/vsa-handler-patterns.md
+@.morph/framework/standards/backend/dotnet/result-pattern.md
+@.morph/framework/standards/backend/dotnet/fluent-validation-vsa.md
+@.morph/framework/standards/backend/dotnet/scrutor.md
+@.morph/framework/standards/backend/dotnet/scalar-ui.md
+@.morph/framework/standards/backend/api/validation.md

package/framework/rules/data-standards.md

@@ -0,0 +1,18 @@
+---
+paths:
+  - "**/*Cache*.cs"
+  - "**/*Redis*.cs"
+  - "**/*Cosmos*.cs"
+  - "**/*Vector*.cs"
+  - "**/*Embedding*.cs"
+  - "**/*Rag*.cs"
+stacks:
+  - dotnet
+---
+
+# Data & Cache Standards
+
+@.morph/framework/standards/data/nosql/cache/redis.md
+@.morph/framework/standards/data/nosql/cosmos-db.md
+@.morph/framework/standards/data/vector-search/rag-chunking.md
+@.morph/framework/standards/backend/database/vector-search-rag.md

package/framework/rules/dotnet-templates.md

@@ -0,0 +1,87 @@
+---
+paths:
+  - "**/*.cs"
+  - "**/*.csproj"
+stacks:
+  - dotnet
+---
+
+# .NET Code Templates
+
+When implementing .NET features, use these templates as reference patterns.
+Read the template file to see the exact pattern, then generate code following it.
+
+## Scaffold (preferred for new slices)
+
+**Always use scaffold for new VSA slices — never create feature files manually.**
+
+```bash
+morph-spec scaffold dotnet <feature> <slice-name> [--namespace <ns>] [--dry-run]
+```
+
+Examples:
+```bash
+morph-spec scaffold dotnet book create-book
+morph-spec scaffold dotnet book get-book-by-id
+morph-spec scaffold dotnet book update-book
+morph-spec scaffold dotnet book delete-book
+morph-spec scaffold dotnet book get-all-books
+```
+
+Generates 7 files: endpoint, handler, request, response, validator + entity, errors (shared at feature level). Entity/errors auto-skipped if they already exist.
+
+**Only use `template render` for individual files when adding to an existing slice.**
+
+## VSA Feature Templates (Vertical Slice Architecture)
+
+For each new feature slice, follow the patterns in these templates:
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Endpoint | `.morph/framework/templates/code/dotnet/feature/endpoint.cs.hbs` | IApiEndpoint with MapEndpoint() |
+| Handler | `.morph/framework/templates/code/dotnet/feature/handler.cs.hbs` | IHandler<TRequest, TResponse> |
+| Request | `.morph/framework/templates/code/dotnet/feature/request.cs.hbs` | Sealed record DTO |
+| Response | `.morph/framework/templates/code/dotnet/feature/response.cs.hbs` | Sealed record DTO |
+| Validator | `.morph/framework/templates/code/dotnet/feature/validator.cs.hbs` | FluentValidation AbstractValidator |
+| Entity | `.morph/framework/templates/code/dotnet/feature/entity.cs.hbs` | Domain entity |
+| Errors | `.morph/framework/templates/code/dotnet/feature/errors.cs.hbs` | Error factory |
+
+## Base Abstractions (read once per project setup)
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| IHandler | `.morph/framework/templates/code/dotnet/abstractions/handler.cs` | Handler interface |
+| Result<T> | `.morph/framework/templates/code/dotnet/abstractions/result.cs` | Railway-oriented result |
+| Error | `.morph/framework/templates/code/dotnet/abstractions/error.cs` | Error types |
+| IApiEndpoint | `.morph/framework/templates/code/dotnet/abstractions/api-endpoint.cs` | Endpoint interface |
+
+## Extensions & Pipeline (read once per project setup)
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Handler Registration | `.morph/framework/templates/code/dotnet/extensions/handler-registration.cs` | Scrutor auto-discovery |
+| Map Endpoints | `.morph/framework/templates/code/dotnet/extensions/map-endpoints.cs` | IApiEndpoint discovery |
+| Result Extensions | `.morph/framework/templates/code/dotnet/extensions/result-extensions.cs` | Match() pattern |
+| Database Config | `.morph/framework/templates/code/dotnet/extensions/database-extensions.cs` | EF Core + Npgsql |
+| Health Checks | `.morph/framework/templates/code/dotnet/extensions/health-checks.cs` | Health endpoints |
+| Validation Decorator | `.morph/framework/templates/code/dotnet/pipelines/validation-decorator.cs` | FluentValidation pipeline |
+| Logging Decorator | `.morph/framework/templates/code/dotnet/pipelines/logging-decorator.cs` | Duration tracking |
+| Exception Handler | `.morph/framework/templates/code/dotnet/exceptions/exception-handler.cs` | ProblemDetails |
+| API Tags | `.morph/framework/templates/code/dotnet/constants/api-tags.cs` | Scalar/Swagger groups |
+
+## Specialized Templates
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Repository | `.morph/framework/templates/code/dotnet/backend/repository.cs` | EF Core repository |
+| Migration | `.morph/framework/templates/code/dotnet/database/migration.cs` | EF Core migration |
+| Hangfire Job | `.morph/framework/templates/code/dotnet/jobs/job.cs` | Background job |
+| MAF Agent | `.morph/framework/templates/code/dotnet/jobs/agent.cs` | MS Agent Framework |
+| Unit Test | `.morph/framework/templates/code/dotnet/test.cs` | xUnit AAA test |
+| Contracts VSA | `.morph/framework/templates/code/dotnet/contracts/contracts-vsa.cs` | Full slice contracts |
+
+## Usage
+
+1. **Read the template** to see the exact pattern
+2. **Generate code following the same structure** (naming, namespaces, imports)
+3. Or render via CLI: `morph-spec template render <id> <output> '<variables>'`