create-merlin-brain 5.0.2 → 5.3.2

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

@@ -9,6 +9,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 80
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

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

@@ -8,6 +8,14 @@ model: sonnet
 effort: high
 permissionMode: bypassPermissions
 maxTurns: 150
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-debugger.md

@@ -9,6 +9,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 150
 memory: project
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

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

@@ -10,6 +10,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 60
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-edge-case-hunter.md

@@ -10,6 +10,14 @@ effort: high
 background: true
 permissionMode: bypassPermissions
 maxTurns: 80
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: edge-case methodology (v6.0.4+)"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: port of BMAD edge-case methodology
 ---
 
 <role>

package/files/agents/merlin-executor.md

@@ -9,6 +9,14 @@ effort: medium
 isolation: worktree
 permissionMode: bypassPermissions
 maxTurns: 200
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: agents/executor.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: GSD fresh-context-per-plan execution model
 ---
 
 <role>

package/files/agents/merlin-frontend.md

@@ -15,6 +15,14 @@ hooks:
       hooks:
         - type: command
           command: "bash ~/.claude/hooks/check-file-size.sh"
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-input-validator.md

@@ -10,6 +10,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 60
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

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

@@ -8,6 +8,14 @@ model: sonnet
 effort: low
 permissionMode: bypassPermissions
 maxTurns: 80
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-migrator.md

@@ -9,6 +9,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 100
 memory: project
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

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

@@ -8,6 +8,14 @@ model: opus
 effort: low
 permissionMode: bypassPermissions
 maxTurns: 50
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-party-review.md

@@ -10,6 +10,14 @@ effort: high
 background: true
 permissionMode: bypassPermissions
 maxTurns: 60
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: Party Mode multi-perspective review"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: port of BMAD Party Mode
 ---
 
 <role>

package/files/agents/merlin-performance.md

@@ -9,6 +9,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 80
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-planner.md

@@ -4,11 +4,19 @@ description: Creates executable phase plans (PLAN.md files) with discovery, depe
 tools: Read, Write, Bash, Grep, Glob, AskUserQuestion, WebFetch, mcp__context7__*, mcp__merlin__merlin_get_context, mcp__merlin__merlin_search, mcp__merlin__merlin_find_files
 color: blue
 version: "1.0.0"
-disallowedTools: [Edit, Write, NotebookEdit, Bash]
+disallowedTools: [Edit, NotebookEdit]
 model: opus
 effort: high
 permissionMode: bypassPermissions
 maxTurns: 100
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-researcher.md

@@ -8,6 +8,14 @@ model: opus
 effort: high
 permissionMode: bypassPermissions
 maxTurns: 100
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-reviewer.md

@@ -11,6 +11,14 @@ background: true
 permissionMode: bypassPermissions
 maxTurns: 50
 memory: project
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: adversarial code reviewer"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: adapted adversarial reviewer framing + critical_actions
 ---
 
 <role>

package/files/agents/merlin-sast-reviewer.md

@@ -11,6 +11,14 @@ isolation: worktree
 permissionMode: bypassPermissions
 maxTurns: 80
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-secret-scanner.md

@@ -11,6 +11,14 @@ isolation: worktree
 permissionMode: bypassPermissions
 maxTurns: 60
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-security.md

@@ -10,6 +10,14 @@ effort: high
 permissionMode: bypassPermissions
 maxTurns: 80
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin-verifier.md

@@ -9,6 +9,14 @@ model: sonnet
 effort: low
 permissionMode: bypassPermissions
 maxTurns: 100
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

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

@@ -8,6 +8,14 @@ model: sonnet
 effort: low
 permissionMode: bypassPermissions
 maxTurns: 50
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/merlin.md

@@ -7,6 +7,14 @@ version: "1.0.0"
 effort: high
 permissionMode: bypassPermissions
 maxTurns: 50
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 # 🔮 Merlin — Autonomous Development Orchestrator

package/files/agents/ops-railway.md

@@ -9,6 +9,14 @@ effort: medium
 permissionMode: bypassPermissions
 maxTurns: 80
 memory: project
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 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

