@polymorphism-tech/morph-spec 4.7.0 → 4.7.2

package/.morph/framework/standards/workflows/thread-management.md

@@ -0,0 +1,113 @@
+# Workflow Standard: Thread Management
+
+## Thread Types
+
+| Type | Code | Purpose | Lifecycle |
+|------|------|---------|-----------|
+| Base | B-Thread | Default implementation thread | Bounded by feature phase |
+| Parallel | P-Thread | Concurrent isolated execution | Short (1 task scope) |
+| Fusion | F-Thread | Best-of-N competing implementations | Short (1 prompt scope) |
+| Long-Running | L-Thread | Multi-session persistent work | Days/weeks |
+| Zero-Touch | Z-Thread | Fully autonomous execution | Bounded by trust level |
+
+## Thread Lifecycle
+
+```
+pending → running → completed
+                  → failed → (retry) → running
+                           → killed
+```
+
+## Creating Threads
+```bash
+# Create a base thread (default)
+morph-spec threads status morph-next-gen
+
+# Create parallel threads for feature
+morph-spec spawn-team morph-next-gen --parallel backend,frontend,infra
+
+# Create fusion thread
+morph-spec agents fuse \
+  --prompt "Implement caching strategy for UserService" \
+  --count=3 \
+  --strategy=best-of-n \
+  --feature=morph-next-gen
+```
+
+## Thread State in state.json
+```json
+{
+  "threads": {
+    "thread-abc12345": {
+      "id": "thread-abc12345",
+      "type": "parallel",
+      "agent": "dotnet-senior",
+      "feature": "user-auth",
+      "status": "running",
+      "startedAt": "2026-02-19T00:00:00Z",
+      "events": [
+        { "type": "started", "timestamp": "..." },
+        { "type": "checkpoint_passed", "timestamp": "...", "checkpointNum": 1 }
+      ],
+      "metrics": {
+        "tasksCompleted": 3,
+        "checkpointsPassed": 1,
+        "errors": 0
+      }
+    }
+  }
+}
+```
+
+## Parallel Execution Rules (P-Threads)
+
+1. **File scope isolation**: Each P-Thread has exclusive write access to its files
+2. **No cross-thread dependencies**: P-Thread tasks are self-contained
+3. **Shared read access**: All P-Threads can read spec.md, standards, contracts
+4. **Merge on completion**: Coordinator merges results after all P-Threads complete
+5. **Max concurrent**: Default 3, max 5 (configurable in llm-interaction.json)
+
+## Dependency Analysis
+```bash
+# Analyze task dependencies for parallel opportunities
+morph-spec detect-workflow morph-next-gen
+
+# Output:
+# Parallelizable tasks: T001, T002, T003 (no dependencies)
+# Sequential: T004 (depends on T001), T005 (depends on T002)
+# Execution plan:
+#   Wave 1: [T001, T002, T003] (parallel)
+#   Wave 2: [T004, T005] (parallel, after wave 1)
+#   Wave 3: [T006] (sequential)
+```
+
+## Long-Running Threads (L-Threads)
+
+### Stop Hooks
+L-Threads run periodic stop hooks every 30 minutes:
+```json
+// llm-interaction.json
+{
+  "stopHooks": {
+    "enabled": true,
+    "interval": 30,
+    "maxRetries": 5,
+    "hooks": ["validate-and-continue", "validate-checkpoints"]
+  }
+}
+```
+
+### Resume Pattern
+```bash
+# Resume L-Thread from bundle
+morph-spec bundle load morph-next-gen
+# Load resume context, continue from checkpoint
+```
+
+## Monitoring
+```bash
+morph-spec threads list morph-next-gen
+morph-spec threads analytics morph-next-gen
+morph-spec threads wait-all morph-next-gen
+morph-spec threads wait-any morph-next-gen
+```

package/.morph/framework/templates/.idea/morph-templates.xml

