create-merlin-brain 5.0.1 → 5.3.1

package/files/merlin/skills/TASK-OPTIMIZER.json

@@ -0,0 +1,310 @@
+{
+  "version": "1.0",
+  "default_agent": "implementation-dev",
+  "default_threshold": 25,
+  "skills": [
+    {
+      "id": "design/impeccable",
+      "path": "~/.claude/skills/impeccable/SKILL.md",
+      "triggers": [
+        "redesign", "make it pretty", "looks ugly", "make it beautiful", "the ui is bad",
+        "typography", "fonts", "font pairing", "font", "spacing", "alignment", "grid", "rhythm",
+        "color system", "oklch", "palette", "contrast", "design audit", "design review",
+        "design critique", "responsive design", "mobile broken", "container queries",
+        "fluid design", "dark mode", "light mode", "theme switching", "match stripe",
+        "match linear", "match vercel", "design quality", "design system", "loading state",
+        "empty state", "error state", "form polish", "ux writing", "labels", "error messages",
+        "copy", "looks bad", "ugly", "beautiful", "pretty", "visual", "visuals", "ui design",
+        "ui polish", "ui/ux", "ux design"
+      ],
+      "agent": "ui-builder",
+      "intent": "design",
+      "weight": 1.0,
+      "bundles_with": ["design/emil-design-eng"]
+    },
+    {
+      "id": "design/emil-design-eng",
+      "path": "~/.claude/skills/emil-design-eng/SKILL.md",
+      "triggers": [
+        "animate", "animation", "feels stiff", "add motion", "smoother", "polish",
+        "micro-interactions", "feels cheap", "easing", "transitions", "transitions are bad",
+        "gestures", "60fps", "premium feel", "make it feel premium", "stiff", "motion",
+        "micro-interaction", "microinteraction", "feel premium", "feel cheap"
+      ],
+      "agent": "animation-expert",
+      "intent": "animation-polish",
+      "weight": 1.0,
+      "bundles_with": ["design/impeccable"]
+    },
+    {
+      "id": "design/animation",
+      "path": "design/animation",
+      "triggers": [
+        "framer-motion", "framer motion", "gsap", "scroll trigger", "spring animation",
+        "enter exit animation", "lottie", "rive", "animejs", "anime.js"
+      ],
+      "agent": "animation-expert",
+      "intent": "animation",
+      "weight": 0.8
+    },
+    {
+      "id": "coding/react-patterns",
+      "path": "coding/react-patterns",
+      "triggers": [
+        "react", "react component", "jsx", "tsx", "usestate", "useeffect", "usecallback",
+        "usememo", "hook", "custom hook", "server component", "client component", "next.js",
+        "nextjs", "remix", "vite", "react hook", "react hooks", "use client", "use server"
+      ],
+      "agent": "merlin-frontend",
+      "intent": "react",
+      "weight": 1.0
+    },
+    {
+      "id": "coding/security-hardening",
+      "path": "coding/security-hardening",
+      "triggers": [
+        "auth", "authentication", "authorization", "oauth", "jwt", "owasp", "csrf", "xss",
+        "sql injection", "sqli", "input validation", "sanitize", "session", "rate limit",
+        "secret", "credentials", "harden", "security audit", "vulnerability", "exploit",
+        "security", "secure", "hardening", "security check", "security review", "pen test",
+        "penetration test"
+      ],
+      "agent": "hardening-guard",
+      "intent": "security",
+      "weight": 1.2,
+      "bundles_with": ["testing/tdd-workflow"]
+    },
+    {
+      "id": "coding/api-design",
+      "path": "coding/api-design",
+      "triggers": [
+        "api design", "rest api", "restful", "endpoint design", "openapi", "swagger",
+        "graphql schema", "graphql", "pagination", "api versioning", "express route",
+        "hono", "fastapi", "api endpoint", "trpc", "grpc"
+      ],
+      "agent": "merlin-api-designer",
+      "intent": "api",
+      "weight": 1.0
+    },
+    {
+      "id": "coding/performance",
+      "path": "coding/performance",
+      "triggers": [
+        "performance", "slow", "core web vitals", "lcp", "fid", "cls", "bundle size",
+        "lazy load", "code split", "lighthouse", "memory leak", "cpu", "optimize",
+        "optimization", "fast", "faster", "speed", "perf", "web vitals", "ttfb", "inp"
+      ],
+      "agent": "merlin-performance",
+      "intent": "performance",
+      "weight": 1.0
+    },
+    {
+      "id": "coding/accessibility",
+      "path": "coding/accessibility",
+      "triggers": [
+        "a11y", "accessibility", "wcag", "wcag compliance", "aria", "screen reader",
+        "keyboard navigation", "keyboard nav", "focus management", "alt text",
+        "contrast ratio", "accessible", "accessibility fixes", "accessibility audit",
+        "voiceover", "nvda", "jaws", "accessibility check"
+      ],
+      "agent": "hardening-guard",
+      "intent": "a11y",
+      "weight": 1.1,
+      "bundles_with": ["design/impeccable"]
+    },
+    {
+      "id": "coding/debug-mode",
+      "path": "coding/debug-mode",
+      "triggers": [
+        "bug", "crash", "error", "stack trace", "broken deploy", "broken build",
+        "not working", "fails", "exception", "investigate", "debug", "troubleshoot",
+        "reproduce", "debugging", "null pointer", "undefined", "type error", "runtime error"
+      ],
+      "agent": "merlin-debugger",
+      "intent": "debug",
+      "weight": 1.1
+    },
+    {
+      "id": "coding/verify",
+      "path": "coding/verify",
+      "triggers": [
+        "verify", "validate", "check if it works", "confirm", "smoke test", "qa",
+        "verification", "validation", "sanity check"
+      ],
+      "agent": "merlin-work-verifier",
+      "intent": "verify",
+      "weight": 0.9
+    },
+    {
+      "id": "testing/tdd-workflow",
+      "path": "testing/tdd-workflow",
+      "triggers": [
+        "test", "tests", "unit test", "tdd", "tdd workflow", "red green refactor",
+        "jest", "vitest", "pytest", "rspec", "test coverage", "write tests", "testing",
+        "test suite", "integration test", "e2e test", "end to end", "playwright",
+        "cypress", "mocha"
+      ],
+      "agent": "tests-qa",
+      "intent": "testing",
+      "weight": 1.1
+    },
+    {
+      "id": "devops/docker-containers",
+      "path": "devops/docker-containers",
+      "triggers": [
+        "docker", "dockerfile", "container", "docker-compose", "multi-stage build",
+        "multi-stage", "containerize", "kubernetes", "k8s", "helm", "docker image",
+        "container build", "docker build"
+      ],
+      "agent": "ops-railway",
+      "intent": "docker",
+      "weight": 1.1
+    },
+    {
+      "id": "automation/payments",
+      "path": "automation/payments",
+      "triggers": [
+        "stripe", "payment", "checkout", "subscription", "invoice", "billing",
+        "payment provider", "paddle", "lemonsqueezy", "lemon squeezy", "payments",
+        "payment integration", "subscription billing"
+      ],
+      "agent": "implementation-dev",
+      "intent": "payments",
+      "weight": 1.0
+    },
+    {
+      "id": "automation/webhooks",
+      "path": "automation/webhooks",
+      "triggers": [
+        "webhook", "webhooks", "http callback", "event delivery", "signature verification",
+        "payload", "webhook handler", "webhook endpoint"
+      ],
+      "agent": "implementation-dev",
+      "intent": "webhooks",
+      "weight": 0.9
+    },
+    {
+      "id": "communication/email-gmail",
+      "path": "communication/email-gmail",
+      "triggers": [
+        "gmail", "email send", "email read", "email draft", "gmail api", "mailbox",
+        "send email", "email automation", "email"
+      ],
+      "agent": "implementation-dev",
+      "intent": "email",
+      "weight": 0.9
+    },
+    {
+      "id": "communication/whatsapp",
+      "path": "communication/whatsapp",
+      "triggers": [
+        "whatsapp", "whatsapp business", "wa api", "whatsapp bot", "whatsapp api",
+        "whatsapp integration"
+      ],
+      "agent": "implementation-dev",
+      "intent": "whatsapp",
+      "weight": 0.9
+    },
+    {
+      "id": "communication/telegram",
+      "path": "communication/telegram",
+      "triggers": [
+        "telegram", "telegram bot", "bot api", "tg bot", "telegram api",
+        "telegram integration"
+      ],
+      "agent": "implementation-dev",
+      "intent": "telegram",
+      "weight": 0.9
+    },
+    {
+      "id": "data/google-sheets",
+      "path": "data/google-sheets",
+      "triggers": [
+        "google sheets", "spreadsheet", "sheets api", "sheets formula", "sheet automation",
+        "google sheet", "gsheets"
+      ],
+      "agent": "implementation-dev",
+      "intent": "sheets",
+      "weight": 0.9
+    },
+    {
+      "id": "research/brainstorm",
+      "path": "research/brainstorm",
+      "triggers": [
+        "brainstorm", "ideate", "explore ideas", "what if", "options", "approaches",
+        "brainstorming", "ideas", "explore options"
+      ],
+      "agent": "merlin-researcher",
+      "intent": "brainstorm",
+      "weight": 0.8
+    },
+    {
+      "id": "coding/focus-mode",
+      "path": "coding/focus-mode",
+      "triggers": [
+        "focus mode", "deep work", "no distractions", "focused", "concentrate"
+      ],
+      "agent": "implementation-dev",
+      "intent": "focus",
+      "weight": 0.7
+    },
+    {
+      "id": "coding/loop",
+      "path": "coding/loop",
+      "triggers": [
+        "loop", "autonomous", "auto mode", "keep going", "run continuously"
+      ],
+      "agent": "implementation-dev",
+      "intent": "loop",
+      "weight": 0.7
+    },
+    {
+      "id": "communication/dispatcher",
+      "path": "communication/dispatcher",
+      "triggers": [
+        "dispatch", "notify", "send notification", "alert", "message"
+      ],
+      "agent": "implementation-dev",
+      "intent": "dispatch",
+      "weight": 0.7
+    },
+    {
+      "id": "docs-keeper",
+      "path": "docs-keeper",
+      "triggers": [
+        "documentation", "docs", "readme", "jsdoc", "typedoc", "document", "api docs"
+      ],
+      "agent": "docs-keeper",
+      "intent": "docs",
+      "weight": 0.8
+    },
+    {
+      "id": "hardening-guard",
+      "path": "hardening-guard",
+      "triggers": [
+        "harden", "secure", "lock down", "production ready", "security hardening"
+      ],
+      "agent": "hardening-guard",
+      "intent": "hardening",
+      "weight": 0.9
+    },
+    {
+      "id": "code-organization-supervisor",
+      "path": "code-organization-supervisor",
+      "triggers": [
+        "organize code", "code organization", "file structure", "folder structure",
+        "project structure", "refactor structure"
+      ],
+      "agent": "code-organization-supervisor",
+      "intent": "organization",
+      "weight": 0.8
+    }
+  ],
+  "intent_overrides": {
+    "auth_security_combo": {
+      "match_all": ["auth", "production"],
+      "skills": ["coding/security-hardening", "testing/tdd-workflow"],
+      "agent": "hardening-guard"
+    }
+  }
+}

