@polymorphism-tech/morph-spec 4.12.0 → 4.14.0

package/framework/commands/morph-troubleshoot.md

@@ -1,12 +1,12 @@
 ---
-description: Find solutions for common .NET/Blazor/Azure development errors with root-cause analysis
+description: Find solutions for common .NET/Next.js development errors with root-cause analysis
 argument-hint: "[error-message]"
 allowed-tools: Read, Bash, Glob, Grep
 ---
 
 # Troubleshoot - Find Solutions for Errors
 
-Find solutions for common .NET/Blazor/Azure development errors and problems.
+Find solutions for common .NET/Next.js development errors and problems.
 
 ## Usage
 
@@ -17,11 +17,10 @@ Find solutions for common .NET/Blazor/Azure development errors and problems.
 ## Examples
 
 ```bash
-/morph-troubleshoot blazor.web.js 404
 /morph-troubleshoot DbContext second operation
-/morph-troubleshoot Azure.Identity NU1605
 /morph-troubleshoot Include returns empty
 /morph-troubleshoot PendingModelChanges
+/morph-troubleshoot next/navigation error
 ```
 
 ## 3-Level Workflow
@@ -60,13 +59,11 @@ site:github.com/dotnet/aspnetcore {error}
 site:github.com/dotnet/efcore {error}
 
 # Stack Overflow
-site:stackoverflow.com [blazor] {error}
 site:stackoverflow.com [entity-framework-core] {error}
-site:stackoverflow.com [azure] {error}
+site:stackoverflow.com [next.js] {error}
 
 # Microsoft Documentation
 site:learn.microsoft.com {error}
-site:learn.microsoft.com/azure {error}
 ```
 
 **WebSearch usage example:**
@@ -80,9 +77,8 @@ If the user asks about a SignalR error:
 
 | Category | Description |
 |-----------|-----------|
-| `blazor` | Blazor Server/WASM, components, lifecycle, rendering |
 | `efcore` | Entity Framework Core, DbContext, migrations, queries |
-| `azure` | Azure services, deploy, identity, Key Vault |
+| `nextjs` | Next.js App Router, pages, components, routing |
 | `auth` | Authentication, authorization, tokens, claims |
 | `deploy` | Deployment, CI/CD, pipelines, containers |
 
@@ -118,13 +114,10 @@ When finding a solution, present in the following format:
 
 | Error | Quick Fix |
 |------|----------------|
-| `blazor.web.js 404` | `<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>` |
 | `PendingModelChangesWarning` | `dotnet ef migrations add <Name>` before update |
 | `DbContext second operation` | Use `IDbContextFactory` for background tasks |
 | `Include()` empty | Use `HasMany(x => x.Nav)` instead of `HasMany<T>()` |
-| `Azure.Identity NU1605` | Specify explicit version in .csproj |
-| `Key Vault won't load` | Don't condition on environment (IsDevelopment) |
-| `DefaultAzureCredential slow` | Disable unused credentials |
+| `next/navigation error` | Check App Router vs Pages Router usage |
 
 ---
 

package/framework/hooks/README.md

@@ -15,14 +15,11 @@ framework/hooks/
 │   │   ├── protect-spec-files.js    # Block edits to approved spec artifacts
 │   │   └── enforce-phase-writes.js  # Enforce writes to correct phase dir
 │   ├── post-tool-use/
-│   │   ├── dispatch.js              # Dispatch on CLI commands (auto-checkpoint)
-│   │   └── context-refresh.js       # Auto-refresh context on structural git commits
+│   │   └── dispatch.js              # Dispatch on CLI commands (auto-checkpoint)
 │   ├── stop/
 │   │   └── validate-completion.js   # Advisory: warn about incomplete work
 │   ├── pre-compact/
 │   │   └── save-morph-context.js    # Snapshot state before compaction
-│   └── notification/
-│       └── approval-reminder.js     # Remind about pending approvals
 ├── shared/                          # Reusable utilities for all hooks
 │   ├── state-reader.js              # Read-only state.json accessor
 │   ├── phase-utils.js               # Phase constants and path utilities
