@polymorphism-tech/morph-spec 10.2.0 → 10.5.3

package/framework/skills/core/morph-apply/references/machine.md

@@ -14,8 +14,9 @@ Para manter a máquina utilizável enquanto você compila e testa. Aplique quand
 | Sintoma | Comando | Como ler e o que fazer |
 |---|---|---|
 | Máquina ou editor lento, pouca RAM | `morph-spec doctor --procs` (só lê) | Cada linha diz órfão ou protegido, com a razão. Sem órfão, a pressão vem de fora (vmmem do WSL, IDE): diga isso e passe a sugestão de `.wslconfig` que o relatório traz. Com órfão, mostre a lista e ofereça `--prune`. |
-| Comando voltou `⏳ … não rodou` ou exit 3 | `morph-spec heavy status` | Mostra quem segura cada vaga, há quanto tempo, e a RAM livre. A vaga solta sozinha (processo morto ou timeout). Vaga presa por sessão viva: diga ao usuário quem a segura. Se a causa for RAM e nenhuma vaga estiver presa, rode `doctor --procs`. |
-| Várias features abertas, uma por worktree, testando ao mesmo tempo | nada: a fila resolve | São 2 vagas por padrão; o que não couber espera. Se a espera virar recusa toda hora, `heavy.slots` sobe quando houver RAM. |
+| Comando voltou `⏳ … não rodou` ou exit 3 | `morph-spec heavy status` | Mostra quem segura cada vaga, há quanto tempo, e a RAM livre. A vaga solta sozinha (processo morto ou timeout). Vaga presa por sessão viva: diga ao usuário quem a segura. Se a causa for RAM e nenhuma vaga estiver presa, rode `doctor --procs`: as stacks paradas a fila já derrubou sozinha. |
+| O Claude Code encerrou um comando de fundo por pouca memória | o mesmo `morph-spec verify … --detach` | O `--detach` não morre com a sessão: repetir retoma a rodada. Outro comando pesado não se repete por conta própria: avise o usuário. |
+| Várias sessões abertas, testando ao mesmo tempo | nada: a fila resolve | São 2 vagas e uma suíte de `verify` por vez. O `verify --detach` espera a vez (até `heavy.detachedWaitMinutes`), então espera longa é fila, não problema: não cancele nem peça ao usuário. Abaixo do piso, a fila derruba sozinha as stacks ociosas; `heavy reclaim` faz o mesmo à mão. |
 | Worktree sobrando ou fora do contêiner | `morph-spec doctor --worktrees` | Lista cada árvore com a razão; remova só por `worktree remove`. |
 | A worktree precisa de arquivo fora do git (`.env`, segredos) | `.worktreeinclude` na raiz do repo | Um padrão por linha, sintaxe do gitignore. Copia só o que casa **e** é ignorado; nunca `node_modules`, build ou `.git`. O `setup` e o `provision` aplicam. |
 | Editor pesado por causa das worktrees | `worktree.root` em `.morph/config/config.json` | Põe as worktrees fora da árvore aberta (caminho absoluto fora do projeto). `init` e `update` já gravam as exclusões no `.vscode/settings.json`. |

package/framework/skills/core/morph-apply/references/review.md

@@ -10,9 +10,9 @@ Por que fresco: o que você sabe da implementação é o ponto cego que eles exi
 
 ## 2. Prova da suíte — uma rodada
 
-Commite e rode `morph-spec verify {feature} --ci --json` em `run_in_background` (sem CI, roda local e diz por quê). Sem `--filter`, sempre: verde filtrado é verde sobre código não testado. `reason: "stamp-reused"` = nada andou desde o último verde: vale. Saída `CI rodando` → despache (passo 3) sem esperar o fim; `verify local` → espere, a máquina é uma só.
+A rodada afetada do §3 da `SKILL.md`, verde, é o que abre o dispatch. A completa vem depois dos relatórios (§6), uma vez só: assim uma correção do Gate 3 não paga duas rodadas cheias, e o que a completa encontrar ainda passa pela confirmação.
 
