create-merlin-brain 3.5.10 → 3.5.12

package/files/agents/code-organization-supervisor.md

@@ -4,6 +4,9 @@ description: Use this agent when you need to ensure code quality standards are m
 model: haiku
 color: blue
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 You are an elite Code Organization Supervisor with deep expertise in software architecture, clean code principles, and maintainable project structures. Your primary mission is to ensure codebases remain organized, readable, and maintainable by enforcing strict file size limits and logical folder hierarchies.

package/files/agents/context-guardian.md

@@ -5,6 +5,8 @@ tools: Glob, Grep, Read, WebFetch, TodoWrite, WebSearch
 model: haiku
 color: green
 version: "1.0.0"
+permissionMode: bypassPermissions
+maxTurns: 30
 ---
 
 You are the Context Guardian, an expert project analyst and architectural advisor whose mission is to ensure developers have complete contextual awareness before writing any code. Your role is critical in preventing code duplication, maintaining architectural consistency, and maximizing reuse of existing functionality.

package/files/agents/docs-keeper.md

@@ -4,6 +4,9 @@ description: Keeps claude.md documentation files up to date for each service or
 model: sonnet
 color: green
 version: "1.0.0"
+tools: Read, Write, Edit, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 50
 ---
 
 You are the Documentation Keeper for a vibe coded system.

package/files/agents/dry-refactor.md

@@ -4,6 +4,9 @@ description: Keeps the codebase DRY, small, and maintainable by finding duplicat
 model: sonnet
 color: purple
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 You are an elite Code Organization and DRY Supervisor with deep expertise in software architecture, clean code principles, and maintainable project structures.

package/files/agents/elite-code-refactorer.md

@@ -4,6 +4,9 @@ description: "Use this agent when you need to transform existing code into produ
 model: opus
 color: green
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 You are the Elite Code Refactorer—the most senior, meticulous, and uncompromising software architect on any engineering team. You possess deep expertise across the entire stack: backend systems, frontend applications, databases, APIs, and infrastructure. Your singular mission is to transform functional code into flawless, production-grade software that exemplifies engineering excellence.

package/files/agents/hardening-guard.md

@@ -4,6 +4,9 @@ description: Reviews features for security, error handling, validation, and reli
 model: sonnet
 color: green
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 You are the Hardening Guard.

package/files/agents/implementation-dev.md

@@ -4,6 +4,9 @@ description: Implements features and changes across the codebase, following the
 model: sonnet
 color: blue
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 You are the primary implementation developer working with a strong product minded vibe coder.

package/files/agents/merlin-api-designer.md

@@ -4,6 +4,9 @@ description: Designs clean, consistent REST and GraphQL APIs with proper documen
 tools: Read, Write, Grep, Glob
 color: blue
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 <role>

package/files/agents/merlin-codebase-mapper.md

@@ -4,6 +4,9 @@ description: Explores codebase and writes structured analysis documents. Spawned
 tools: Read, Bash, Grep, Glob, Write
 color: cyan
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 150
 ---
 
 <role>

package/files/agents/merlin-debugger.md

@@ -4,6 +4,9 @@ description: Investigates bugs using scientific method, manages debug sessions,
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
 color: orange
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 150
 ---
 
 <role>

package/files/agents/merlin-executor.md

@@ -4,6 +4,9 @@ description: Executes Merlin plans with atomic commits, deviation handling, chec
 tools: Read, Write, Edit, Bash, Grep, Glob
 color: yellow
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 200
 ---
 
 <role>

package/files/agents/merlin-frontend.md

@@ -4,6 +4,9 @@ description: Frontend specialist for React, Vue, and modern web development with
 tools: Read, Write, Grep, Glob, Bash
 color: cyan
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 <role>

package/files/agents/merlin-integration-checker.md

@@ -4,6 +4,9 @@ description: Verifies cross-phase integration and E2E flows. Checks that phases
 tools: Read, Bash, Grep, Glob
 color: blue
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 <role>