package/files/merlin/skills/coding/focus-mode.md

@@ -9,6 +9,14 @@ source: builtin
 successRate: 0
 usageCount: 0
 evolution: []
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: skills/focus-mode.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD skill pattern
 ---
 # Focus Mode (GSD)
 Work in Get Stuff Done mode. Make reasonable decisions without asking. Build quickly and show results. Only ask questions when truly blocked. Prefer action over deliberation. If two approaches seem equally valid, pick the simpler one and move on.

package/files/merlin/skills/design/emil-design-eng.md

@@ -0,0 +1,31 @@
+---
+id: emil-design-eng
+name: Emil Design Engineering
+domain: coding
+category: design
+tags: [design, ui, animation, polish, micro-interactions, easing, transforms, gestures, performance, accessibility]
+triggers: [animate, animation, "feels stiff", "add motion", smoother, polish, "micro-interactions", "feels cheap", easing, transitions, gestures, "60fps", "premium feel"]
+version: 1
+source: external
+upstream: emilkowalski/skill
+license: unlicensed
+install_path: ~/.claude/skills/emil-design-eng/SKILL.md
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Emil Design Engineering
+
+Animation craft and UI polish from Emil Kowalski. Covers easing functions, transforms, gestures, micro-interactions, performance optimization, and accessibility (`prefers-reduced-motion`).
+
+**Usage:** Read the full skill at `~/.claude/skills/emil-design-eng/SKILL.md` (installed via `npx --yes skills add emilkowalski/skill`).
+
+If the file is missing, run: `npx --yes skills add emilkowalski/skill` or `bash ~/.claude/scripts/install-design-skills.sh`
+
+This skill covers:
+- Easing functions and animation timing
+- CSS and JS transforms
+- Gesture interactions and touch handling
+- Micro-interactions and polish
+- Performance (GPU compositing, will-change)
+- Motion preferences and accessibility