-`flaky` no resultado do verify → a lista vai ao verificador. Nó `e2e` `pass` → `morph-spec e2e status {feature} --json` → `baseUrl` vai ao verificador. `fail` → correção (CI: `gh run view <id> --log-failed`). `skip` → o `gate-check` decide se dispensa (`classifyE2eSkip`, em `risk-detector.js`: docker indisponível pausa sozinho, sem `gate-decision` à mão).
+`flaky` no resultado do verify → a lista vai ao verificador. Com `e2eChecks`, `morph-spec e2e status {feature} --json` → `baseUrl` vai ao verificador.
 
 ## 3. Dispatch — os três na mesma resposta
 
@@ -43,12 +43,14 @@ Não rode build nem teste enquanto um agente está `running`. Com todos de volta
 
 ## 5. Bloqueadores
 
-O avaliador também erra: **reproduza cada bloqueador antes de editar**. Não se reproduz → é nota sua no `report.md`, e o próximo dispatch de confirmação recebe a contra-evidência. Confirmado → corrija, commite, `verify {feature}` local, foto `--before-eval` nova.
+O avaliador também erra: **reproduza cada bloqueador antes de editar**. Não se reproduz → é nota sua no `report.md`, e o próximo dispatch de confirmação recebe a contra-evidência. Confirmado → corrija, commite, `verify {feature} --affected`, foto `--before-eval` nova.
 
 Confirmação = **dispatch novo** só dos papéis em `gate3.redispatch`, com o `sha` novo e o escopo da rodada: quem abriu bloqueadores confirma só esses (verificador: "confirme só C2, C5"); os outros julgam só o delta `{sha anterior}..{sha novo}`. Papel com SHIP limpo não volta se o delta ficar nos arquivos citados pelos bloqueadores ou em teste; a segurança, se o delta não tocar caminho sensível. Ninguém reavalia a feature inteira. O relatório é append-only e vale o último `**Verdict:**`; o `approve` recusa quando o código andou depois de um `**Reviewed-SHA:**`, salvo esse caso, com quem abriu bloqueador confirmando o `HEAD`.
 
 ## 6. Gate 3
 
+**A rodada completa:** com os relatórios sem bloqueador, `morph-spec verify {feature} --ci --json --detach` em `run_in_background` (sem CI, roda local e diz por quê; repetir o comando retoma a rodada). É a única. Sem `--filter`, sempre, e sem `--affected`: verde filtrado é verde sobre código não testado, e é ela que o gate lê. `reason: "stamp-reused"` = nada andou desde o último verde: vale. Saída `CI rodando` → espere a notificação. `fail` → corrija (CI: `gh run view <id> --log-failed`) e siga o §5, porque a correção é código que ninguém revisou. Nó `e2e` em `skip` → o `gate-check` decide se dispensa (`classifyE2eSkip`, em `risk-detector.js`: docker indisponível pausa sozinho).
+
 `morph-spec gate-check {feature} review [--json]` lê os relatórios, a cobertura dos `Cn` e os demais sinais. Forçar passagem apesar da pausa: `morph-spec gate-decision {feature} review --pause false --reason "…"`.
 
 Pausa com `resolver: "session"` não é pergunta: faça o que a `reason` diz e rode o `gate-check` de novo. Verify vermelho ou velho → corrija e `verify {feature}`; e2e pulado a pedido → `verify {feature}` sem `--skip-e2e`; bloqueador ou `Cn` não provado → §5; relatório ausente ou sem seção → dispatch. Vira `human` sozinho depois de `FIX_ATTEMPTS` verify vermelhos seguidos ou rodadas de review: a disputa é do usuário.

package/framework/skills/core/morph-plan/SKILL.md

@@ -4,7 +4,7 @@ description: Leva um pedido ou o link de uma issue ao plano aprovado — roteia
 version: core
 when_to_use: Use quando uma feature, bug ou chore começar ("/morph-plan {feature}", "/morph-plan <link da issue>", "vamos planejar X"), ou ao retomar uma feature cujo gate plan ainda não foi aprovado
 user-invocable: true
-cliVersion: "10.2.0"
+cliVersion: "10.5.3"
 ---
 
 # morph-plan
