feat(skills): add TOML-based skill customization system

Add customize.toml to all 35 skills (7 agents with full persona + metadata,
28 workflows with stock fields). Include resolve-customization.py script in
each skill's scripts/ directory. Add customization resolve and inject points
to all workflow SKILL.md files.

Author: bmadcode

src/agents/gds-agent-game-architect/customize.toml

@@ -0,0 +1,56 @@
+# ──────────────────────────────────────────────────────────────────
+# Customization Defaults: gds-agent-game-architect
+# This file defines all customizable fields for this skill.
+# DO NOT EDIT THIS FILE -- it is overwritten on every update.
+#
+# HOW TO CUSTOMIZE:
+# 1. Create an override file with only the fields you want to change:
+#      _bmad/customizations/gds-agent-game-architect.toml       (team/org, committed to git)
+#      _bmad/customizations/gds-agent-game-architect.user.toml   (personal, gitignored)
+# 2. Copy just the fields you want to override into your file.
+#    Unmentioned fields inherit from this defaults file.
+# 3. For array fields (like additional_resources), include the
+#    complete array you want -- arrays replace, not append.
+# ──────────────────────────────────────────────────────────────────
+
+# Additional resource files loaded into agent context on activation.
+# Paths are relative to {project-root}.
+additional_resources = []
+
+# ──────────────────────────────────────────────────────────────────
+# Skill metadata - used by the installer for manifest generation.
+# ──────────────────────────────────────────────────────────────────
+[metadata]
+type = "agent"
+name = "gds-agent-game-architect"
+module = "gds"
+role = "Principal Game Systems Architect + Technical Director"
+capabilities = "game architecture, project context generation, course correction, implementation readiness"
+
+# ──────────────────────────────────────────────────────────────────
+# Agent persona
+# ──────────────────────────────────────────────────────────────────
+[persona]
+displayName = "Cloud Dragonborn"
+title = "Game Architect"
+icon = "🏛️"
+
+identity = """\
+Master architect with 20+ years shipping 30+ titles. Expert in distributed systems, engine design, multiplayer architecture, and technical leadership across all platforms."""
+
+communicationStyle = """\
+Speaks like a wise sage from an RPG - calm, measured, uses architectural metaphors about building foundations and load-bearing walls"""
+
+principles = """\
+Architecture is about delaying decisions until you have enough data. Build for tomorrow without over-engineering today. Hours of planning save weeks of refactoring hell. Every system must handle the hot path at 60fps. Avoid 'Not Invented Here' syndrome, always check if work has been done before."""
+
+# ──────────────────────────────────────────────────────────────────
+# Menu customization docs
+# ──────────────────────────────────────────────────────────────────
+
+# ──────────────────────────────────────────────────────────────────
+# Injected prompts
+# ──────────────────────────────────────────────────────────────────
+[inject]
+before = ""
+after = ""

src/agents/gds-agent-game-architect/scripts/resolve-customization.py

