@polymorphism-tech/morph-spec 4.12.0 → 4.13.0

package/framework/hooks/claude-code/session-start/resume-context.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+
+/**
+ * SessionStart Hook: Resume Context Orientation
+ *
+ * Event: SessionStart | Matcher: resume
+ *
+ * Fires ONLY when a session resumes via /resume.
+ * Injects a brief orientation message so Claude immediately knows
+ * the active feature, phase, in-progress tasks, and last checkpoint.
+ *
+ * Fail-open: exits 0 on any error.
+ */
+
+import { existsSync, readFileSync } from 'fs';
+import { join } from 'path';
+import {
+  stateExists, getActiveFeature, derivePhaseForFeature,
+} from '../../shared/state-reader.js';
+import { injectContext, pass } from '../../shared/hook-response.js';
+import { logHookActivity } from '../../shared/activity-logger.js';
+import { SPEC_SUMMARY_MAX_CHARS } from '../../shared/compact-restore.js';
+
+try {
+  if (!stateExists()) pass();
+
+  const active = getActiveFeature();
+  if (!active) pass();
+
+  const { name, feature } = active;
+  const phase = derivePhaseForFeature(name);
+  const cwd = process.cwd();
+
+  const lines = [
+    `🔄 RESUME — Você está continuando a feature "${name}" na fase ${phase}.`,
+  ];
+
+  // In-progress tasks
+  const taskList = Array.isArray(feature.taskList) ? feature.taskList : [];
+  const inProg = taskList.filter(t => t.status === 'in_progress');
+  if (inProg.length > 0) {
+    const ids = inProg.map(t => t.id).join(', ');
+    lines.push(`Tasks em progresso: ${ids}`);
+  }
+
+  // Task progress summary
+  const tasks = feature.tasks || {};
+  if (tasks.total > 0) {
+    lines.push(`Progresso: ${tasks.completed || 0}/${tasks.total} tasks concluídas`);
+  }
+
+  // Last checkpoint
+  const checkpoints = Array.isArray(feature.checkpoints) ? feature.checkpoints : [];
+  if (checkpoints.length > 0) {
+    const last = checkpoints[checkpoints.length - 1];
+    lines.push(`Último checkpoint: #${last.checkpointNum} (${last.passed ? 'passed' : 'failed'})`);
+  }
+
+  // Spec summary (truncated)
+  const specPath = join(cwd, `.morph/features/${name}/2-design/spec.md`);
+  if (existsSync(specPath)) {
+    try {
+      const raw = readFileSync(specPath, 'utf-8');
+      const summary = raw.length > SPEC_SUMMARY_MAX_CHARS
+        ? raw.slice(0, SPEC_SUMMARY_MAX_CHARS) + '\n[... truncated]'
+        : raw;
+      lines.push('');
+      lines.push('Spec summary:');
+      lines.push(summary);
+    } catch { /* non-blocking */ }
+  }
+
+  logHookActivity('resume-context', 'SessionStart', 'resume_injected');
+  injectContext(lines.join('\n'));
+} catch {
+  process.exit(0);
+}

package/framework/hooks/claude-code/statusline.py

@@ -37,19 +37,18 @@ _CREATE_NO_WINDOW = 0x08000000 if os.name == 'nt' else 0
 # ── MORPH framework constants (derived from phases.json / trust-manager.js) ──
 
 PHASE_POSITIONS = {
-    'proposal': 1, 'setup': 1,
+    'proposal': 1,
     'uiux': 2, 'design': 2,
-    'clarify': 3,
+    'plan': 3,
     'tasks': 4,
     'implement': 5, 'sync': 5,
 }
 PHASE_LABELS = {
     'proposal': 'proposal',
-    'setup': 'setup',
     'uiux': 'UI/UX',
     'design': 'design',
-    'clarify': 'refinement',
-    'tasks': 'planning',
+    'plan': 'planning',
+    'tasks': 'tasks',
     'implement': 'implement',
     'sync': 'sync',
 }

package/framework/hooks/claude-code/stop/validate-completion.js

@@ -30,7 +30,7 @@ import { logHookActivity } from '../../shared/activity-logger.js';
 const COMPACT_TRIGGER_PHASES = new Set(['implement']);
 
 // Phases where compaction is suggested when arriving from a heavy spec phase
-const HEAVY_SOURCE_PHASES = new Set(['tasks', 'design', 'clarify', 'uiux']);
+const HEAVY_SOURCE_PHASES = new Set(['tasks', 'design', 'uiux']);
 
 try {
   // Prevent infinite loop
@@ -78,7 +78,7 @@ try {
       `   loaded during planning take significant space. A compact now gives`,
       `   Claude a clean slate focused on writing code.`,
       ``,
-      `   After /compact, resume with: morph-spec task next ${name}`,
+      `   After /compact, resume with: morph-spec task start ${name} <next-task-id>`,
     );
   }
 