@@ -50,7 +50,7 @@ Por conceito central que o plano pretende criar (entidade, DTO, componente, hook
 
 O `create` escreveu o esqueleto; a gramática completa chega pela rule `plan-grammar` quando você abre o `plan.md`; o resto em `morph-spec plan-check --help`. O que importa:
 
-- **`Resultado buscado:`** uma linha em `## Problema`: o estado depois, o que muda, para quem e como se percebe. É contra ela que a `morph-apply` decide se uma descoberta invalida o plano.
+- **`Resultado buscado:`** uma linha em `## Problema`: o estado depois, o que muda, para quem e como se percebe; o objetivo por trás do pedido, nunca o pedido reescrito. Medível, leva um número específico e difícil: alvo pequeno se atinge ajustando, alvo duro obriga a repensar. É contra ela que a `morph-apply` decide se uma descoberta invalida o plano e que o revisor lê as notas do Gate 3.
 - **`## Cenários` é a definição de pronto.** Cada `Cn` é um comportamento observável que o verificador do Gate 3 vai **executar** contra a app — escreva-o como um fluxo de usuário ou uma regra que dá para disparar. `prova:` `teste` (com `risco:`) | `e2e` | `eval` | `manual` | `leitura`. Sem risco, `leitura`.
 - **`degrau:`** quando o `Cn` não se desfaz com revert: `migrar` (toda migration, aditiva ou não: drop, rename, backfill, coluna nova) ou `irreversível` (apaga dado que alguém lê, quebra contrato externo). Sem a linha, `refazer`. Esses dois degraus pausam o gate do plano para o usuário, e o Gate 3 pausa em migration sem degrau, em arquivo de contrato (`openapi`, `.proto`) sem `irreversível`, e no bloqueador `irreversivel` do revisor.
 - **`## Padrões assumidos`**: todo valor de baixo risco que você decidiu sem perguntar, numerado `1.`…`N.`, com o valor. É o que tira a pergunta trivial da entrevista: o usuário veta por número. Auth, credencial, permissão, pagamento e apagar dado nunca entram: são pergunta.
@@ -60,7 +60,8 @@ O `create` escreveu o esqueleto; a gramática completa chega pela rule `plan-gra
 - **`## Arquitetura`**: onde entra, o que conversa com o quê, edge cases técnicos. Gera imagem ou vídeo por IA → cite aqui o standard (`ai-agents-modalities-image-gen`, `ai-agents-media-video`, `ai-agents-media-pipeline`): é a citação que arma as provas de mídia do Gate 3, e o `plan-check` recusa o plano que fala em mídia gerada sem ela (falso positivo: a linha `Mídia gerada: não`).
 
 **Contrato de implementação**: o que quem implementa precisa e o código não diz.
-- **Instrumentos:** o que falta para provar sozinho (ferramenta, acesso, dado, ambiente), perguntado antes do gate; "nenhuma lacuna" vale.
+- **Profundidade** (`feature`, antes de fechar os cenários; plano pequeno, §6, dispensa): uma linha para cada, sem aumentar o escopo: o que um profissional da área faria aqui que o pedido não pede; a matéria-prima mais crua de que ele partiria (export de produção, log, trace, nunca o resumo); o método e a ferramenta dele; o que, além de você e do verificador, mostra que está certo. Troque o substantivo por um verbo ("painel" → "fazer o dono decidir em 30 segundos") e pergunte que campo faz esse verbo melhor: importe o método dele, nunca a voz. O que sobrar vira `Cn`, instrumento ou `## Fora de escopo`.
+- **Instrumentos:** o que falta para provar sozinho, perguntado antes do gate: onde o problema aparece, o contexto para entendê-lo e a bancada onde reproduzir e provar (ferramenta, acesso, dado, ambiente). Prova que só existe depois do deploy se diz aqui, antes do gate; "nenhuma lacuna" vale.
 - **Verificação de runtime:** o stack sobe por `morph-spec e2e up {feature}`: app sem dependência (dados no `localStorage`, só APIs externas) sobe só por `e2e.hostServices` (build + start + health, sem compose); com dependência (banco, fila) o compose do projeto sobe ela, e criá-lo entra no plano; os fluxos que o verificador navega, nos verbos dos cenários; base URL `process.env.PLAYWRIGHT_BASE_URL ?? \`http://localhost:${process.env.PORT ?? 3000}\``, compose com `"${PORT:-3000}:3000"` e sem `container_name` (standard `infrastructure/docker/local-compose-isolation`). App de build caro no Docker também sobe como processo do host por `e2e.hostServices`, ao lado do compose das dependências. Login: `e2e.auth` (`mode: seed|storageState|bypass|none`, `seedCommand`, credenciais num `.env.e2e` gitignored) — **`mode` é obrigatório sempre que houver `seedCommand`**, sem ele o seed fica inerte. Estado limpo entre fluxos: o `e2e reset` recria os volumes de dados do stack da feature (`morph-{f}_*`); volume com `name:` fixo é compartilhado com o stack de desenvolvimento, e aí o reset recusa até existir `e2e.resetCommand`. Biblioteca pura: registre a dispensa e o porquê.
 - **Baseline é um COMANDO, nunca um número** (`npm test`, `dotnet test`): número cravado está errado na primeira mudança. `expectedCount` (só `node-test`/`evals`) sai de `morph-spec verify {feature} --record-baseline`, nunca digitado. Sem `project.stack`/`project.tests` no `config.json`, a `morph-apply` os declara a partir destes comandos.
 - **Pré-requisito é um PREDICADO, nunca um SHA literal:** "`git merge-base --is-ancestor origin/main HEAD` sai 0".

package/framework/skills/core/morph-plan/references/critique.md

@@ -15,7 +15,7 @@ Nunca a conversa, as respostas da entrevista nem o seu resumo do plano ou do ped
 > `premissa` (o plano afirma algo do código que o código desmente: arquivo, símbolo, contagem, flag);
 > `contradicao` (duas partes do plano se negam);
 > `decisao` (o plano escolhe um valor ou um caminho sem dizer, e o usuário pode querer outro);
-> `cenario` (um `Cn` que nenhuma asserção ou passo no navegador consegue provar);
+> `cenario` (um `Cn` que nenhuma asserção ou passo no navegador consegue provar, ou um `e2e` que confere o controle na tela em vez de disparar a ação até o efeito);
 > `desvio` (o plano não resolve o pedido, sem ADR ou `## Fora de escopo` que diga por quê).
 > Sem `description`, ou com um link que não abre, pule `desvio` e diga isso numa linha depois da tabela.
 > Estilo, nome e "eu faria diferente" não entram. Sem achado, escreva "Nenhum achado." no lugar da tabela, mantendo o título e o `**Plan-Hash:**`.

package/framework/skills/core/morph-uiux/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase de UI/UX de uma feature com plano aprovado — render
 version: core
 when_to_use: Use quando o ramo de design for tomado (morph-spec advance {feature} --design), antes de /morph-apply
 user-invocable: true
-cliVersion: "10.2.0"
+cliVersion: "10.5.3"
 ---
 
 # morph-uiux

package/framework/templates/IDE-SNIPPETS.md

@@ -1,262 +1,262 @@
-# 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-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 "Nextjs")}}
-  // Next.js-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 "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*
+# 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-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 "Nextjs")}}
+  // Next.js-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 "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*

package/framework/templates/code/dotnet/abstractions/api-endpoint.cs

@@ -1,7 +1,7 @@
-namespace {{pascalCase PROJECT_NAME}}.Abstractions
-{
-    public interface IApiEndpoint
-    {
-       void MapEndpoint(IEndpointRouteBuilder app);
-    }
-}
+namespace {{pascalCase PROJECT_NAME}}.Abstractions
+{
+    public interface IApiEndpoint
+    {
+       void MapEndpoint(IEndpointRouteBuilder app);
+    }
+}

package/framework/templates/code/dotnet/feature/request.cs.hbs

@@ -1,4 +1,4 @@
-namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Feature.{{pascalCase SLICE_NAME}};
-
-// TODO: Add properties matching the {{pascalCase SLICE_NAME}} command
-public sealed record {{pascalCase SLICE_NAME}}Request();
+namespace {{pascalCase PROJECT_NAME}}.Features.{{pascalCase FEATURE_NAME}}Feature.{{pascalCase SLICE_NAME}};
+
+// TODO: Add properties matching the {{pascalCase SLICE_NAME}} command
+public sealed record {{pascalCase SLICE_NAME}}Request();