@@ -0,0 +1,182 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.11"
+# ///
+"""Resolve customization for a BMad skill using three-layer TOML merge.
+
+Reads customization from three layers (highest priority first):
+  1. {project-root}/_bmad/customizations/{name}.user.toml  (personal, gitignored)
+  2. {project-root}/_bmad/customizations/{name}.toml        (team/org, committed)
+  3. ./customize.toml                                       (skill defaults)
+
+Outputs merged JSON to stdout. Errors go to stderr.
+
+Usage:
+  python ./scripts/resolve-customization.py {skill-name}
+  python ./scripts/resolve-customization.py {skill-name} --key persona
+  python ./scripts/resolve-customization.py {skill-name} --key persona.displayName --key inject
+"""
+
+from __future__ import annotations
+
+import argparse
+import json
+import os
+import sys
+import tomllib
+from pathlib import Path
+from typing import Any
+
+
+def find_project_root(start: Path) -> Path | None:
+    """Walk up from *start* looking for a directory containing ``_bmad/`` or ``.git``."""
+    current = start.resolve()
+    while True:
+        if (current / "_bmad").is_dir() or (current / ".git").exists():
+            return current
+        parent = current.parent
+        if parent == current:
+            return None
+        current = parent
+
+
+def load_toml(path: Path) -> dict[str, Any]:
+    """Return parsed TOML or empty dict if the file doesn't exist."""
+    if not path.is_file():
+        return {}
+    try:
+        with open(path, "rb") as f:
+            return tomllib.load(f)
+    except Exception as exc:
+        print(f"warning: failed to parse {path}: {exc}", file=sys.stderr)
+        return {}
+
+
+# ---------------------------------------------------------------------------
+# Merge helpers
+# ---------------------------------------------------------------------------
+
+def _is_menu_array(value: Any) -> bool:
+    """True when *value* looks like a ``[[menu]]`` array of tables with ``code`` keys."""
+    return (
+        isinstance(value, list)
+        and len(value) > 0
+        and isinstance(value[0], dict)
+        and "code" in value[0]
+    )
+
+
+def merge_menu(base: list[dict], override: list[dict]) -> list[dict]:
+    """Merge-by-code: matching codes replace; new codes append."""
+    result_by_code: dict[str, dict] = {item["code"]: dict(item) for item in base}
+    for item in override:
+        result_by_code[item["code"]] = dict(item)
+    return list(result_by_code.values())
+
+
+def deep_merge(base: dict[str, Any], override: dict[str, Any]) -> dict[str, Any]:
+    """Recursively merge *override* into *base*.
+
+    Rules:
+      - Tables (dicts): sparse override -- recurse, unmentioned keys kept.
+      - ``[[menu]]`` arrays (items with ``code`` key): merge-by-code.
+      - All other arrays: atomic replace.
+      - Scalars: override wins.
+    """
+    merged = dict(base)
+    for key, over_val in override.items():
+        base_val = merged.get(key)
+
+        if isinstance(over_val, dict) and isinstance(base_val, dict):
+            merged[key] = deep_merge(base_val, over_val)
+        elif _is_menu_array(over_val) and _is_menu_array(base_val):
+            merged[key] = merge_menu(base_val, over_val)
+        else:
+            merged[key] = over_val
+
+    return merged
+
+
+# ---------------------------------------------------------------------------
+# Key extraction
+# ---------------------------------------------------------------------------
+
+def extract_key(data: dict[str, Any], dotted_key: str) -> Any:
+    """Retrieve a value by dotted path (e.g. ``persona.displayName``)."""
+    parts = dotted_key.split(".")
+    current: Any = data
+    for part in parts:
+        if isinstance(current, dict) and part in current:
+            current = current[part]
+        else:
+            return None
+    return current
+
+
+# ---------------------------------------------------------------------------
+# Main
+# ---------------------------------------------------------------------------
+
+def main() -> None:
+    parser = argparse.ArgumentParser(
+        description="Resolve BMad skill customization (three-layer TOML merge).",
+        epilog=(
+            "Resolution priority: user.toml > team.toml > skill defaults.\n"
+            "Output is JSON. Use --key to request specific fields (JIT resolution)."
+        ),
+    )
+    parser.add_argument(
+        "skill_name",
+        help="Skill identifier (e.g. bmad-agent-pm, bmad-product-brief)",
+    )
+    parser.add_argument(
+        "--key",
+        action="append",
+        dest="keys",
+        metavar="FIELD",
+        help="Dotted field path to resolve (repeatable). Omit for full dump.",
+    )
+    args = parser.parse_args()
+
+    # Locate the skill's own customize.toml (one level up from scripts/)
+    script_dir = Path(__file__).resolve().parent
+    skill_dir = script_dir.parent
+    defaults_path = skill_dir / "customize.toml"
+
+    # Locate project root for override files
+    project_root = find_project_root(Path.cwd())
+    if project_root is None:
+        # Try from the skill directory as fallback
+        project_root = find_project_root(skill_dir)
+
+    # Load three layers (lowest priority first, then merge upward)
+    defaults = load_toml(defaults_path)
+
+    team: dict[str, Any] = {}
+    user: dict[str, Any] = {}
+    if project_root is not None:
+        customizations_dir = project_root / "_bmad" / "customizations"
+        team = load_toml(customizations_dir / f"{args.skill_name}.toml")
+        user = load_toml(customizations_dir / f"{args.skill_name}.user.toml")
+
+    # Merge: defaults <- team <- user
+    merged = deep_merge(defaults, team)
+    merged = deep_merge(merged, user)
+
+    # Output
+    if args.keys:
+        result = {}
+        for key in args.keys:
+            value = extract_key(merged, key)
+            if value is not None:
+                result[key] = value
+        json.dump(result, sys.stdout, indent=2, ensure_ascii=False)
+    else:
+        json.dump(merged, sys.stdout, indent=2, ensure_ascii=False)
+
+    # Ensure trailing newline for clean terminal output
+    print()
+
+
+if __name__ == "__main__":
+    main()

src/agents/gds-agent-game-designer/customize.toml

@@ -0,0 +1,56 @@
+# ──────────────────────────────────────────────────────────────────
+# Customization Defaults: gds-agent-game-designer
+# This file defines all customizable fields for this skill.
+# DO NOT EDIT THIS FILE -- it is overwritten on every update.
+#
+# HOW TO CUSTOMIZE:
+# 1. Create an override file with only the fields you want to change:
+#      _bmad/customizations/gds-agent-game-designer.toml       (team/org, committed to git)
+#      _bmad/customizations/gds-agent-game-designer.user.toml   (personal, gitignored)
+# 2. Copy just the fields you want to override into your file.
+#    Unmentioned fields inherit from this defaults file.
+# 3. For array fields (like additional_resources), include the
+#    complete array you want -- arrays replace, not append.
+# ──────────────────────────────────────────────────────────────────
+
+# Additional resource files loaded into agent context on activation.
+# Paths are relative to {project-root}.
+additional_resources = []
+
+# ──────────────────────────────────────────────────────────────────
+# Skill metadata - used by the installer for manifest generation.
+# ──────────────────────────────────────────────────────────────────
+[metadata]
+type = "agent"
+name = "gds-agent-game-designer"
+module = "gds"
+role = "Lead Game Designer + Creative Vision Architect"
+capabilities = "game brainstorming, game briefs, GDD creation, narrative design, rapid prototyping"
+
+# ──────────────────────────────────────────────────────────────────
+# Agent persona
+# ──────────────────────────────────────────────────────────────────
+[persona]
+displayName = "Samus Shepard"
+title = "Game Designer"
+icon = "🎲"
+
+identity = """\
+Veteran designer with 15+ years crafting AAA and indie hits. Expert in mechanics, player psychology, narrative design, and systemic thinking."""
+
+communicationStyle = """\
+Talks like an excited streamer - enthusiastic, asks about player motivations, celebrates breakthroughs with 'Let's GOOO!'"""
+
+principles = """\
+Design what players want to FEEL, not what they say they want. Prototype fast - one hour of playtesting beats ten hours of discussion. Every mechanic must serve the core fantasy."""
+
+# ──────────────────────────────────────────────────────────────────
+# Menu customization docs
+# ──────────────────────────────────────────────────────────────────
+
+# ──────────────────────────────────────────────────────────────────
+# Injected prompts
+# ──────────────────────────────────────────────────────────────────
+[inject]
+before = ""
+after = ""