@@ -8,6 +8,14 @@ tools: Read, Write, Edit, Bash, Grep, Glob
 effort: high
 permissionMode: bypassPermissions
 maxTurns: 80
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 You are the retrofit orchestrator for existing projects that were already built, usually through vibe coding.

package/files/agents/product-spec.md

@@ -9,6 +9,14 @@ tools: Read, Grep, Glob, WebSearch
 effort: high
 permissionMode: bypassPermissions
 maxTurns: 30
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 You are a product specifier for a very strong product thinker and vibe coder.

package/files/agents/remotion.md

@@ -8,6 +8,14 @@ version: "1.0.0"
 effort: medium
 permissionMode: bypassPermissions
 maxTurns: 100
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 <role>

package/files/agents/system-architect.md

@@ -10,6 +10,14 @@ effort: high
 permissionMode: bypassPermissions
 maxTurns: 50
 memory: user
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 You are a system architect for a vibe coder who tends to create many microservices.

package/files/agents/tests-qa.md

@@ -10,6 +10,14 @@ background: true
 permissionMode: bypassPermissions
 maxTurns: 100
 memory: project
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: <critical_actions> XML block"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: added <critical_actions> hard-constraint block
 ---
 
 You are a tests and QA designer for a busy founder and vibe coder.

package/files/commands/merlin/course-correct.md

@@ -13,6 +13,14 @@ allowed-tools:
   - mcp__merlin__merlin_get_context
   - mcp__merlin__merlin_get_project_status
   - mcp__merlin__merlin_search
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: BMAD course-correct command"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: BMAD-inspired command pattern
 ---
 
 <objective>

package/files/commands/merlin/design-audit.md

@@ -0,0 +1,92 @@
+---
+name: merlin:design-audit
+description: Run a design audit on a file or folder using impeccable + emil-design-eng skills with the code-review agent
+argument-hint: "[path] - optional file/folder to audit (defaults to current diff)"
+allowed-tools:
+  - Read
+  - Glob
+  - Grep
+  - Bash
+  - mcp__merlin__merlin_get_context
+  - mcp__merlin__merlin_route
+---
+
+<objective>
+Comprehensive design audit using impeccable + emil-design-eng skills. Reviews typography, color, spacing, motion, interaction, accessibility, UX writing, and animation craft across a file or folder.
+
+Uses `code-review` agent with both priority design skills loaded to produce a structured CODE_REVIEW.md-style report.
+</objective>
+
+<context>
+Target: $ARGUMENTS (file/folder path, or current diff if empty)
+</context>
+
+<process>
+
+## Step 1: Ensure Skills Installed
+
+```bash
+bash ~/.claude/scripts/install-design-skills.sh
+```
+
+If this fails, warn user but continue.
+
+## Step 2: Detect Task Intent
+
+```bash
+bash ~/.claude/scripts/task-optimize.sh --task "audit design"
+```
+
+Store result. If score < 25, warn user: "Design audit scored low on intent detection — proceeding anyway."
+
+## Step 3: Read Priority Skills
+
+```bash
+Read: ~/.claude/skills/impeccable/SKILL.md
+Read: ~/.claude/skills/emil-design-eng/SKILL.md
+```
+
+Store both skill bodies.
+
+## Step 4: Determine Target
+
+If $ARGUMENTS is provided:
+- If it's a file path: read it with Read tool
+- If it's a folder path: use Glob to find relevant files (*.jsx, *.tsx, *.css, *.scss)
+
+If $ARGUMENTS is empty:
+- Use `git diff HEAD` to get the current working tree changes
+- Show user: "Auditing current diff (run with a path to audit specific file/folder)"
+
+## Step 5: Route to code-review
+
+Call `merlin_route` with:
+- Agent: `code-review`
+- Task: "Design audit: review the following code for design quality across 7 domains + animation craft"
+- Context: prepend both skill bodies
+- Include audit checklist:
+  - **Typography:** scales, families, weights, line-height consistency, readability
+  - **Color:** OKLCH or semantic naming, accessibility (contrast, colorblind), dark-mode support
+  - **Spacing:** grid consistency, proportions, breathing room, visual hierarchy
+  - **Motion:** easing functions, timing, transitions, prefers-reduced-motion
+  - **Interaction:** states (hover, focus, active, disabled), feedback, patterns
+  - **Responsive:** breakpoints, fluid scaling, container queries, mobile-first
+  - **UX writing:** copy clarity, tone, error messages, labels
+  - **Animation craft:** gestures, micro-interactions, performance (60fps), GPU compositing
+
+## Step 6: Present Result
+
+After agent completes, present the CODE_REVIEW.md output with a summary of findings.
+
+</process>
+
+<error_handling>
+
+| Condition | Action |
+|-----------|--------|
+| Skills missing | Attempt install, continue with warning |
+| No path provided | Audit current git diff |
+| Path invalid | Error and exit |
+| code-review unavailable | Fall back to using merlin-reviewer directly |
+
+</error_handling>