@@ -51,11 +48,9 @@ framework/hooks/
 | **PreToolUse** (Write\|Edit) | enforce-phase-writes.js | Block | Ensures writes go to current phase directory |
 | **PreToolUse** (Bash) | _(prompt-type inline guard)_ | Block | Blocks `rm -rf .morph/` and direct state edits via Claude's reasoning |
 | **PostToolUse** (Bash) | dispatch.js | Dispatch | Triggers checkpoints on task completion |
-| **PostToolUse** (Bash) | context-refresh.js | Inject context | Detects `git commit` with structural changes → instructs Claude to update `.morph/context/README.md` and `.morph/config/config.json` |
 | **PostToolUseFailure** | handle-tool-failure.js | Logging | Appends structured JSON to .morph/logs/tool-failures.log |
 | **Stop** | validate-completion.js | Advisory | Warns about incomplete tasks/missing outputs/pending gates |
 | **PreCompact** | save-morph-context.js | Snapshot | Saves state to .morph/memory/ before compaction |
-| **Notification** | approval-reminder.js | Advisory | Reminds about pending approval gates |
 
 ## Design Principles
 

package/framework/hooks/claude-code/post-tool-use/validator-feedback.js

@@ -24,12 +24,11 @@ import { parseTaskDoneCommand } from '../../shared/dispatch-helpers.js';
 
 // Standard IDs referenced in remediation messages
 const STANDARD_REFS = {
-  'di': 'backend/dotnet/core.md#dependency-injection',
-  'async': 'backend/dotnet/async.md#cancellation-token-pattern',
-  'security': 'core/architecture.md#security-patterns',
-  'packages': 'backend/dotnet/program-cs-checklist.md#nuget-packages',
+  'di': 'dependency injection best practices',
+  'async': 'async/await and CancellationToken patterns',
+  'security': 'security best practices',
+  'packages': 'NuGet package compatibility',
   'design-system': 'frontend/design-system/naming.md#css-class-conventions',
-  'blazor': 'frontend/blazor/pitfalls.md#dbcontext-in-blazor',
 };
 
 try {
@@ -142,6 +141,5 @@ function getRefKey(ruleOrValidator) {
   if (lower.includes('security') || lower.includes('sql') || lower.includes('xss')) return 'security';
   if (lower.includes('package') || lower.includes('nuget')) return 'packages';
   if (lower.includes('design') || lower.includes('css') || lower.includes('naming')) return 'design-system';
-  if (lower.includes('blazor') || lower.includes('dbcontext')) return 'blazor';
   return null;
 }

package/framework/hooks/claude-code/pre-compact/save-morph-context.js

@@ -26,9 +26,9 @@ import { logHookActivity } from '../../shared/activity-logger.js';
 import { buildRichContext, DECISIONS_MAX_CHARS, MAX_PENDING_TASKS } from '../../shared/compact-restore.js';
 
 const PHASE_POSITIONS = {
-  proposal: 1, setup: 1,
+  proposal: 1,
   uiux: 2, design: 2,
-  clarify: 3,
+  plan: 3,
   tasks: 4,
   implement: 5, sync: 5,
 };
@@ -39,7 +39,7 @@ const NEXT_STEP_HINT = {
   design:    (n) => `Approve design gate: morph-spec approve ${n} design`,
   uiux:      (n) => `Approve UI gate: morph-spec approve ${n} uiux`,
   tasks:     (n) => `Approve tasks gate: morph-spec approve ${n} tasks`,
-  implement: (n) => `Continue implementation: morph-spec task next ${n}`,
+  implement: (n) => `Continue implementation: morph-spec task start ${n} <next-task-id>`,
 };
 
 try {
@@ -77,11 +77,16 @@ try {
       const { name: activeName, feature: activeFeature } = active;
       const activePhase = derivePhaseForFeature(activeName);
       let decisionsContent = '';
-      const decisionsPath = join(cwd, `.morph/features/${activeName}/1-design/decisions.md`);
+      const decisionsPath = join(cwd, `.morph/features/${activeName}/2-design/decisions.md`);
       if (existsSync(decisionsPath)) {
         try { decisionsContent = readFileSync(decisionsPath, 'utf-8'); } catch { /* ignore */ }
       }
-      snapshot.richContext = buildRichContext(activeFeature, activePhase, decisionsContent);
+      let specContent = '';
+      const specPath2 = join(cwd, `.morph/features/${activeName}/2-design/spec.md`);
+      if (existsSync(specPath2)) {
+        try { specContent = readFileSync(specPath2, 'utf-8'); } catch { /* ignore */ }
+      }
+      snapshot.richContext = buildRichContext(activeFeature, activePhase, decisionsContent, specContent);
     } catch { /* fail-open: richContext is optional */ }
   }
   // ─────────────────────────────────────────────────────────────────────────
@@ -132,7 +137,7 @@ try {
     lines.push('Next pending tasks:');
     for (const t of pending) lines.push(`  [${t.id}] ${t.title}`);
     if (taskList.filter(t => t.status === 'pending').length > MAX_PENDING_TASKS) {
-      lines.push(`  ... (use morph-spec task next ${name} for full list)`);
+      lines.push(`  ... (see tasks.md for full list)`);
     }
   }
 
@@ -164,7 +169,7 @@ try {
   }
 
   // Key decisions (truncated to stay within context budget)
-  const decisionsPath = join(cwd, `.morph/features/${name}/1-design/decisions.md`);
+  const decisionsPath = join(cwd, `.morph/features/${name}/2-design/decisions.md`);
   if (existsSync(decisionsPath)) {
     try {
       const raw = readFileSync(decisionsPath, 'utf-8');

package/framework/hooks/claude-code/pre-tool-use/enforce-phase-writes.js

@@ -7,8 +7,8 @@
  *
  * Ensures writes to .morph/features/{feature}/ go to the current phase's subfolder:
  *   proposal → only 0-proposal/
- *   design, clarify → only 1-design/
- *   uiux → only 2-ui/
+ *   uiux → only 1-ui/
+ *   design, clarify → only 2-design/
  *   tasks → only 4-tasks/
  *   implement → 5-implement/ + any source code (unrestricted)
  *

package/framework/hooks/claude-code/pre-tool-use/protect-spec-files.js

@@ -6,9 +6,9 @@
  * Event: PreToolUse | Matcher: Write|Edit
  *
  * Blocks Write/Edit to spec artifacts after their approval gate has passed:
- *   - 1-design/spec.md, contracts.cs, etc. → blocked if 'design' gate approved
+ *   - 2-design/spec.md, contracts.cs, etc. → blocked if 'design' gate approved
  *   - 4-tasks/tasks.md → blocked if 'tasks' gate approved
- *   - 2-ui/design-system.md, etc. → blocked if 'uiux' gate approved
+ *   - 1-ui/design-system.md, etc. → blocked if 'uiux' gate approved
  *
  * Fail-open: exits 0 on any error.
  */

package/framework/hooks/claude-code/pre-tool-use/task-tracking-guard.js

@@ -36,23 +36,18 @@ try {
   const phase = feature.phase || derivePhaseForFeature(name);
   if (phase !== 'implement') pass();
 
-  // Check if any task is in_progress
-  // Method 1: tasks.inProgress counter (v3 state format)
+  // Check if any task is in_progress (read directly from taskList)
+  if (feature.taskList?.some(t => t.status === 'in_progress')) pass();
+  // Fallback: legacy counter check
   if (feature.tasks?.inProgress > 0) pass();
 
-  // Method 2: taskList array (v2 state format)
-  if (feature.taskList) {
-    const hasActive = feature.taskList.some(t => t.status === 'in_progress');
-    if (hasActive) pass();
-  }
-
   // No task in_progress — inject advisory warning
   approve(
     `[morph-spec] WARNING: No active task tracking detected during implement phase.\n` +
     `Before writing code, start a task:\n` +
-    `  morph-spec task next ${name}        # see what's next\n` +
     `  morph-spec task start ${name} <id>   # mark it in progress\n` +
-    `Task tracking ensures validators run, checkpoints fire, and progress is recorded.`
+    `Task tracking ensures validators run, checkpoints fire, and progress is recorded.\n` +
+    `If a task is more complex than expected, use: morph-spec task expand ${name} <id> --into "T00Xa: Sub" "T00Xb: Sub"`
   );
 } catch {
   // Fail-open

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

@@ -11,17 +11,17 @@
  * Fail-open: exits 0 on any error.
  */
 
-import { loadState, getActiveFeature, getPendingGates, getMissingOutputs, derivePhaseForFeature } from '../../shared/state-reader.js';
+import { loadState, getActiveFeature, getPendingGates, getMissingOutputs, derivePhaseForFeature, getTaskStats } from '../../shared/state-reader.js';
 import { stateExists } from '../../shared/state-reader.js';
 import { injectContext, pass } from '../../shared/hook-response.js';
 import { resetActivity, logHookActivity } from '../../shared/activity-logger.js';
-import { readFileSync, existsSync, writeFileSync, renameSync, unlinkSync } from 'fs';
+import { readFileSync, existsSync, writeFileSync, renameSync, unlinkSync, statSync } from 'fs';
 import { join } from 'path';
 import { resetStaleTasks } from '../../shared/stale-task-reset.js';
 import { execSync as _execSync } from 'child_process';
 import { parseWorktreeResult, buildWorktreeContextLine, buildWorktreeResumeContext } from '../../shared/worktree-helpers.js';
 
-const DEFAULT_SPEC_MAX_CHARS = 3000;
+const DEFAULT_SPEC_MAX_CHARS = 6000;
 
 function getSpecMaxChars() {
   try {
@@ -90,6 +90,29 @@ try {
   // ────────────────────────────────────────────────────────────────────────────
 
   const lines = ['MORPH-SPEC Status:'];
+
+  // ── Context freshness check ─────────────────────────────────────────────
+  // If .morph/context/README.md is missing or older than 24h, suggest refresh.
+  try {
+    const contextReadmePath = join(process.cwd(), '.morph/context/README.md');
+    let contextStale = false;
+    if (!existsSync(contextReadmePath)) {
+      contextStale = true;
+    } else {
+      const stat = statSync(contextReadmePath);
+      const ageMs = Date.now() - stat.mtimeMs;
+      const TWENTY_FOUR_HOURS = 24 * 60 * 60 * 1000;
+      contextStale = ageMs > TWENTY_FOUR_HOURS;
+    }
+    if (contextStale) {
+      lines.push('');
+      lines.push('⚠ Architecture context is stale or missing. Run: morph-spec context refresh');
+    }
+  } catch {
+    // Fail-open — context freshness check must never block the session
+  }
+  // ────────────────────────────────────────────────────────────────────────
+
   if (staleResetLog.length > 0) {
     lines.push(`⚠️  ${staleResetLog.length} task(s) auto-reset in_progress → pending (orphaned from previous session): ${staleResetLog.join(', ')}`);
   }
@@ -100,9 +123,10 @@ try {
     lines.push(`- Active feature: ${name} (phase: ${phase}, workflow: ${feature.workflow || 'auto'})`);
     lines.push(`- Status: ${feature.status}`);
 
-    // Task progress
-    if (feature.tasks) {
-      lines.push(`- Tasks: ${feature.tasks.completed || 0}/${feature.tasks.total || 0} completed`);
+    // Task progress (read directly from taskList)
+    const stats = getTaskStats(feature);
+    if (stats.total > 0) {
+      lines.push(`- Tasks: ${stats.completed}/${stats.total} completed`);
     }
 
     // Pending approvals
@@ -124,16 +148,8 @@ try {
       lines.push(`- Last checkpoint: #${lastCp.checkpointNum} (${lastCp.passed ? 'passed' : 'failed'})`);
     }
 
-    // Task tracking guidance for work phases
-    if (['proposal', 'setup', 'uiux', 'design', 'clarify', 'plan', 'tasks', 'implement'].includes(phase)) {
-      lines.push('');
-      lines.push('⚠️  MANDATORY: Create session tasks (TaskCreate) BEFORE starting phase work.');
-      lines.push('   Analyze the phase workflow and create tasks reflecting your planned actions.');
-      lines.push('   Mark each in_progress → completed as you go. See phase skill for guidance.');
-    }
-
     // Trust level visibility — warn when low trust may block approval gates
-    const APPROVAL_GATE_PHASES = new Set(['proposal', 'setup', 'design', 'tasks']);
+    const APPROVAL_GATE_PHASES = new Set(['proposal', 'design', 'tasks']);
     if (APPROVAL_GATE_PHASES.has(phase)) {
       const config = getProjectConfig();
       const trustLevel = config?.trust?.level || config?.trustLevel || 'low';
@@ -150,15 +166,15 @@ try {
     }
 
     // Active feature spec (truncated for context budget)
-    const specPath = join(process.cwd(), `.morph/features/${name}/1-design/spec.md`);
+    const specPath = join(process.cwd(), `.morph/features/${name}/2-design/spec.md`);
     if (existsSync(specPath)) {
       try {
         const specContent = readFileSync(specPath, 'utf-8');
         const truncated = specContent.length > SPEC_MAX_CHARS
-          ? specContent.slice(0, SPEC_MAX_CHARS) + `\n\n[... spec truncated — full file at .morph/features/${name}/1-design/spec.md]`
+          ? specContent.slice(0, SPEC_MAX_CHARS) + `\n\n[... spec truncated — full file at .morph/features/${name}/2-design/spec.md]`
           : specContent;
         lines.push('');
-        lines.push(`--- Active feature spec (${name}/1-design/spec.md) ---`);
+        lines.push(`--- Active feature spec (${name}/2-design/spec.md) ---`);
         lines.push(truncated);
         lines.push('--- End spec ---');
       } catch {
@@ -249,20 +265,37 @@ try {
   }
   // ────────────────────────────────────────────────────────────────────────────
 
-  // Remind about key commands
-  lines.push('');
-  lines.push('Key commands: morph-spec status <feature> | morph-spec phase advance <feature> | morph-spec approve <feature> <gate>');
+  // ── CLI availability detection ─────────────────────────────────────────────
+  // Check which development CLIs are available for the current phase.
+  // Uses execSync with short timeout — fail-open on any error.
+  try {
+    const currentPhaseForCli = active ? derivePhaseForFeature(active.name) : '';
+    if (currentPhaseForCli) {
+      const cliChecks = [
+        { name: 'docker', cmd: 'docker --version', phases: ['design', 'implement'] },
+        { name: 'supabase', cmd: 'npx supabase --version', phases: ['design', 'implement'] },
+        { name: 'psql', cmd: 'psql --version', phases: ['design', 'implement'] },
+        { name: 'az', cmd: 'az version --output none', phases: ['implement'] },
+        { name: 'gh', cmd: 'gh --version', phases: ['design', 'tasks', 'implement'] },
+      ];
 
-  // System Map — compact summary for sessions without a live monitor terminal
-  if (active) {
-    const { name } = active;
-    const sysPhase = derivePhaseForFeature(name);
-    lines.push('');
-    lines.push('── MORPH SYSTEM MAP ─────────────────────────────────────────────');
-    lines.push(`🪝 Hooks: 10 registrados  |  📏 Rules: em .claude/rules/  |  🎯 Skills: em .claude/skills/`);
-    lines.push(`   Use \`morph-spec doctor\` para health check  |  \`morph-spec status ${name}\` para dashboard`);
-    lines.push('─────────────────────────────────────────────────────────────────');
+      const relevant = cliChecks.filter(c => c.phases.includes(currentPhaseForCli));
+      if (relevant.length > 0) {
+        const cliStatus = relevant.map(c => {
+          try {
+            _execSync(c.cmd, { stdio: 'pipe', timeout: 5000 });
+            return `${c.name} ✓`;
+          } catch {
+            return `${c.name} ✗`;
+          }
+        });
+        lines.push(`CLIs: ${cliStatus.join(', ')}`);
+      }
+    }
+  } catch {
+    // Fail-open — CLI detection must never block the session
   }
+  // ────────────────────────────────────────────────────────────────────────────
 
   injectContext(lines.join('\n'));
 } catch {

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):');