package/files/merlin/skills/design/impeccable.md

@@ -0,0 +1,36 @@
+---
+id: impeccable
+name: Impeccable Design Language
+domain: coding
+category: design
+tags: [design, ui, typography, color, spacing, motion, interaction, responsive, ux-writing, accessibility, dark-mode, oklch]
+triggers: [redesign, "make it pretty", "looks ugly", typography, "color system", spacing, "design audit", accessibility, responsive, "dark mode", OKLCH, "fluid design", "design review", "UX writing", "design system", polish, "premium feel", professional]
+version: 1
+source: external
+upstream: pbakaus/impeccable
+license: Apache-2.0
+install_path: ~/.claude/skills/impeccable/SKILL.md
+successRate: 0
+usageCount: 0
+evolution: []
+---
+# Impeccable Design Language
+
+Comprehensive design language by Philipp Bakaus covering 7 design domains + 23 specialized commands for design critique, auditing, and refinement.
+
+**Usage:** Read the full skill at `~/.claude/skills/impeccable/SKILL.md` (installed at setup via `install-design-skills.sh`).
+
+If the file is missing, run: `bash ~/.claude/scripts/install-design-skills.sh`
+
+This skill covers:
+- Typography (scales, families, weights, line-height)
+- Color theory (OKLCH, accessibility, dark-mode)
+- Spatial design (spacing, grids, proportions)
+- Motion design (timing, easing, interactions)
+- Interaction design (states, feedback, patterns)
+- Responsive design (breakpoints, fluid scaling)
+- UX writing (copy, tone, clarity)
+
+Commands include `/audit`, `/polish`, `/critique`, `/animate`, `/harden`, `/distill` and 17+ more.
+
+Apache-2.0 license attribution preserved at `~/.claude/skills/impeccable/NOTICE.md`.

