@soleri/forge 9.4.0 → 9.5.0

package/src/templates/shared-rules.ts

@@ -426,6 +426,24 @@ const ENGINE_RULES_LINES: string[] = [
   '- Duplicate feedback for the same entry in the same task',
   '',
 
+  // ─── Model Routing Guidance ─────────────────────────────
+  '## Model Routing Guidance',
+  '<!-- soleri:model-routing -->',
+  '',
+  'Different workflow stages benefit from different model strengths. Use this as a default when multiple models are available.',
+  '',
+  '| Stage | Recommended Model | Why |',
+  '|-------|------------------|-----|',
+  '| Research / Exploration | Opus | Cross-file reasoning, broad context synthesis |',
+  '| Planning / Architecture | Opus | Complex tradeoff analysis, alternative evaluation |',
+  '| Implementation | Sonnet | Speed, cost-efficiency for focused coding |',
+  '| Code Review / Verification | Opus | Deep analysis, false-positive filtering |',
+  '| Validation Gates | Haiku | Fast, cheap pass/fail checks |',
+  '| Knowledge Capture | Sonnet | Structured extraction, good enough quality |',
+  '',
+  'This is guidance, not enforcement. Use the best model available. When only one model is available, use it for all stages.',
+  '',
+
   // ─── Cross-Project Memory ────────────────────────────────
   '## Cross-Project Memory',
   '<!-- soleri:cross-project -->',
@@ -536,6 +554,21 @@ const ENGINE_RULES_LINES: string[] = [
   'A PreCompact hook calls `op:session_capture` before context compaction.',
   'Manual capture: `op:session_capture params:{ summary: "..." }`',
   '',
+  '### Handoff Protocol',
+  '',
+  'Before crossing a context window boundary (`/clear`, context compaction, or switching tasks), generate a handoff document:',
+  '',
+  '1. **Before transition**: `op:handoff_generate` — produces a structured markdown document with active plan state, recent decisions, and pending tasks.',
+  '2. **After restart**: Reference the handoff document to restore context. It contains plan IDs, task status, decisions, and next actions.',
+  '',
+  'Handoff documents are **ephemeral** — they are returned as markdown, not persisted to vault or memory. They are a snapshot for context transfer only.',
+  '',
+  '| Trigger | Action |',
+  '|---------|--------|',
+  '| `/clear` or manual reset | `op:handoff_generate` before clearing |',
+  '| Context compaction warning | `op:handoff_generate` (alongside `op:session_capture`) |',
+  '| Switching to a different task mid-plan | `op:handoff_generate` to bookmark state |',
+  '',
 
   // ─── Soleri CLI ─────────────────────────────────────────
   '## Soleri CLI',