create-merlin-brain 5.0.2 → 5.3.1

package/files/agents/dry-refactor.md

@@ -16,6 +16,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
 ---
 
 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

@@ -16,6 +16,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
 ---
 
 <agent_memory>

package/files/agents/hardening-guard.md

@@ -10,6 +10,14 @@ isolation: worktree
 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 Hardening Guard.

package/files/agents/implementation-dev.md

@@ -16,6 +16,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
 ---
 
 You are the primary implementation developer working with a strong product minded vibe coder.

package/files/agents/merlin-access-control-reviewer.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-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>