package/files/agents/merlin-migrator.md

@@ -4,6 +4,9 @@ description: Plans and executes safe database schema migrations with rollback st
 tools: Read, Write, Bash, Grep, Glob
 color: yellow
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 <role>

package/files/agents/merlin-milestone-auditor.md

@@ -4,6 +4,9 @@ description: Orchestrates milestone-level verification. Spawns phase verifiers i
 tools: Read, Bash, Grep, Glob, Task
 color: blue
 version: "1.0.0"
+model: opus
+permissionMode: bypassPermissions
+maxTurns: 50
 ---
 
 <role>

package/files/agents/merlin-performance.md

@@ -4,6 +4,9 @@ description: Analyzes code for performance issues and provides optimization reco
 tools: Read, Grep, Glob, Bash
 color: red
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 <role>

package/files/agents/merlin-planner.md

@@ -5,6 +5,9 @@ tools: Read, Write, Bash, Grep, Glob, AskUserQuestion, WebFetch, mcp__context7__
 color: blue
 version: "1.0.0"
 disallowedTools: [Edit, Write, NotebookEdit, Bash]
+model: opus
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 <role>

package/files/agents/merlin-researcher.md

@@ -4,6 +4,9 @@ description: Conducts comprehensive research using systematic methodology, sourc
 tools: Read, Write, Bash, Grep, Glob, WebSearch, WebFetch, mcp__context7__*
 color: cyan
 version: "1.0.0"
+model: opus
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 <role>

package/files/agents/merlin-reviewer.md

@@ -5,6 +5,9 @@ tools: Read, Grep, Glob, Bash
 color: orange
 version: "1.0.0"
 disallowedTools: [Edit, Write, NotebookEdit]
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 50
 ---
 
 <role>

package/files/agents/merlin-security.md

@@ -5,6 +5,9 @@ tools: Read, Grep, Glob, Bash
 color: red
 version: "1.0.0"
 disallowedTools: [Edit, Write, NotebookEdit]
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 <role>

package/files/agents/merlin-verifier.md

@@ -5,6 +5,9 @@ tools: Read, Bash, Grep, Glob
 color: green
 version: "1.0.0"
 disallowedTools: [Edit, Write, NotebookEdit]
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 <role>

package/files/agents/merlin-work-verifier.md

@@ -4,6 +4,9 @@ description: Validates built features through conversational UAT with persistent
 tools: Read, Bash, Grep, Glob, Edit, Write, AskUserQuestion
 color: green
 version: "1.0.0"
+model: sonnet
+permissionMode: bypassPermissions
+maxTurns: 50
 ---
 
 <role>

package/files/agents/merlin.md

@@ -4,6 +4,9 @@ description: The Merlin Brain - Master AI orchestrator. Routes to specialist age
 model: opus
 color: magenta
 version: "1.0.0"
+tools: Read, Glob, Grep, Bash, WebSearch
+permissionMode: bypassPermissions
+maxTurns: 50
 ---
 
 # Merlin — Master Orchestrator
@@ -188,6 +191,7 @@ Activated by: "get shit done", "Merlin mode", "move fast", "just build it", "shi
 
 ## Anti-Patterns (NEVER Do These)
 
+- **Never** run `claude --agent` via Bash — it FAILS inside Claude Code sessions. Use `Skill("merlin:route")` instead
 - **Never** read ref files yourself (plan-format.md, tdd.md) — the sub-agent reads them
 - **Never** do specialist work in the orchestrator context — always route
 - **Never** use Task() — it shares parent context and causes overflow

package/files/agents/ops-railway.md

@@ -4,6 +4,9 @@ description: Manages deployment, environments, and configuration on Railway and
 model: sonnet
 color: red
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 You are the ops and infrastructure guide focusing on Railway and Google Cloud for a small, fast moving team.

package/files/agents/orchestrator-retrofit.md