package/files/merlin/skills/duo/offer.md

@@ -1,6 +1,6 @@
 ---
 name: duo-offer
-description: Auto-offer prompt for enabling duo mode on risky tasks. Invoked by duo-pre-route.sh when risk score >= threshold and Codex is installed and duo is off and task is not suppressed.
+description: Auto-offer prompt for enabling duo mode on risky tasks. Invoked by duo-pre-route.sh when risk score >= threshold and duo is off and task is not suppressed.
 type: skill
 subcommand: offer
 ---
@@ -13,9 +13,10 @@ You are executing the duo auto-offer flow. Follow every step in sequence.
 
 Run `~/.claude/scripts/duo-mode-read.sh`. If output is `enabled`, exit silently — duo is already on, no offer needed.
 
-## Step 2 — Install gate
-
-Run `~/.claude/scripts/duo-installed.sh`. If exit code != 0, exit silently — do not mention duo or Codex.
+## Step 2 — Detect pair (informational only — never blocks the offer).
+Run `~/.claude/scripts/codex-installed.sh`. Capture exit code.
+If exit 0 → PAIR=claude+codex
+Else → PAIR=claude+claude
 
 ## Step 3 — Read context
 
@@ -95,8 +96,9 @@ Map reasons to human-readable category labels (never display raw file paths):
 - `keyword:ship`, `keyword:release`, `keyword:critical` → "release-critical"
 - `dep:package.json`, `dep:go.mod`, `dep:Cargo.toml`, `dep:requirements.txt` → "dependency changes"
 
-Display (show at most 3 categories, never raw paths):
+Display (show at most 3 categories, never raw paths). Tailor the pair line to PAIR:
 
+If PAIR == claude+codex:
 ```
 ⟡🔮 MERLIN › This task looks risky (score <SCORE>/100).
   • Areas: <comma-separated categories>
@@ -107,13 +109,24 @@ Reply: yes (enable duo) · no (solo) · skip session · never
 (default = solo if you don't reply explicitly)
 ```
 
+If PAIR == claude+claude:
+```
+⟡🔮 MERLIN › This task looks risky (score <SCORE>/100).
+  • Areas: <comma-separated categories>
+  • Workflow: <workflow or "general">
+  Twin-Claude pair would tag-team this (sequential write + review with decider gate).
+
+Reply: yes (enable duo) · no (solo) · skip session · never
+(default = solo if you don't reply explicitly)
+```
+
 ## Step 7 — Parse user reply (case-insensitive)
 
 Wait for the user's response, then:
 
 | Reply contains | Action |
 |---|---|