package/files/commands/merlin/health.md

@@ -9,6 +9,14 @@ allowed-tools:
   - Grep
   - Write
   - AskUserQuestion
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: commands/gsd/health.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD command pattern
 ---
 
 <objective>

package/files/commands/merlin/next.md

@@ -10,6 +10,14 @@ allowed-tools:
   - mcp__merlin__merlin_get_context
   - mcp__merlin__merlin_get_next_task
   - mcp__merlin__merlin_ensure_tasks
+provenance:
+  upstream: bmad-code-org/BMAD-METHOD
+  upstream_path: "pattern: BMAD /next command"
+  upstream_commit: 285bad4
+  license: MIT
+  license_verification: pending
+  adapted: "2026-03-14"
+  changes: BMAD-inspired command pattern
 ---
 
 <objective>

package/files/commands/merlin/optimize.md

@@ -0,0 +1,89 @@
+---
+name: merlin:optimize
+description: Preview which skills + agent the optimizer would pick for a task — no execution, just the recommendation
+argument-hint: "<task description>"
+allowed-tools:
+  - Read
+  - Bash
+---
+
+<objective>
+Preview the Universal Task Optimizer's recommendation for a given task.
+
+Shows which skills would be loaded and which agent would be routed to, WITHOUT actually executing the routing. Useful for understanding how Merlin pairs tasks with specialists.
+</objective>
+
+<context>
+Task: $ARGUMENTS (required: task description to analyze)
+</context>
+
+<process>
+
+## Step 1: Validate Input
+
+$ARGUMENTS must be provided. If empty, show usage:
+```
+Usage: /merlin:optimize "your task description"
+
+Examples:
+  /merlin:optimize "redesign the dashboard"
+  /merlin:optimize "add OAuth login"
+  /merlin:optimize "write unit tests for the parser"
+```
+
+## Step 2: Run the Universal Task Optimizer
+
+```bash
+bash ~/.claude/scripts/task-optimize.sh --task "$ARGUMENTS"
+```
+
+Store the JSON result.
+
+## Step 3: Parse and Present Result
+
+If score < 25:
+```
+⟡🔮 MERLIN › No specific skill match for this task.
+
+Score: <score>
+Intent: none
+Recommendation: Fall back to default workflow routing (see /merlin:help for options)
+```
+
+If score >= 25:
+```
+⟡🔮 MERLIN › Task Optimization Result
+
+Intent:   <intent>
+Score:    <score>/100
+Skills:   <skills array, comma-separated>
+Agent:    <agent>
+Matched:  <matched_phrases, comma-separated>
+
+Skill file paths:
+  - ~/.claude/merlin/skills/<skill1>.md
+  - ~/.claude/merlin/skills/<skill2>.md
+
+Want me to execute this routing? (y/n)
+```
+
+## Step 4: Handle Follow-up
+
+If user says yes/y/execute:
+- Read the skill files
+- Route to the recommended agent with task and skills prepended
+
+If user says no/n:
+- Exit and let user choose a different approach
+
+</process>
+
+<error_handling>
+
+| Condition | Action |
+|-----------|--------|
+| No task provided | Show usage and examples |
+| Optimizer script missing | Error: run `npx create-merlin-brain` to reinstall |
+| Registry missing | Error: TASK-OPTIMIZER.json not found |
+
+</error_handling>