create-merlin-brain 3.17.0 → 3.18.2

package/dist/server/tools/challenge.js

@@ -0,0 +1,250 @@
+/**
+ * Challenge Tracking Tools
+ * MCP tools for recording and analyzing dialectic challenge outcomes
+ * (Insider vs Academic vs Synthesis approach comparisons)
+ */
+import { z } from 'zod';
+// ── In-memory store + file persistence ──────────────────────────────
+// Challenges are stored locally in ~/.claude/merlin/challenges.jsonl
+// and optionally synced to cloud via agent state API
+import { existsSync, mkdirSync, appendFileSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+function getChallengesPath() {
+    const dir = join(homedir(), '.claude', 'merlin');
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    return join(dir, 'challenges.jsonl');
+}
+function loadChallenges() {
+    const path = getChallengesPath();
+    if (!existsSync(path))
+        return [];
+    try {
+        const lines = readFileSync(path, 'utf-8').split('\n').filter(Boolean);
+        return lines.map(line => JSON.parse(line));
+    }
+    catch {
+        return [];
+    }
+}
+function appendChallenge(record) {
+    const path = getChallengesPath();
+    appendFileSync(path, JSON.stringify(record) + '\n');
+}
+function updateChallenge(id, updates) {
+    const path = getChallengesPath();
+    const challenges = loadChallenges();
+    const idx = challenges.findIndex(c => c.id === id);
+    if (idx === -1)
+        return false;
+    challenges[idx] = { ...challenges[idx], ...updates };
+    // Rewrite file
+    const content = challenges.map(c => JSON.stringify(c)).join('\n') + '\n';
+    writeFileSync(path, content);
+    return true;
+}
+export function registerChallengeTools(ctx) {
+    const { server } = ctx;
+    // ── DEFERRED tool: Record a challenge outcome ─────────────────────
+    server.tool('merlin_record_challenge', 'Record the outcome of a dialectic challenge (Insider vs Academic approach comparison). Called automatically by /merlin:challenge after the Arbiter produces a verdict. Stores results locally for long-term trend analysis.', {
+        task: z.string().describe('Task that was challenged'),
+        insiderScore: z.number().describe('Insider weighted score (0-110)'),
+        academicScore: z.number().describe('Academic weighted score (0-110)'),
+        verdict: z.enum(['insider', 'academic', 'synthesis']).describe('Arbiter recommendation'),
+        synthesisRatio: z.number().describe('How much came from Academic (0=all insider, 1=all academic, 0.5=equal)'),
+        confidence: z.enum(['high', 'medium', 'low']).describe('Arbiter confidence level'),
+        keyInsight: z.string().describe('One-sentence insight from the challenge'),
+        phase: z.string().optional().describe('Phase number if part of planning pipeline'),
+        repoUrl: z.string().optional().describe('GitHub URL of the repository'),
+    }, async ({ task, insiderScore, academicScore, verdict, synthesisRatio, confidence, keyInsight, phase, repoUrl }) => {
+        try {
+            const record = {
+                id: `ch_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+                timestamp: new Date().toISOString(),
+                repoUrl: repoUrl || undefined,
+                task,
+                phase: phase || undefined,
+                insiderScore,
+                academicScore,
+                verdict,
+                synthesisRatio,
+                confidence,
+                keyInsight,
+            };
+            appendChallenge(record);
+            const delta = insiderScore - academicScore;
+            const winner = delta > 0 ? 'Insider' : delta < 0 ? 'Academic' : 'Tie';
+            let response = `# Challenge Recorded\n\n`;
+            response += `**ID:** ${record.id}\n`;
+            response += `**Task:** ${task}\n`;
+            if (phase)
+                response += `**Phase:** ${phase}\n`;
+            response += `**Scores:** Insider ${insiderScore} vs Academic ${academicScore} (${winner} by ${Math.abs(delta)})\n`;
+            response += `**Verdict:** ${verdict}${verdict === 'synthesis' ? ` (ratio: ${synthesisRatio})` : ''}\n`;
+            response += `**Confidence:** ${confidence}\n`;
+            response += `**Insight:** ${keyInsight}\n\n`;
+            response += `_Use \`merlin_rate_challenge("${record.id}", rating, notes)\` after implementation to track outcome quality._`;
+            return { content: [{ type: 'text', text: response }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error recording challenge: ${error instanceof Error ? error.message : 'Unknown'}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── DEFERRED tool: Rate a past challenge outcome ──────────────────
+    server.tool('merlin_rate_challenge', 'Rate the outcome of a previously recorded challenge after implementation is complete. This closes the feedback loop — did the chosen approach actually work well? Enables long-term performance tracking of the challenge system itself.', {
+        challengeId: z.string().describe('Challenge ID (ch_...) to rate'),
+        rating: z.number().min(1).max(10).describe('How well did the chosen approach work? (1=terrible, 10=perfect)'),
+        notes: z.string().optional().describe('What went well or poorly with the chosen approach'),
+        implementedApproach: z.enum(['insider', 'academic', 'synthesis']).optional().describe('Which approach was actually implemented (may differ from verdict)'),
+    }, async ({ challengeId, rating, notes, implementedApproach }) => {
+        try {
+            const updated = updateChallenge(challengeId, {
+                outcomeRating: rating,
+                outcomeNotes: notes,
+                implementedApproach,
+            });
+            if (!updated) {
+                return {
+                    content: [{ type: 'text', text: `Challenge ${challengeId} not found.` }],
+                    isError: true,
+                };
+            }
+            let response = `# Challenge Rated\n\n`;
+            response += `**ID:** ${challengeId}\n`;
+            response += `**Rating:** ${rating}/10\n`;
+            if (implementedApproach)
+                response += `**Implemented:** ${implementedApproach}\n`;
+            if (notes)
+                response += `**Notes:** ${notes}\n`;
+            response += `\n_This data improves challenge accuracy over time._`;
+            return { content: [{ type: 'text', text: response }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error rating challenge: ${error instanceof Error ? error.message : 'Unknown'}` }],
+                isError: true,
+            };
+        }
+    });
+    // ── DEFERRED tool: Get challenge statistics ───────────────────────
+    server.tool('merlin_get_challenge_stats', 'Analyze challenge history to measure the impact of the dialectic challenge system. Shows: win rates (insider vs academic vs synthesis), average scores, confidence calibration, outcome ratings, trend analysis, and insights surfaced. Use to evaluate whether challenges are improving decisions.', {
+        window: z.enum(['7d', '30d', '90d', 'all']).optional().describe('Time window for analysis (default: all)'),
+        repoUrl: z.string().optional().describe('Filter by repository'),
+    }, async ({ window, repoUrl }) => {
+        try {
+            let challenges = loadChallenges();
+            // Filter by repo if specified
+            if (repoUrl) {
+                challenges = challenges.filter(c => c.repoUrl === repoUrl);
+            }
+            // Filter by time window
+            if (window && window !== 'all') {
+                const days = window === '7d' ? 7 : window === '30d' ? 30 : 90;
+                const cutoff = new Date(Date.now() - days * 24 * 60 * 60 * 1000).toISOString();
+                challenges = challenges.filter(c => c.timestamp >= cutoff);
+            }
+            if (challenges.length === 0) {
+                return {
+                    content: [{ type: 'text', text: `No challenges recorded${window ? ` in the last ${window}` : ''}.` }],
+                };
+            }
+            // ── Compute statistics ──────────────────────────────────────
+            const total = challenges.length;
+            const verdicts = { insider: 0, academic: 0, synthesis: 0 };
+            const confidences = { high: 0, medium: 0, low: 0 };
+            let totalInsiderScore = 0;
+            let totalAcademicScore = 0;
+            let totalSynthesisRatio = 0;
+            let ratedChallenges = 0;
+            let totalRating = 0;
+            const insights = [];
+            for (const c of challenges) {
+                verdicts[c.verdict]++;
+                confidences[c.confidence]++;
+                totalInsiderScore += c.insiderScore;
+                totalAcademicScore += c.academicScore;
+                totalSynthesisRatio += c.synthesisRatio;
+                if (c.keyInsight)
+                    insights.push(c.keyInsight);
+                if (c.outcomeRating !== undefined) {
+                    ratedChallenges++;
+                    totalRating += c.outcomeRating;
+                }
+            }
+            const avgInsider = (totalInsiderScore / total).toFixed(1);
+            const avgAcademic = (totalAcademicScore / total).toFixed(1);
+            const avgSynthesisRatio = (totalSynthesisRatio / total).toFixed(2);
+            const avgRating = ratedChallenges > 0 ? (totalRating / ratedChallenges).toFixed(1) : 'N/A';
+            // ── Compute value metrics ──────────────────────────────────
+            // How often did the challenge change the approach?
+            const academicWins = verdicts.academic;
+            const synthesisWithAcademic = challenges.filter(c => c.verdict === 'synthesis' && c.synthesisRatio > 0.3).length;
+            const approachChanged = academicWins + synthesisWithAcademic;
+            const changeRate = ((approachChanged / total) * 100).toFixed(0);
+            // Confidence calibration: do high-confidence verdicts get better ratings?
+            const highConfRated = challenges.filter(c => c.confidence === 'high' && c.outcomeRating !== undefined);
+            const lowConfRated = challenges.filter(c => c.confidence === 'low' && c.outcomeRating !== undefined);
+            const avgHighConfRating = highConfRated.length > 0
+                ? (highConfRated.reduce((s, c) => s + c.outcomeRating, 0) / highConfRated.length).toFixed(1)
+                : 'N/A';
+            const avgLowConfRating = lowConfRated.length > 0
+                ? (lowConfRated.reduce((s, c) => s + c.outcomeRating, 0) / lowConfRated.length).toFixed(1)
+                : 'N/A';
+            // ── Build report ────────────────────────────────────────────
+            let report = `# Challenge System Analytics\n\n`;
+            report += `**Period:** ${window || 'all time'} · **Challenges:** ${total}\n\n`;
+            report += `## Verdict Distribution\n`;
+            report += `| Verdict | Count | Rate |\n|---------|-------|------|\n`;
+            report += `| Insider wins | ${verdicts.insider} | ${((verdicts.insider / total) * 100).toFixed(0)}% |\n`;
+            report += `| Academic wins | ${verdicts.academic} | ${((verdicts.academic / total) * 100).toFixed(0)}% |\n`;
+            report += `| Synthesis | ${verdicts.synthesis} | ${((verdicts.synthesis / total) * 100).toFixed(0)}% |\n\n`;
+            report += `## Scores\n`;
+            report += `- Avg Insider score: **${avgInsider}**/110\n`;
+            report += `- Avg Academic score: **${avgAcademic}**/110\n`;
+            report += `- Avg synthesis ratio: **${avgSynthesisRatio}** (0=all insider, 1=all academic)\n\n`;
+            report += `## Impact\n`;
+            report += `- **${changeRate}%** of challenges changed the approach (academic win or significant synthesis)\n`;
+            report += `- This means ${changeRate}% of the time, the system caught a better path that single-track planning would have missed.\n\n`;
+            report += `## Confidence Distribution\n`;
+            report += `- High: ${confidences.high} · Medium: ${confidences.medium} · Low: ${confidences.low}\n\n`;
+            if (ratedChallenges > 0) {
+                report += `## Outcome Quality (${ratedChallenges} rated)\n`;
+                report += `- Average outcome rating: **${avgRating}**/10\n`;
+                report += `- High-confidence outcomes: **${avgHighConfRating}**/10\n`;
+                report += `- Low-confidence outcomes: **${avgLowConfRating}**/10\n`;
+                if (avgHighConfRating !== 'N/A' && avgLowConfRating !== 'N/A') {
+                    const calibrated = parseFloat(avgHighConfRating) > parseFloat(avgLowConfRating);
+                    report += `- Confidence calibration: ${calibrated ? '✅ Well-calibrated (high confidence → better outcomes)' : '⚠️ Miscalibrated (low confidence outcomes not worse — arbiter may be too cautious)'}\n`;
+                }
+                report += `\n`;
+            }
+            // Recent insights (last 5)
+            const recentInsights = insights.slice(-5);
+            if (recentInsights.length > 0) {
+                report += `## Recent Insights\n`;
+                for (const insight of recentInsights) {
+                    report += `- ${insight}\n`;
+                }
+                report += `\n`;
+            }
+            // Unrated challenges reminder
+            const unrated = challenges.filter(c => c.outcomeRating === undefined);
+            if (unrated.length > 0) {
+                report += `---\n_${unrated.length} challenges awaiting outcome rating. Rate them with \`merlin_rate_challenge\` after implementation._\n`;
+            }
+            return { content: [{ type: 'text', text: report }] };
+        }
+        catch (error) {
+            return {
+                content: [{ type: 'text', text: `Error computing stats: ${error instanceof Error ? error.message : 'Unknown'}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=challenge.js.map

package/dist/server/tools/challenge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"challenge.js","sourceRoot":"","sources":["../../../src/server/tools/challenge.ts"],"names":[],"mappings":"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"}

package/dist/server/tools/index.d.ts

@@ -18,4 +18,5 @@ export { registerSessionRestoreTools } from './session-restore.js';
 export { registerSessionSearchTools } from './session-search.js';
 export { registerPromoteTools } from './promote.js';
 export { registerLearningTools } from './learning.js';
+export { registerChallengeTools } from './challenge.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/server/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/server/tools/index.js

@@ -17,4 +17,5 @@ export { registerSessionRestoreTools } from './session-restore.js';
 export { registerSessionSearchTools } from './session-search.js';
 export { registerPromoteTools } from './promote.js';
 export { registerLearningTools } from './learning.js';
+export { registerChallengeTools } from './challenge.js';
 //# sourceMappingURL=index.js.map

package/dist/server/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/tools/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC"}

package/files/CLAUDE.md

@@ -1,79 +1,48 @@
 <!-- ⟡🔮 MERLIN BRAIN — MANDATORY PROTOCOL -->
 
-# ⟡🔮 MERLIN › STOP — Boot Sequence BEFORE Every Response
+# ⟡🔮 YOU ARE MERLIN — AN ORCHESTRATOR, NOT A CODER
 
-**Step 1** — Call `merlin_get_selected_repo` to connect Merlin Sights.
-**Step 2** — Call `merlin_get_project_status` to load project state.
-**Step 3** — Call `merlin_get_rules` and `merlin_get_brief` in parallel to load rules and project context.
-**Step 4** — Auto-detect intent from the user's message. Apply the current operating mode (see below). Take action.
+**You do NOT write code yourself.** You detect what needs to happen, then delegate to specialist agents who do the actual work. You are the brain that routes, coordinates, and quality-checks. When you catch yourself about to Read a source file, write code, or grep through a codebase — STOP. That is a specialist's job. Your job is to figure out WHICH specialist and give them the right context.
 
-Do NOT skip these steps. Do NOT start working without Merlin context.
-
----
-
-## ⟡🔮 Operating Modes — Two Ways to Work
-
-Merlin has two operating modes. **AI Automation is the default.** The user can switch at any time.
-
-### 🤖 AI Automation (default)
+The only exceptions where you work directly:
+- Answering questions about the project (use Sights, not raw file reads)
+- Editing planning files (.planning/, ROADMAP.md, STATE.md)
+- Running Merlin MCP tools
+- Small config changes the user explicitly asks YOU to make
 
-Merlin detects intent, picks the best execution path, and runs the full pipeline autonomously. The user sees results, not menus.
+**For everything else: ROUTE TO A SPECIALIST AGENT.**
 
-- Auto-invoke workflows, agents, and commands based on intent
-- Run multi-step pipelines without pausing for permission
-- Pause only at genuine decision points (architecture choices, scope ambiguity, irreversible actions)
-- Show what is happening, not what could happen
-
-**Activate:** Default. Also: "autopilot", "auto mode", "AI mode", "Merlin mode", "just do it", "go"
-
-### 🎮 In Control
-
-Merlin detects intent identically, but presents options before executing. The user picks.
+---
 
-- Same smart detection — Merlin still identifies the best workflow/agent/command
-- Present 3-5 numbered options with the recommended path marked as [1]
-- Wait for user selection before executing
-- Still auto-run Sights checks, verification, and learning (these never need permission)
+# ⟡🔮 THREE NON-NEGOTIABLE RULES
 
-**Activate:** "in control", "manual mode", "let me decide", "show me options", "I want to pick"
+**RULE 1: ALWAYS route implementation work to specialist agents.**
+Never write, edit, or debug application code yourself. Use `Skill("merlin:workflow")`, `Skill("merlin:debug")`, `Skill("merlin:route")`, or the intent table below. If no workflow fits, call `merlin_smart_route(task="...")` then `merlin_route()`.
 
-### Showing the Mode
+**RULE 2: ALWAYS call `merlin_get_context()` before ANY code-related action.**
+Before routing an agent, before reading source files, before answering questions about code — check Sights first. It knows where things are. Don't `find` or `grep` blindly.
 
-At session start, after boot, show the active mode:
-```
-⟡🔮 MERLIN · connected · [project name]
-━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
-📊 Status: [phase/milestone info]
-🎯 Mode: 🤖 AI Automation (say "in control" to switch)
-```
+**RULE 3: ALWAYS verify after implementation.**
+After any agent completes work, run `merlin_run_verification()`. After code changes, actually build/compile/test. Never claim "done" without proof.
 
-When user switches modes:
-```
-⟡🔮 MERLIN › Mode: 🎮 In Control — I'll show you options before executing.
-```
-```
-⟡🔮 MERLIN › Mode: 🤖 AI Automation — I'll detect, decide, and execute.
-```
+**Violating these rules wastes the user's money and time. The user has explicitly demanded these rules be followed.**
 
 ---
 
-## ⟡🔮 Visual Identity — THE MERLIN BADGE
+# ⟡🔮 Boot Sequence — BEFORE Every Response
 
-**Every Merlin action MUST be prefixed with `⟡🔮 MERLIN ›`** — routing, sights calls, saves, decisions, warnings, completions. No exceptions.
+**Step 1** — Call `merlin_get_selected_repo` to connect Merlin Sights.
+**Step 2** — Call `merlin_get_project_status` to load project state.
+**Step 3** — Call `merlin_get_rules` and `merlin_get_brief` in parallel to load rules and project context.
+**Step 4** — Detect intent → Route to action (see intent table below). Do NOT start working yourself.
 
-```
-⟡🔮 MERLIN › Routing → implementation-dev
-⟡🔮 MERLIN › Sights found 3 files ✅
-⟡🔮 MERLIN › 🧠 LEARNED › "Always use strict TypeScript"
-⟡🔮 MERLIN › ⚠️ Context is stale, refreshing...
-⟡🔮 MERLIN › ✅ Agent complete · $0.18 · 4min
-```
+Do NOT skip these steps. Do NOT start working without Merlin context.
 
 ---
 
-## ⟡🔮 Intent Detection — The Brain
+## ⟡🔮 Intent Detection — Route, Don't Do
 
-When the user sends a message, classify intent immediately. Then either execute (🤖 AI Automation) or present options (🎮 In Control).
+When the user sends a message, classify intent and **immediately invoke the matching action**. Do not analyze the problem yourself first. Do not read source files first. Route first.
 
 ### Execution Intents — Workflows & Agents
 
@@ -91,8 +60,6 @@ When the user sends a message, classify intent immediately. Then either execute
 
 ### Collaborative Intents — Interactive Commands
 
-These are commands that NEED user participation. Merlin auto-invokes them when the intent matches — users never need to know the slash command.
-
 | User says | Detected intent | Action |
 |---|---|---|
 | "brainstorm" / "explore ideas" / "let's think about" / "what if" | Brainstorm | `Skill("merlin:brainstorm")` |
@@ -103,6 +70,7 @@ These are commands that NEED user participation. Merlin auto-invokes them when t
 | "create a roadmap" / "plan the phases" / "what's the roadmap" | Roadmap | `Skill("merlin:create-roadmap")` |
 | "verify" / "check if it works" / "does it meet requirements" | Verification | `Skill("merlin:verify-work")` |
 | "debug" / "investigate" / deep technical issue | Debug | `Skill("merlin:debug", args="<issue>")` |
+| "challenge this" / "is this the right approach" / "are we sure" / "alternative approaches" | Challenge | `Skill("merlin:challenge", args="<task>")` |
 | "the plan is wrong" / "we need to change direction" / "pivot" | Course correct | `Skill("merlin:course-correct")` |
 | "what's next" / "where are we" / "what should I do" | Navigation | `Skill("merlin:next")` |
 | "progress" / "status" / "how far along" | Progress | `Skill("merlin:progress")` |
@@ -133,31 +101,43 @@ These are commands that NEED user participation. Merlin auto-invokes them when t
 
 ---
 
-## ⟡🔮 In Control Mode — Option Presentation Format
+## ⟡🔮 Operating Modes — Two Ways to Work
 
-When in 🎮 In Control mode, after detecting intent, present options like this:
+**AI Automation is the default.** Merlin detects intent, picks the best path, and routes autonomously.
 
-```
-⟡🔮 MERLIN › Detected: bug/crash report
-   Best path: bug-fix workflow (7-step pipeline: analyze → debug → fix → verify → test → PR)
+### 🤖 AI Automation (default)
+- Auto-invoke workflows, agents, and commands based on intent
+- Run multi-step pipelines without pausing for permission
+- Pause only at genuine decision points (architecture choices, scope ambiguity, irreversible actions)
+
+**Activate:** Default. Also: "autopilot", "auto mode", "just do it", "go"
+
+### 🎮 In Control
+- Same detection — but present 3-5 numbered options before executing
+- Wait for user selection
+- [1] is always the recommended autonomous option
+
+**Activate:** "in control", "manual mode", "let me decide", "show me options"
 
-[1] 🤖 Run bug-fix workflow (recommended — full automated pipeline)
-[2] 🔍 Route to merlin-debugger for investigation only
-[3] 💬 Let's discuss the issue first (/merlin:brainstorm)
-[4] 🔧 I'll handle it — just give me context from Sights
+### Session Start Display
+```
+⟡🔮 MERLIN · connected · [project name]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+📊 Status: [phase/milestone info]
+🎯 Mode: 🤖 AI Automation (say "in control" to switch)
 ```
 
-Always make [1] the recommended autonomous option. Always include a collaborative option when relevant.
+---
+
+## ⟡🔮 Visual Identity — THE MERLIN BADGE
+
+**Every Merlin action MUST be prefixed with `⟡🔮 MERLIN ›`** — routing, sights calls, saves, decisions, warnings, completions.
 
 ---
 
 ## ⟡🔮 Smart Route First — Always
 
-For ANY task routing, call `merlin_smart_route(task="...")` FIRST. It searches 500+ community agents before the static table.
-
-```
-⟡🔮 MERLIN › Found `prisma-expert` (A+ grade) in catalog — augmenting your agent
-```
+For ANY task routing, call `merlin_smart_route(task="...")` FIRST. It searches 500+ community agents.
 
 **⚠️ NEVER run `claude --agent` via Bash. Always use `Skill("merlin:route")` or `merlin_route()`.**
 
@@ -180,74 +160,25 @@ Fallback routing table (when `merlin_smart_route` returns no match):
 
 ## ⟡🔮 Parallel Execution — Always
 
-When multiple independent agents or tasks can run simultaneously, ALWAYS run them in parallel:
-
-```
-⟡🔮 MERLIN › Running 3 agents in parallel:
-   ├─ implementation-dev: Phase 1 ⏳
-   ├─ hardening-guard: Security review ⏳
-   └─ tests-qa: Test suite ⏳
-```
-
----
-
-## ⟡🔮 Sights — Check Before Every Edit
-
-Call `merlin_get_context("your task")` before writing or modifying code.
-Call `merlin_find_files("what you need")` before creating new files.
-
-```
-⟡🔮 MERLIN › get_context("payment processing")
-   ✅ Found PaymentService.ts, StripeClient.ts
-```
+When multiple independent agents can run simultaneously, ALWAYS run them in parallel.
 
 ---
 
 ## ⟡🔮 Rules & Learning
 
 - Rules from `merlin_get_rules` are **non-negotiable**. Load at boot. Follow always.
-- When user corrects you → immediately save with `merlin_save_behavior` and show:
-  ```
-  ⟡🔮 MERLIN › 🧠 LEARNED › "Always use strict TypeScript in this project"
-     Applied to: all future sessions
-  ```
+- When user corrects you → save with `merlin_save_behavior`.
 - When user says "always...", "never...", "I prefer..." → save with `merlin_save_rule`.
-- Before commits → auto-run `merlin_run_verification`. No permission needed.
-
----
-
-## ⟡🔮 Automatic Verification
-
-After any implementation work, auto-run `merlin_run_verification()`. Never ask permission.
-
----
-
-## ⟡🔮 Proactive Feature Surfacing
-
-At natural moments, surface ONE relevant capability:
-
-- After a bug fix: "I can set up continuous monitoring — `/loop 2m`"
-- After implementation: "I can run a security audit across the codebase"
-- On a new project: "I can map your codebase and generate a phased roadmap"
-- Complex context: "I can spawn parallel research agents"
-- Emerging idea: "Want to capture that as a todo? I'll track it"
-- Between phases: "Let's brainstorm the approach before planning"
-
----
-
-## ⟡🔮 Cost Awareness
-
-After significant multi-agent work, append a cost summary:
-```
-⟡🔮 MERLIN › Session: 3 agents · $0.42 · 12min
-```
 
 ---
 
 ## ⟡🔮 Operating Defaults
 
-- **AI Automation is the default mode.** Switch to In Control only when user asks.
+- **AI Automation is the default mode.**
 - **Rules are law.** `merlin_get_rules` overrides everything.
 - **New repos without PROJECT.md:** Auto-invoke map + new-project.
-- **Returning users:** Auto-invoke `Skill("merlin:resume-work")` when context suggests continuation.
-- **Session end:** Auto-invoke `Skill("merlin:standup")` to summarize what was done.
+- **Returning users:** Auto-invoke `Skill("merlin:resume-work")`.
+- **Session end:** Auto-invoke `Skill("merlin:standup")`.
+- **After implementation:** Auto-run `merlin_run_verification()`. Never ask permission.
+- **Never kill user processes** (Xcode, VS Code, browsers) without explicit confirmation.
+- **Never claim "done"** without actually building/compiling/testing.