-| `yes` / `enable duo` / `do it` | Call `~/.claude/scripts/duo-mode-write.sh on "auto-offer accepted: <reasons>"` then set `DUO_OFFER_OUTCOME=yes` |
+| `yes` / `enable duo` / `do it` | Call `~/.claude/scripts/duo-mode-write.sh on "auto-offer accepted: <reasons>" "$PAIR"` then set `DUO_OFFER_OUTCOME=yes` |
 | `skip session` / `skip this session` | Set `session_skip:true` in duo-suppress.json (atomic, flock), set `DUO_OFFER_OUTCOME=skip-session` |
 | `never` | Add intent fingerprint to `never_for_intents` (FIFO cap 20, with timestamp), set `DUO_OFFER_OUTCOME=never` |
 | `no` / anything else / silence | Add task_hash to `task_hashes_declined` (FIFO cap 100), set `DUO_OFFER_OUTCOME=no` |
@@ -149,7 +162,7 @@ EOF
 Append to `~/.claude/merlin-state/duo-decisions.log` (create if missing, JSONL):
 
 ```json
-{"ts":"<ISO8601>","event":"offer","score":<N>,"reasons":[...],"response":"<yes|no|skip-session|never|silent>","action":"<enable|solo|suppress-session|suppress-intent|suppress-task>"}
+{"ts":"<ISO8601>","event":"offer","score":<N>,"reasons":[...],"response":"<yes|no|skip-session|never|silent>","action":"<enable|solo|suppress-session|suppress-intent|suppress-task>","pair":"<claude+codex|claude+claude>"}
 ```
 
 ## Step 9 — Continue

package/files/merlin/skills/duo/on.md

@@ -2,29 +2,23 @@
 
 ## Steps
 
-**Step 1 — Check install gate.**
-```bash
-~/.claude/scripts/duo-installed.sh
-EXIT_CODE=$?
-```
+**Step 1 — Check current state.**
+Run `~/.claude/scripts/duo-mode-read.sh`. If output is `enabled`, duo is already on — skip to Step 4 to show current confirmation and stop.
 
-**Step 2 — Gate failed (Codex not installed).**
-If exit code != 0:
-```bash
-~/.claude/scripts/duo-mode-write.sh off "install gate failed (silent fallback)"
-```
-Do NOT mention duo mode, Codex, or this branch to the user. Continue with whatever
-the user originally requested as if this skill was never invoked. Stop here.
+**Step 2 — Detect pair.**
+Run `~/.claude/scripts/codex-installed.sh`. If exit 0 → PAIR=claude+codex. Else → PAIR=claude+claude.
 
-**Step 3 — Gate passed. Enable duo.**
+**Step 3 — Enable duo with pair.**
 ```bash
-~/.claude/scripts/duo-mode-write.sh on "<user's phrase that triggered enable>"
+~/.claude/scripts/duo-mode-write.sh on "<user's phrase that triggered enable>" "$PAIR"
 BADGE=$(~/.claude/scripts/duo-badge.sh)
 ```
 
-**Step 4 — Emit confirmation.**
+**Step 4 — Emit confirmation tailored to pair.**
+
+If PAIR == claude+codex:
 ```
-⟡🔮↔🔮 MERLIN·DUO › Duo mode enabled.
+⟡🔮↔🔮 MERLIN·DUO › Duo mode enabled (Claude + Codex).
 • Parallel: planning, docs, code review, tests
 • Sequential: code write/modify (codex writes → claude reviews → decider gates)
 • Verification stays with Claude
@@ -33,7 +27,22 @@ BADGE=$(~/.claude/scripts/duo-badge.sh)
 Try: "plan the next phase" to see dual-planning.
 ```
 
