@polymorphism-tech/morph-spec 4.7.2 → 4.8.4

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

@@ -1,113 +0,0 @@
-# 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

@@ -1,92 +0,0 @@
-<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

@@ -1,186 +0,0 @@
-{
-  "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

@@ -1,266 +0,0 @@
-# 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*