@@ -4,6 +4,9 @@ description: Orchestrator used to audit and improve existing projects by applyin
 model: opus
 color: purple
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 80
 ---
 
 You are the retrofit orchestrator for existing projects that were already built, usually through vibe coding.

package/files/agents/product-spec.md

@@ -5,6 +5,9 @@ model: opus
 color: white
 version: "1.0.0"
 disallowedTools: [Edit, Write, NotebookEdit, Bash]
+tools: Read, Grep, Glob, WebSearch
+permissionMode: bypassPermissions
+maxTurns: 30
 ---
 
 You are a product specifier for a very strong product thinker and vibe coder.

package/files/agents/remotion.md

@@ -5,6 +5,8 @@ model: sonnet
 tools: Read, Write, Edit, Bash, Grep, Glob, WebSearch
 color: red
 version: "1.0.0"
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 <role>

package/files/agents/system-architect.md

@@ -5,6 +5,9 @@ model: opus
 color: black
 version: "1.0.0"
 disallowedTools: [Edit, Write, NotebookEdit, Bash]
+tools: Read, Grep, Glob, Bash, WebSearch
+permissionMode: bypassPermissions
+maxTurns: 50
 ---
 
 You are a system architect for a vibe coder who tends to create many microservices.

package/files/agents/tests-qa.md

@@ -4,6 +4,9 @@ description: Designs and implements lightweight but meaningful tests and manual
 model: sonnet
 color: yellow
 version: "1.0.0"
+tools: Read, Write, Edit, Bash, Grep, Glob
+permissionMode: bypassPermissions
+maxTurns: 100
 ---
 
 You are a tests and QA designer for a busy founder and vibe coder.

package/files/hooks/pre-compact.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+#
+# Merlin Hook: PreCompact
+# Saves session state before Claude Code compacts the context window.
+# This preserves what was being worked on so it survives compaction.
+# Always exits 0 — never blocks compaction.
+#
+set -euo pipefail
+trap 'echo "{}"; exit 0' ERR
+
+HOOKS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# Source shared libraries
+# shellcheck source=lib/analytics.sh
+. "${HOOKS_DIR}/lib/analytics.sh"
+
+# Log compaction event
+log_event "pre_compact" '{}'
+
+# If merlin CLI is available, save checkpoint in background
+if command -v merlin >/dev/null 2>&1; then
+  merlin save-checkpoint "Pre-compaction checkpoint" >/dev/null 2>&1 &
+fi
+
+# Claude Code command hooks must output valid JSON to stdout
+echo '{}'
+exit 0

package/files/hooks/session-start.sh

@@ -133,7 +133,7 @@ cat <<'CONTEXT_JSON'
 {
   "hookSpecificOutput": {
     "hookEventName": "SessionStart",
-    "additionalContext": "You are a Merlin-powered session. Before working: (1) call merlin_get_selected_repo to connect Sights, (2) call merlin_get_project_status to load state, (3) show numbered options. Check Sights before every edit. Route complex tasks to specialists via /merlin:route. Save checkpoints before stopping."
+    "additionalContext": "⚡ MANDATORY: Before responding to the user, you MUST: (1) call merlin_get_selected_repo to connect Sights, (2) call merlin_get_project_status to load state, (3) show status + numbered options. Do NOT skip these steps. Do NOT start working without Merlin context. Route complex tasks via Skill(\"merlin:route\") — NEVER run claude --agent via Bash. Check merlin_get_context before every edit."
   }
 }
 CONTEXT_JSON

package/files/merlin/VERSION

@@ -1 +1 @@
-3.5.10
+3.5.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-merlin-brain",
-  "version": "3.5.10",
+  "version": "3.5.12",
   "description": "Merlin - The Ultimate AI Brain for Claude Code. One install: workflows, agents, loop, and Sights MCP server.",
   "type": "module",
   "main": "./dist/server/index.js",