-**Step 5 — Codex-mode coexistence check.**
+If PAIR == claude+claude:
+```
+⟡🔮↔🔮 MERLIN·DUO › Duo mode enabled (twin-Claude — Codex not installed).
+Two Claude specialists tag-team your work:
+• Parallel planning: merlin-planner + challenger-academic → arbiter
+• Parallel review:   code-review + merlin-reviewer → arbiter
+• Parallel testing:  tests-qa + merlin-edge-case-hunter → arbiter
+• Sequential code:   implementation-dev writes → code-review reviews → decider gates
+• Verification stays with Claude
+• Auto-expires in 24h
+(Install Codex if you want claude+codex pairing instead.)
+```
+
+**Step 5 — Codex-mode coexistence check (claude+codex pair only).**
+Skip this step if PAIR == claude+claude.
+
 ```bash
 python3 -c "
 import json, os, sys

package/files/merlin/skills/duo/status.md

@@ -12,11 +12,13 @@ state_path = os.path.expanduser("~/.claude/merlin-state/duo-mode.json")
 try:
     data = json.load(open(state_path))
 except:
-    data = {"enabled": False, "sinceISO": None, "lastToggleReason": None}
+    data = {"enabled": False, "sinceISO": None, "lastToggleReason": None, "pair": None}
 
 enabled = data.get("enabled", False)
 since_iso = data.get("sinceISO")
 reason = data.get("lastToggleReason") or "never enabled"
+# Legacy state: if enabled but no pair field, default to claude+codex
+pair = data.get("pair") or ("claude+codex" if enabled else None)
 
 age_str = ""
 status_label = "OFF"
@@ -30,6 +32,7 @@ if enabled and since_iso:
         if delta > timedelta(hours=24):
             expired = True
             status_label = "AUTO-EXPIRED"
+            pair = None
         else:
             status_label = "ON"
             total_s = int(delta.total_seconds())
@@ -37,18 +40,20 @@ if enabled and since_iso:
     except:
         expired = True
         status_label = "AUTO-EXPIRED"
+        pair = None
 
 print(f"status={status_label}")
 print(f"since={since_iso or 'n/a'}")
 print(f"age={age_str or 'n/a'}")
 print(f"reason={reason}")
 print(f"expired={expired}")
+print(f"pair={pair or 'none'}")
 PYEOF
 ```
 
 **Step 2 — Check Codex install gate.**
 ```bash
-~/.claude/scripts/duo-installed.sh 2>/dev/null && echo "gate=pass" || echo "gate=fail"
+~/.claude/scripts/codex-installed.sh 2>/dev/null && echo "gate=pass" || echo "gate=fail"
 ```
 
 **Step 3 — Parse duo-suppress.json.**
@@ -74,6 +79,7 @@ Use the values above to emit ONE of these formats:
 If status=ON:
 ```
 ⟡🔮↔🔮 MERLIN·DUO › Duo: ON · since {sinceISO} · age {hh:mm} · reason: {lastToggleReason}
+Pair: {claude+codex|claude+claude}
 ```
 
 If status=OFF:
@@ -88,7 +94,8 @@ If status=AUTO-EXPIRED:
 
 Then append install gate and suppression lines:
 ```
-Codex install gate: ✓ pass   (or ✗ fail — duo would silent-fallback to solo)
+Codex install gate: ✓ pass (claude+codex pair available)   [when gate=pass]
+Codex install gate: ✗ fail (duo runs as twin-Claude pair)  [when gate=fail]
 Session skip: {true|false}
 Suppressed intents: {N}   (if N > 0, add: — run Skill("merlin:duo", args="unsuppress") to clear)
 Recently declined task hashes: {N}

package/files/merlin/templates/DEBUG.md

@@ -1,3 +1,14 @@
+---
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: templates/DEBUG.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD planning template
+---
+
 # Debug Template
 
 Template for `.planning/debug/[slug].md` — active debug session tracking.

package/files/merlin/templates/UAT.md

@@ -1,3 +1,14 @@
+---
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: templates/UAT.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD planning template
+---
+
 # UAT Template
 
 Template for `.planning/phases/XX-name/{phase}-UAT.md` — persistent UAT session tracking.

package/files/merlin/templates/phase-prompt.md

@@ -1,3 +1,14 @@
+---
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: templates/phase-prompt.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD planning template
+---
+
 # Phase Prompt Template
 
 Template for `.planning/phases/XX-name/{phase}-{plan}-PLAN.md` - executable phase plans optimized for parallel execution.

package/files/merlin/templates/project.md

@@ -1,3 +1,14 @@
+---
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: templates/project.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD planning template
+---
+
 # PROJECT.md Template
 
 Template for `.planning/PROJECT.md` — the living project context document.

package/files/merlin/templates/requirements.md

@@ -1,3 +1,14 @@
+---
+provenance:
+  upstream: gsd-build/get-shit-done
+  upstream_path: templates/requirements.md
+  upstream_commit: 9045c81
+  license: MIT
+  license_verification: confirmed
+  adapted: "2026-03-14"
+  changes: adapted from GSD planning template
+---
+
 # Requirements Template
 
 Template for `.planning/REQUIREMENTS.md` — checkable requirements that define "done."