@@ -0,0 +1,92 @@
+<templateSet group="MORPH Templates">
+  <template name="morph-pascal" value="{{pascalCase $FEATURE_NAME$}}" description="Convert to PascalCase (UserAuth)" toReformat="false" toShortenFQNames="true">
+    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-camel" value="{{camelCase $FEATURE_NAME$}}" description="Convert to camelCase (userAuth)" toReformat="false" toShortenFQNames="true">
+    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-snake" value="{{snakeCase $FEATURE_NAME$}}" description="Convert to snake_case (user_auth)" toReformat="false" toShortenFQNames="true">
+    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-title" value="{{titleCase $FEATURE_NAME$}}" description="Convert to Title Case (User Auth)" toReformat="false" toShortenFQNames="true">
+    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-kebab" value="{{kebabCase $FEATURE_NAME$}}" description="Convert to kebab-case (user-auth)" toReformat="false" toShortenFQNames="true">
+    <variable name="FEATURE_NAME" expression="" defaultValue="&quot;FEATURE_NAME&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-if" value="{{#if $CONDITION$}}&#10;  $END$&#10;{{/if}}" description="Handlebars if block" toReformat="false" toShortenFQNames="true">
+    <variable name="CONDITION" expression="" defaultValue="&quot;condition&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-if-else" value="{{#if $CONDITION$}}&#10;  $TRUE_BRANCH$&#10;{{else}}&#10;  $FALSE_BRANCH$&#10;{{/if}}" description="Handlebars if-else block" toReformat="false" toShortenFQNames="true">
+    <variable name="CONDITION" expression="" defaultValue="&quot;condition&quot;" alwaysStopAt="true" />
+    <variable name="TRUE_BRANCH" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
+    <variable name="FALSE_BRANCH" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-each" value="{{#each $ITEMS$}}&#10;  {{this.$PROPERTY$}}&#10;{{/each}}" description="Handlebars each loop" toReformat="false" toShortenFQNames="true">
+    <variable name="ITEMS" expression="" defaultValue="&quot;items&quot;" alwaysStopAt="true" />
+    <variable name="PROPERTY" expression="" defaultValue="&quot;name&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="OTHER" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-service" value="namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;&#10;&#10;public class {{pascalCase FEATURE_NAME}}Service(&#10;    I{{pascalCase FEATURE_NAME}}Repository repository,&#10;    ILogger&lt;{{pascalCase FEATURE_NAME}}Service&gt; logger) : I{{pascalCase FEATURE_NAME}}Service&#10;{&#10;    public async Task&lt;{{pascalCase FEATURE_NAME}}Dto?&gt; GetByIdAsync(int id, CancellationToken cancellationToken = default)&#10;    {&#10;        $END$&#10;    }&#10;}" description="MORPH .NET Service class template" toReformat="false" toShortenFQNames="true">
+    <context>
+      <option name="C_SHARP" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-repository" value="public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository&#10;{&#10;    private readonly DbSet&lt;{{pascalCase FEATURE_NAME}}&gt; _dbSet = context.Set&lt;{{pascalCase FEATURE_NAME}}&gt;();&#10;&#10;    public async Task&lt;{{pascalCase FEATURE_NAME}}?&gt; GetByIdAsync(int id, CancellationToken cancellationToken = default)&#10;    {&#10;        $END$&#10;    }&#10;}" description="MORPH .NET Repository class template" toReformat="false" toShortenFQNames="true">
+    <context>
+      <option name="C_SHARP" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-component" value="@page &quot;/{{kebabCase FEATURE_NAME}}&quot;&#10;@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service&#10;@inject ILogger&lt;{{pascalCase FEATURE_NAME}}Page&gt; Logger&#10;&#10;&lt;PageTitle&gt;{{pascalCase FEATURE_NAME}}&lt;/PageTitle&gt;&#10;&#10;&lt;div class=&quot;container-fluid&quot;&gt;&#10;    $END$&#10;&lt;/div&gt;&#10;&#10;@code {&#10;&#10;}" description="MORPH Blazor component template" toReformat="false" toShortenFQNames="true">
+    <context>
+      <option name="HTML" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-migration" value="public partial class Add{{pascalCase FEATURE_NAME}} : Migration&#10;{&#10;    protected override void Up(MigrationBuilder migrationBuilder)&#10;    {&#10;        migrationBuilder.CreateTable(&#10;            name: &quot;{{pascalCase FEATURE_NAME}}s&quot;,&#10;            columns: table =&gt; new&#10;            {&#10;                Id = table.Column&lt;int&gt;(type: &quot;int&quot;, nullable: false)&#10;                    .Annotation(&quot;SqlServer:Identity&quot;, &quot;1, 1&quot;),&#10;                $END$&#10;            },&#10;            constraints: table =&gt;&#10;            {&#10;                table.PrimaryKey(&quot;PK_{{pascalCase FEATURE_NAME}}s&quot;, x =&gt; x.Id);&#10;            });&#10;    }&#10;&#10;    protected override void Down(MigrationBuilder migrationBuilder)&#10;    {&#10;        migrationBuilder.DropTable(name: &quot;{{pascalCase FEATURE_NAME}}s&quot;);&#10;    }&#10;}" description="MORPH EF Core migration template" toReformat="false" toShortenFQNames="true">
+    <context>
+      <option name="C_SHARP" value="true" />
+    </context>
+  </template>
+
+  <template name="morph-ts-contract" value="export interface {{pascalCase FEATURE_NAME}} {&#10;  id: number;&#10;  $FIELD1$&#10;}&#10;&#10;export interface Create{{pascalCase FEATURE_NAME}}Request {&#10;  $FIELD2$&#10;}&#10;&#10;export interface Update{{pascalCase FEATURE_NAME}}Request {&#10;  $END$&#10;}" description="MORPH TypeScript contract template" toReformat="false" toShortenFQNames="true">
+    <variable name="FIELD1" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
+    <variable name="FIELD2" expression="" defaultValue="&quot;&quot;" alwaysStopAt="true" />
+    <context>
+      <option name="TypeScript" value="true" />
+    </context>
+  </template>
+</templateSet>

package/.morph/framework/templates/.vscode/morph-templates.code-snippets

@@ -0,0 +1,186 @@
+{
+  "MORPH Template - PascalCase": {
+    "prefix": "morph-pascal",
+    "body": ["{{pascalCase ${1:FEATURE_NAME}}}"],
+    "description": "Convert to PascalCase (UserAuth)"
+  },
+  "MORPH Template - camelCase": {
+    "prefix": "morph-camel",
+    "body": ["{{camelCase ${1:FEATURE_NAME}}}"],
+    "description": "Convert to camelCase (userAuth)"
+  },
+  "MORPH Template - snake_case": {
+    "prefix": "morph-snake",
+    "body": ["{{snakeCase ${1:FEATURE_NAME}}}"],
+    "description": "Convert to snake_case (user_auth)"
+  },
+  "MORPH Template - Title Case": {
+    "prefix": "morph-title",
+    "body": ["{{titleCase ${1:FEATURE_NAME}}}"],
+    "description": "Convert to Title Case (User Auth)"
+  },
+  "MORPH Template - kebab-case": {
+    "prefix": "morph-kebab",
+    "body": ["{{kebabCase ${1:FEATURE_NAME}}}"],
+    "description": "Convert to kebab-case (user-auth)"
+  },
+  "MORPH Template - UPPER_SNAKE_CASE": {
+    "prefix": "morph-upper-snake",
+    "body": ["{{upperSnakeCase ${1:FEATURE_NAME}}}"],
+    "description": "Convert to UPPER_SNAKE_CASE (USER_AUTH)"
+  },
+  "MORPH Template - Conditional If": {
+    "prefix": "morph-if",
+    "body": [
+      "{{#if ${1:condition}}}",
+      "  $2",
+      "{{/if}}"
+    ],
+    "description": "Handlebars if block"
+  },
+  "MORPH Template - Conditional If-Else": {
+    "prefix": "morph-if-else",
+    "body": [
+      "{{#if ${1:condition}}}",
+      "  $2",
+      "{{else}}",
+      "  $3",
+      "{{/if}}"
+    ],
+    "description": "Handlebars if-else block"
+  },
+  "MORPH Template - Each Loop": {
+    "prefix": "morph-each",
+    "body": [
+      "{{#each ${1:items}}}",
+      "  {{this.$2}}",
+      "{{/each}}"
+    ],
+    "description": "Handlebars each loop"
+  },
+  "MORPH Template - Unless": {
+    "prefix": "morph-unless",
+    "body": [
+      "{{#unless ${1:condition}}}",
+      "  $2",
+      "{{/unless}}"
+    ],
+    "description": "Handlebars unless block"
+  },
+  "MORPH Template - .NET Service Class": {
+    "prefix": "morph-service",
+    "body": [
+      "namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;",
+      "",
+      "public class {{pascalCase FEATURE_NAME}}Service(",
+      "    I{{pascalCase FEATURE_NAME}}Repository repository,",
+      "    ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service",
+      "{",
+      "    public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)",
+      "    {",
+      "        $1",
+      "    }",
+      "}"
+    ],
+    "description": "MORPH .NET Service class template"
+  },
+  "MORPH Template - .NET Repository Class": {
+    "prefix": "morph-repository",
+    "body": [
+      "public class {{pascalCase FEATURE_NAME}}Repository(AppDbContext context) : I{{pascalCase FEATURE_NAME}}Repository",
+      "{",
+      "    private readonly DbSet<{{pascalCase FEATURE_NAME}}> _dbSet = context.Set<{{pascalCase FEATURE_NAME}}>();",
+      "",
+      "    public async Task<{{pascalCase FEATURE_NAME}}?> GetByIdAsync(int id, CancellationToken cancellationToken = default)",
+      "    {",
+      "        $1",
+      "    }",
+      "}"
+    ],
+    "description": "MORPH .NET Repository class template"
+  },
+  "MORPH Template - Blazor Component": {
+    "prefix": "morph-component",
+    "body": [
+      "@page \"/{{kebabCase FEATURE_NAME}}\"",
+      "@inject I{{pascalCase FEATURE_NAME}}Service {{pascalCase FEATURE_NAME}}Service",
+      "@inject ILogger<{{pascalCase FEATURE_NAME}}Page> Logger",
+      "",
+      "<PageTitle>{{pascalCase FEATURE_NAME}}</PageTitle>",
+      "",
+      "<div class=\"container-fluid\">",
+      "    $1",
+      "</div>",
+      "",
+      "@code {",
+      "    $2",
+      "}"
+    ],
+    "description": "MORPH Blazor component template"
+  },
+  "MORPH Template - EF Core Migration": {
+    "prefix": "morph-migration",
+    "body": [
+      "public partial class Add{{pascalCase FEATURE_NAME}} : Migration",
+      "{",
+      "    protected override void Up(MigrationBuilder migrationBuilder)",
+      "    {",
+      "        migrationBuilder.CreateTable(",
+      "            name: \"{{pascalCase FEATURE_NAME}}s\",",
+      "            columns: table => new",
+      "            {",
+      "                Id = table.Column<int>(type: \"int\", nullable: false)",
+      "                    .Annotation(\"SqlServer:Identity\", \"1, 1\"),",
+      "                $1",
+      "            },",
+      "            constraints: table =>",
+      "            {",
+      "                table.PrimaryKey(\"PK_{{pascalCase FEATURE_NAME}}s\", x => x.Id);",
+      "            });",
+      "    }",
+      "",
+      "    protected override void Down(MigrationBuilder migrationBuilder)",
+      "    {",
+      "        migrationBuilder.DropTable(name: \"{{pascalCase FEATURE_NAME}}s\");",
+      "    }",
+      "}"
+    ],
+    "description": "MORPH EF Core migration template"
+  },
+  "MORPH Template - Hangfire Job": {
+    "prefix": "morph-job",
+    "body": [
+      "public class {{pascalCase FEATURE_NAME}}ProcessorJob(",
+      "    I{{pascalCase FEATURE_NAME}}Service service,",
+      "    ILogger<{{pascalCase FEATURE_NAME}}ProcessorJob> logger) : I{{pascalCase FEATURE_NAME}}ProcessorJob",
+      "{",
+      "    [AutomaticRetry(Attempts = 3, DelaysInSeconds = new[] { 60, 300, 900 })]",
+      "    [Queue(\"default\")]",
+      "    [JobDisplayName(\"{{pascalCase FEATURE_NAME}} Processing - ID: {0}\")]",
+      "    public async Task ExecuteAsync(int id, CancellationToken cancellationToken)",
+      "    {",
+      "        $1",
+      "    }",
+      "}"
+    ],
+    "description": "MORPH Hangfire job template"
+  },
+  "MORPH Template - TypeScript Contract": {
+    "prefix": "morph-ts-contract",
+    "body": [
+      "export interface {{pascalCase FEATURE_NAME}} {",
+      "  id: number;",
+      "  $1",
+      "}",
+      "",
+      "export interface Create{{pascalCase FEATURE_NAME}}Request {",
+      "  $2",
+      "}",
+      "",
+      "export interface Update{{pascalCase FEATURE_NAME}}Request {",
+      "  $3",
+      "}"
+    ],
+    "description": "MORPH TypeScript contract template"
+  }
+}

package/.morph/framework/templates/IDE-SNIPPETS.md

@@ -0,0 +1,266 @@
+# IDE Snippets for MORPH Templates
+
+> Boost your productivity with IDE snippets for Handlebars template syntax
+
+---
+
+## 📦 Installation
+
+### VS Code
+
+**Option 1: Project Snippets (Recommended)**
+
+Snippets are already configured in `framework/templates/.vscode/morph-templates.code-snippets`.
+
+To use them:
+1. Open your project in VS Code
+2. Snippets auto-activate when editing template files
+3. Type a prefix (e.g., `morph-pascal`) and press `Tab`
+
+**Option 2: Global Snippets**
+
+To use snippets across all projects:
+1. Open VS Code
+2. Go to `File > Preferences > Configure User Snippets`
+3. Select `New Global Snippets file...`
+4. Name it `morph-templates.code-snippets`
+5. Copy content from `framework/templates/.vscode/morph-templates.code-snippets`
+
+---
+
+### JetBrains IDEs (Rider, WebStorm, IntelliJ IDEA)
+
+**Installation:**
+
+1. Open your IDE
+2. Go to `File > Settings > Editor > Live Templates`
+3. Click the `⚙️` gear icon → `Import Settings...`
+4. Select `framework/templates/.idea/morph-templates.xml`
+5. Click `OK` to import
+
+**Activation:**
+
+Snippets will be available in the "MORPH Templates" group. Type the prefix and press `Tab`.
+
+---
+
+## 🎯 Available Snippets
+
+### Handlebars Helpers (Case Transformations)
+
+| Prefix | Output | Example Result |
+|--------|--------|----------------|
+| `morph-pascal` | `{{pascalCase FEATURE_NAME}}` | `UserAuthentication` |
+| `morph-camel` | `{{camelCase FEATURE_NAME}}` | `userAuthentication` |
+| `morph-snake` | `{{snakeCase FEATURE_NAME}}` | `user_authentication` |
+| `morph-title` | `{{titleCase FEATURE_NAME}}` | `User Authentication` |
+| `morph-kebab` | `{{kebabCase FEATURE_NAME}}` | `user-authentication` |
+| `morph-upper-snake` | `{{upperSnakeCase FEATURE_NAME}}` | `USER_AUTHENTICATION` |
+
+### Handlebars Control Flow
+
+| Prefix | Description | Example |
+|--------|-------------|---------|
+| `morph-if` | If block | `{{#if condition}}...{{/if}}` |
+| `morph-if-else` | If-else block | `{{#if condition}}...{{else}}...{{/if}}` |
+| `morph-each` | Loop over array | `{{#each items}}{{this.name}}{{/each}}` |
+| `morph-unless` | Unless block | `{{#unless condition}}...{{/unless}}` |
+
+### .NET Templates
+
+| Prefix | Template | File Extension |
+|--------|----------|----------------|
+| `morph-service` | Service class (business logic) | `.cs` |
+| `morph-repository` | Repository class (data access) | `.cs` |
+| `morph-component` | Blazor component | `.razor` |
+| `morph-migration` | EF Core migration | `.cs` |
+| `morph-job` | Hangfire background job | `.cs` |
+
+### TypeScript Templates
+
+| Prefix | Template | File Extension |
+|--------|----------|----------------|
+| `morph-ts-contract` | TypeScript interfaces (DTOs) | `.ts` |
+
+---
+
+## 🚀 Usage Examples
+
+### Example 1: Creating a Service Template
+
+**Steps:**
+1. Create new file: `UserService.cs`
+2. Type `morph-service` → Press `Tab`
+3. Result:
+   ```csharp
+   namespace {{NAMESPACE}}.Application.Features.{{pascalCase FEATURE_NAME}}.Services;
+
+   public class {{pascalCase FEATURE_NAME}}Service(
+       I{{pascalCase FEATURE_NAME}}Repository repository,
+       ILogger<{{pascalCase FEATURE_NAME}}Service> logger) : I{{pascalCase FEATURE_NAME}}Service
+   {
+       public async Task<{{pascalCase FEATURE_NAME}}Dto?> GetByIdAsync(int id, CancellationToken cancellationToken = default)
+       {
+           // Cursor here
+       }
+   }
+   ```
+
+### Example 2: Using Case Helpers
+
+**Scenario:** Convert `user-authentication` to different cases
+
+```handlebars
+// Type: morph-pascal → Tab
+{{pascalCase FEATURE_NAME}}  // Output: UserAuthentication
+
+// Type: morph-camel → Tab
+{{camelCase FEATURE_NAME}}   // Output: userAuthentication
+
+// Type: morph-snake → Tab
+{{snakeCase FEATURE_NAME}}   // Output: user_authentication
+```
+
+### Example 3: Conditional Rendering
+
+**Scenario:** Show different content based on stack
+
+```handlebars
+// Type: morph-if-else → Tab
+{{#if (eq STACK "Blazor")}}
+  // Blazor-specific code
+{{else}}
+  // Generic code
+{{/if}}
+```
+
+### Example 4: Looping Over Items
+
+**Scenario:** Generate multiple DTOs
+
+```handlebars
+// Type: morph-each → Tab
+{{#each entities}}
+  public class {{pascalCase this.name}}Dto
+  {
+      // Properties
+  }
+{{/each}}
+```
+
+---
+
+## 📝 Customizing Snippets
+
+### VS Code
+
+Edit `framework/templates/.vscode/morph-templates.code-snippets`:
+
+```json
+{
+  "MORPH Template - Custom": {
+    "prefix": "morph-custom",
+    "body": [
+      "// Your custom template",
+      "$1"
+    ],
+    "description": "Your description"
+  }
+}
+```
+
+### JetBrains IDEs
+
+1. Go to `File > Settings > Editor > Live Templates`
+2. Select "MORPH Templates" group
+3. Click `+` → `Live Template`
+4. Set abbreviation (prefix), description, and template text
+
+---
+
+## 🎨 Snippet Scopes
+
+| Snippet | VS Code Scope | JetBrains Scope |
+|---------|---------------|-----------------|
+| Handlebars helpers | All files | All files |
+| .NET templates | `.cs`, `.razor` | C#, HTML |
+| TypeScript templates | `.ts`, `.tsx` | TypeScript |
+
+---
+
+## 💡 Best Practices
+
+**1. Use Helpers Over Pre-computed Variables**
+
+```handlebars
+✅ GOOD: {{pascalCase FEATURE_NAME}}Service
+❌ BAD: {{FEATURE_NAME_PASCAL}}Service  // Deprecated
+```
+
+**2. Chain Helpers for Complex Transformations**
+
+```handlebars
+// Pluralize a PascalCase name
+{{pascalCase (pluralize FEATURE_NAME)}}  // Users, Orders, etc.
+```
+
+**3. Use Conditional Blocks for Stack-Specific Code**
+
+```handlebars
+{{#if (eq STACK "Blazor")}}
+  @inject NavigationManager Navigation
+{{/if}}
+{{#if (eq STACK "Nextjs")}}
+  import { useRouter } from 'next/navigation';
+{{/if}}
+```
+
+**4. Extract Common Patterns to Snippets**
+
+If you find yourself typing the same template code repeatedly, create a custom snippet!
+
+---
+
+## 🔧 Troubleshooting
+
+### Snippets Not Showing Up (VS Code)
+
+**Solution:**
+1. Check file extension matches snippet scope (e.g., `.cs` for C# snippets)
+2. Reload VS Code: `Ctrl+Shift+P` → `Developer: Reload Window`
+3. Verify snippet file location: `framework/templates/.vscode/morph-templates.code-snippets`
+
+### Snippets Not Showing Up (JetBrains)
+
+**Solution:**
+1. Verify import: `File > Settings > Editor > Live Templates` → Check "MORPH Templates" group exists
+2. Check snippet scope: Click snippet → Verify "Applicable in" contexts
+3. Restart IDE
+
+### Tab Not Expanding Snippet
+
+**Solution:**
+- **VS Code:** Ensure `editor.tabCompletion` is enabled in settings
+- **JetBrains:** Ensure `Tab` is set as expansion key in `Settings > Editor > Live Templates`
+
+---
+
+## 📚 Related Documentation
+
+- [Template System README](framework/templates/README.md) - Complete template system documentation
+- [Handlebars Helpers](framework/templates/README.md#handlebars-helpers) - Full list of available helpers
+- [CLI Template Commands](CLAUDE.md#templates) - Command-line template management
+
+---
+
+## 🎁 Contributing Custom Snippets
+
+Have a useful snippet? Share it!
+
+1. Add snippet to appropriate file (`.vscode/` or `.idea/`)
+2. Document it in this README (add row to tables)
+3. Submit PR with description of use case
+
+---
+
+*MORPH-SPEC Template Snippets by Polymorphism Tech*