@@ -96,7 +96,7 @@ try {
   }
 
   // Missing outputs in spec phases
-  if (['proposal', 'design', 'clarify', 'tasks', 'uiux'].includes(currentPhase)) {
+  if (['proposal', 'design', 'tasks', 'uiux'].includes(currentPhase)) {
     const missing = getMissingOutputs(name);
     if (missing.length > 0) {
       warnings.push(`Missing outputs for '${name}' (${currentPhase} phase):`);
@@ -124,7 +124,7 @@ try {
   }
 
   // ── MEMORY.md reminder ────────────────────────────────────────────────────
-  const WORK_PHASES = new Set(['design', 'clarify', 'tasks', 'implement']);
+  const WORK_PHASES = new Set(['design', 'tasks', 'implement']);
   const memoryLines = [];
   if (WORK_PHASES.has(currentPhase)) {
     memoryLines.push('📝 Sessão encerrando. Considere salvar no MEMORY.md:');

package/framework/hooks/claude-code/user-prompt/enrich-prompt.js

@@ -39,8 +39,11 @@ try {
     if (promptLower.includes(featureName.toLowerCase())) {
       const featurePhase = feature.phase || derivePhaseForFeature(featureName);
       context.push(`[morph-spec] Feature '${featureName}': phase=${featurePhase}, status=${feature.status}`);
-      if (feature.tasks?.total > 0) {
-        context.push(`  Tasks: ${feature.tasks.completed || 0}/${feature.tasks.total} completed`);
+      const taskList = feature.taskList || [];
+      const activeTasks = taskList.filter(t => t.status !== 'expanded');
+      if (activeTasks.length > 0) {
+        const completed = activeTasks.filter(t => t.status === 'completed').length;
+        context.push(`  Tasks: ${completed}/${activeTasks.length} completed`);
       }
       break; // Only inject for the first matched feature
     }
@@ -64,15 +67,12 @@ try {
 
     // Coding intent during implement phase but no task in_progress
     if (wantsToCode && activePhase === 'implement') {
-      let hasActiveTask = feature.tasks?.inProgress > 0;
-      if (!hasActiveTask && feature.taskList) {
-        hasActiveTask = feature.taskList.some(t => t.status === 'in_progress');
-      }
+      const hasActiveTask = feature.taskList?.some(t => t.status === 'in_progress') ||
+        feature.tasks?.inProgress > 0; // fallback for legacy state
       if (!hasActiveTask) {
         context.push(
           `[morph-spec] REMINDER: No task is currently in_progress for '${name}'.` +
           ` Start a task before coding:\n` +
-          `  morph-spec task next ${name}        # see what's next\n` +
           `  morph-spec task start ${name} <id>   # mark it in progress`
         );
       }
@@ -95,7 +95,7 @@ try {
     if (promptLower.includes('next task') || promptLower.includes('what\'s next')) {
       if (activePhase === 'implement') {
         context.push(
-          `[morph-spec] Use: morph-spec task next ${name}`
+          `[morph-spec] Check tasks.md for the next task, then: morph-spec task start ${name} <id>`
         );
       }
     }

package/framework/hooks/shared/compact-restore.js

@@ -8,17 +8,19 @@
  * Pure functions — no I/O.
  */
 
-export const DECISIONS_MAX_CHARS = 1500;
-export const MAX_PENDING_TASKS   = 8;
+export const DECISIONS_MAX_CHARS     = 3000;
+export const MAX_PENDING_TASKS       = 8;
+export const SPEC_SUMMARY_MAX_CHARS  = 3000;
 
 /**
  * Build the richContext object to embed in pre-compact memory file.
- * @param {Object} feature          - Feature state object (tasks, taskList)
+ * @param {Object} feature          - Feature state object (tasks, taskList, checkpoints)
  * @param {string} phase            - Current derived phase string
  * @param {string} decisionsContent - Raw text of decisions.md (may be empty string)
+ * @param {string} [specContent=''] - Raw text of spec.md (may be empty string)
  * @returns {Object} richContext
  */
-export function buildRichContext(feature, phase, decisionsContent) {
+export function buildRichContext(feature, phase, decisionsContent, specContent = '') {
   const taskList = Array.isArray(feature.taskList) ? feature.taskList : [];
 
   const inProgress = taskList
@@ -34,12 +36,23 @@ export function buildRichContext(feature, phase, decisionsContent) {
     ? decisionsContent.slice(0, DECISIONS_MAX_CHARS)
     : decisionsContent;
 
+  const specSummary = specContent.length > SPEC_SUMMARY_MAX_CHARS
+    ? specContent.slice(0, SPEC_SUMMARY_MAX_CHARS)
+    : specContent;
+
+  const checkpoints = Array.isArray(feature.checkpoints) ? feature.checkpoints : [];
+  const lastCheckpoint = checkpoints.length > 0
+    ? { passed: checkpoints[checkpoints.length - 1].passed, checkpointNum: checkpoints[checkpoints.length - 1].checkpointNum }
+    : null;
+
   return {
     phase,
     tasks:            feature.tasks || {},
     decisionsSnippet,
     inProgress,
     nextPending,
+    specSummary,
+    lastCheckpoint,
   };
 }
 
@@ -53,7 +66,7 @@ export function buildRestoreBlock(memorySnapshot) {
   if (!rc) return null;
 
   const { timestamp, activeFeature } = memorySnapshot;
-  const { phase, tasks, decisionsSnippet, inProgress, nextPending } = rc;
+  const { phase, tasks, decisionsSnippet, inProgress, nextPending, specSummary, lastCheckpoint } = rc;
 
   const done  = tasks?.completed ?? '?';
   const total = tasks?.total     ?? '?';
@@ -63,6 +76,16 @@ export function buildRestoreBlock(memorySnapshot) {
     `Active feature: ${activeFeature} | Phase: ${phase} | Tasks: ${done}/${total}`,
   ];
 
+  if (lastCheckpoint) {
+    lines.push(`Last checkpoint: #${lastCheckpoint.checkpointNum} (${lastCheckpoint.passed ? 'passed' : 'failed'})`);
+  }
+
+  if (specSummary) {
+    lines.push('');
+    lines.push('Spec summary (at time of compact):');
+    lines.push(specSummary);
+  }
+
   if (decisionsSnippet) {
     lines.push('');
     lines.push('Key decisions (at time of compact):');

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

@@ -22,27 +22,10 @@
         { "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",
+      "index": 2,
+      "folder": "1-ui",
       "displayName": "UI/UX Design",
       "optional": true,
       "goals": [
@@ -59,14 +42,13 @@
       "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",
+      "index": 3,
+      "folder": "2-design",
       "displayName": "Technical Design",
       "goals": [
         "Write technical specification",
@@ -75,8 +57,8 @@
         "Document architectural decisions"
       ],
       "requiredOutputs": ["spec", "contracts"],
-      "optionalOutputs": ["schemaAnalysis", "clarifications", "decisions"],
-      "recommendedMCPs": ["supabase", "context7", "github"],
+      "optionalOutputs": ["schemaAnalysis", "decisions"],
+      "recommendedMCPs": ["context7", "github"],
       "pausePoints": [
         { "id": "design", "label": "Approve Design Spec" }
       ],
@@ -89,26 +71,6 @@
         { "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,
@@ -166,7 +128,7 @@
       ],
       "requiredOutputs": ["recap"],
       "optionalOutputs": [],
-      "recommendedMCPs": ["supabase", "context7", "playwright", "github", "vercel", "docker", "azure"],
+      "recommendedMCPs": ["context7", "playwright", "github", "vercel"],
       "pausePoints": [],
       "agentTiers": [1, 2, 3, 4],
       "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>'`

package/framework/rules/frontend-standards.md

@@ -1,13 +1,13 @@
----
-paths:
-  - "**/*.razor"
-  - "**/*.css"
-  - "**/*.scss"
-stacks:
-  - blazor
----
-
-# Frontend Standards
-
-@.morph/framework/standards/frontend/blazor/design-checklist.md
-@.morph/framework/standards/frontend/design-system/naming.md
+---
+paths:
+  - "**/*.tsx"
+  - "**/*.css"
+  - "**/*.scss"
+stacks:
+  - nextjs
+---
+
+# Frontend Standards
+
+@.morph/framework/standards/frontend/design-system/naming.md
+@.morph/framework/standards/frontend/design-system/animations.md

package/framework/rules/hangfire-standards.md

@@ -0,0 +1,13 @@
+---
+paths:
+  - "**/Jobs/**"
+  - "**/Background/**"
+  - "**/Hangfire/**"
+  - "**/Recurring/**"
+stacks:
+  - dotnet
+---
+
+# Hangfire Background Jobs Standards
+
+@.morph/framework/standards/backend/integrations/hangfire/hangfire-jobs.md