ma-agents 3.12.2 → 3.13.0

package/lib/bmad-cache/gds/src/workflows/2-design/gds-gdd/customize.toml

@@ -0,0 +1,99 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for gds-gdd.
+#
+# Override files (not edited here):
+#   {project-root}/_bmad/custom/gds-gdd.toml         (team)
+#   {project-root}/_bmad/custom/gds-gdd.user.toml    (personal)
+
+[workflow]
+
+# --- Configurable below. Overrides merge per BMad structural rules: ---
+#   scalars: override wins • arrays: append
+
+# Steps to run before the standard activation (config load, greet).
+# Use for pre-flight loads, compliance checks, etc.
+activation_steps_prepend = []
+
+# Steps to run after greet but before the workflow begins.
+# Use for context-heavy setup that should happen once the user has been acknowledged.
+activation_steps_append = []
+
+# Persistent facts the workflow keeps in mind for the whole run
+# (standards, compliance constraints, stylistic guardrails).
+# Each entry is either a literal sentence, a skill prefixed with `skill:`, or a `file:`-prefixed
+# path/glob whose contents are loaded as facts.
+#
+# Default loads project-context.md if gds-generate-project-context has produced one — this gives
+# the facilitator persistent awareness of the project's tech, domain, and constraints without
+# re-asking. Common opt-ins (set in team/user override TOML):
+#   "skill:acme-studio:house-game-pillars"                              # a skill that contains relevant info
+#   "Every mechanic in the GDD must trace back to a documented pillar." # generic agent instruction
+persistent_facts = [
+  "file:{project-root}/**/project-context.md",
+]
+
+# Executed when the workflow completes (after the user has been told the
+# GDD is ready). Accepts either a string scalar (single instruction)
+# or an array of instructions executed in order. Empty for none.
+on_complete = ""
+
+# Default GDD structure. Treated as a starting point — the LLM adapts it
+# to the game type and project scope. The {{GAME_TYPE_SPECIFIC_SECTIONS}}
+# slot is filled from the matched genre guide. Override the path in
+# team/user TOML to enforce a different structure (e.g. studio-standard GDD).
+gdd_template = "assets/gdd-template.md"
+
+# Validation checklist used at the Validate intent and at Finalize step 3.
+# A subagent walks the checklist against gdd.md and returns structured findings.
+# The genre and game-type checks read game_types_csv and genre_complexity_csv.
+# Override the path in team/user TOML to enforce a studio-specific checklist.
+validation_checklist = "assets/gdd-validation-checklist.md"
+
+# HTML template used to render validation findings into a styled, scannable
+# report. The renderer (scripts/render-validation-html.py) substitutes
+# structured findings + summary stats into this template; the template is
+# fully overridable to match studio branding. The default uses inline CSS, no
+# external dependencies, and native HTML <details> for collapse — no JS.
+validation_report_template = "assets/validation-report-template.html"
+
+# Game-type taxonomy. Drives game-type detection during Discovery and the
+# game-type cross-reference check during Validate. Columns: id, name,
+# description, genre_tags, fragment_file. Each fragment_file names a genre
+# guide under assets/game-types/ that scaffolds the GameType Specific Design
+# section. Override the path in team/user TOML to extend the taxonomy.
+game_types_csv = "assets/game-types.csv"
+
+# Genre-complexity ratings. Drives the genre-compliance check during Validate
+# and tells Discovery which genres carry must-document conventions. Columns:
+# genre, signals, complexity, key_concerns, required_knowledge,
+# suggested_workflow, special_sections.
+genre_complexity_csv = "assets/genre-complexity.csv"
+
+# Run folder location. The GDD, epics file, decision log, and optional
+# validation report all land inside `{output_dir}/{output_folder_name}/`.
+output_dir = "{planning_artifacts}/gdds"
+output_folder_name = "gdd-{project_name}-{date}"
+
+# Document standards applied to human-consumed docs at Finalize. Each entry is
+# a `skill:`, `file:`, or plain-text directive; the parent LLM applies the
+# findings before the user sees the draft. Empty by default — Game Dev Studio
+# ships no editorial-review skills. Add your own in team/user override TOML:
+#   "skill:my-studio:editorial-review-prose"
+#   "file:{project-root}/_bmad/style-guides/studio-voice.md"
+#   "Convert all dates to ISO 8601 format."
+doc_standards = []
+
+# External-source registry. Natural-language directives describing knowledge
+# bases, MCP tools, or internal systems the LLM may consult during the workflow
+# when a relevant need surfaces. The LLM does NOT query these preemptively —
+# it consults them on demand. If a named MCP tool is unavailable at runtime,
+# the LLM falls back to standard behavior and notes the gap. Empty by default.
+external_sources = []
+
+# External-handoff routing. Natural-language directives the LLM applies at
+# Finalize to route outputs beyond local files (Confluence, Notion, Google
+# Drive, ticket systems, etc.). Handoffs run after the artifact is polished
+# and before the final user-facing message. URLs or IDs returned by the
+# destination are captured and surfaced to the user. Empty by default.
+external_handoffs = []

package/lib/bmad-cache/gds/src/workflows/2-design/gds-gdd/scripts/render-validation-html.py

@@ -0,0 +1,290 @@
+#!/usr/bin/env python3
+# /// script
+# requires-python = ">=3.10"
+# ///
+"""Render a PRD validation findings JSON into HTML + markdown reports.
+
+Reads structured findings produced by the validator subagent, groups them by
+category (explicit `category` field, else derived from ID prefix), computes a
+pass/warn/fail summary and grade, substitutes into the configured HTML
+template, writes a markdown companion at the same path with `.md` extension,
+and optionally opens the HTML in the default browser.
+"""
+
+import argparse
+import html
+import json
+import string
+import sys
+import webbrowser
+from datetime import datetime
+from pathlib import Path
+
+CATEGORY_FROM_PREFIX = {
+    "Q": "Quality",
+    "D": "Discipline",
+    "S": "Structural integrity",
+    "STK": "Stakes-gated",
+    "M": "Mechanical",
+}
+
+CATEGORY_ORDER = ["Quality", "Discipline", "Structural integrity", "Stakes-gated", "Mechanical"]
+
+
+def category_for(finding: dict) -> str:
+    explicit = finding.get("category")
+    if explicit:
+        return explicit
+    fid = finding.get("id", "")
+    prefix = fid.split("-", 1)[0] if "-" in fid else fid
+    return CATEGORY_FROM_PREFIX.get(prefix, prefix or "Other")
+
+
+def compute_stats(findings: list[dict]) -> dict:
+    total = len(findings)
+    by_status = {"pass": 0, "warn": 0, "fail": 0, "n/a": 0}
+    failed_critical = 0
+    failed_high = 0
+    for f in findings:
+        status = (f.get("status") or "n/a").lower()
+        if status in by_status:
+            by_status[status] += 1
+        if status == "fail":
+            sev = (f.get("severity") or "low").lower()
+            if sev == "critical":
+                failed_critical += 1
+            elif sev == "high":
+                failed_high += 1
+    return {
+        "total": total,
+        "passed": by_status["pass"],
+        "warned": by_status["warn"],
+        "failed": by_status["fail"],
+        "na": by_status["n/a"],
+        "failed_critical": failed_critical,
+        "failed_high": failed_high,
+    }
+
+
+def grade_from(stats: dict) -> tuple[str, str]:
+    if stats["failed_critical"] > 0:
+        return "Poor", "grade-poor"
+    if stats["failed_high"] >= 1 or stats["failed"] >= 4:
+        return "Fair", "grade-fair"
+    if stats["failed"] > 0 or stats["warned"] > 2:
+        return "Good", "grade-good"
+    return "Excellent", "grade-excellent"
+
+
+def render_score_bar(stats: dict, width: int = 480, height: int = 22) -> str:
+    total = max(stats["total"], 1)
+    p = stats["passed"] / total * width
+    w = stats["warned"] / total * width
+    f = stats["failed"] / total * width
+    n = stats["na"] / total * width
+    return (
+        f'<svg width="{width}" height="{height}" viewBox="0 0 {width} {height}" role="img" '
+        f'aria-label="Pass / warn / fail / n-a breakdown">'
+        f'<rect x="0" y="0" width="{p:.1f}" height="{height}" fill="#22c55e"/>'
+        f'<rect x="{p:.1f}" y="0" width="{w:.1f}" height="{height}" fill="#eab308"/>'
+        f'<rect x="{p + w:.1f}" y="0" width="{f:.1f}" height="{height}" fill="#ef4444"/>'
+        f'<rect x="{p + w + f:.1f}" y="0" width="{n:.1f}" height="{height}" fill="#94a3b8"/>'
+        f"</svg>"
+    )
+
+
+def render_finding(f: dict) -> str:
+    status = (f.get("status") or "n/a").lower()
+    severity = (f.get("severity") or "low").lower()
+    fid = html.escape(f.get("id") or "")
+    title = html.escape(f.get("title") or fid)
+    location = html.escape(f.get("location") or "")
+    note = html.escape(f.get("note") or "")
+    fix = html.escape(f.get("suggested_fix") or "")
+
+    status_class = "na" if status == "n/a" else status
+    parts = [
+        f'<article class="finding finding-{status_class}">',
+        '<header>',
+        f'<span class="badge badge-status badge-{status_class}">{status.upper()}</span>',
+        f'<span class="badge badge-severity badge-sev-{severity}">{severity}</span>',
+        f'<span class="finding-id">{fid}</span>',
+        f'<h3 class="finding-title">{title}</h3>',
+        '</header>',
+    ]
+    if location:
+        parts.append(f'<div class="finding-location"><strong>Location:</strong> {location}</div>')
+    if note:
+        parts.append(f'<div class="finding-note">{note}</div>')
+    if fix:
+        parts.append(f'<div class="finding-fix"><strong>Suggested fix:</strong> {fix}</div>')
+    parts.append("</article>")
+    return "\n".join(parts)
+
+
+def render_category(name: str, findings: list[dict]) -> str:
+    items = "\n".join(render_finding(f) for f in findings)
+    name_e = html.escape(name)
+    return (
+        f'<section class="category">'
+        f"<details open>"
+        f'<summary><h2>{name_e} <span class="count">({len(findings)})</span></h2></summary>'
+        f"{items}"
+        f"</details>"
+        f"</section>"
+    )
+
+
+SEVERITY_ORDER = ["critical", "high", "medium", "low"]
+
+
+def render_finding_md(f: dict) -> str:
+    status = (f.get("status") or "n/a").upper()
+    severity = (f.get("severity") or "low").lower()
+    fid = f.get("id") or ""
+    title = f.get("title") or fid
+    location = f.get("location") or ""
+    note = f.get("note") or ""
+    fix = f.get("suggested_fix") or ""
+
+    lines = [f"### [{status}] {fid} — {title} _(severity: {severity})_"]
+    if location:
+        lines.append(f"- **Location:** {location}")
+    if note:
+        lines.append(f"- **Finding:** {note}")
+    if fix:
+        lines.append(f"- **Suggested fix:** {fix}")
+    return "\n".join(lines)
+
+
+def render_markdown_report(data: dict, findings: list[dict], stats: dict, grade: str) -> str:
+    prd_name = data.get("prd_name") or "PRD"
+    prd_path = data.get("prd_path") or ""
+    checklist_path = data.get("checklist_path") or ""
+    timestamp = data.get("timestamp") or datetime.now().isoformat(timespec="seconds")
+    synthesis = data.get("overall_synthesis") or ""
+
+    out = [
+        f"# Validation Report — {prd_name}",
+        "",
+        f"- **PRD:** `{prd_path}`",
+        f"- **Checklist:** `{checklist_path}`",
+        f"- **Run at:** {timestamp}",
+        f"- **Grade:** {grade}",
+        "",
+        f"**Summary:** {stats['passed']} pass · {stats['warned']} warn · {stats['failed']} fail · {stats['na']} n/a "
+        f"(total {stats['total']}; critical fails: {stats['failed_critical']}, high fails: {stats['failed_high']})",
+    ]
+    if synthesis:
+        out += ["", "## Overall synthesis", "", synthesis]
+
+    # Group by severity then status: failed criticals first, then highs, etc.
+    by_sev: dict[str, list[dict]] = {s: [] for s in SEVERITY_ORDER}
+    other: list[dict] = []
+    for f in findings:
+        sev = (f.get("severity") or "low").lower()
+        if sev in by_sev:
+            by_sev[sev].append(f)
+        else:
+            other.append(f)
+
+    out += ["", "## Findings by severity"]
+    any_findings = False
+    for sev in SEVERITY_ORDER:
+        items = by_sev[sev]
+        if not items:
+            continue
+        any_findings = True
+        out += ["", f"### {sev.capitalize()} ({len(items)})", ""]
+        out += [render_finding_md(f) for f in items]
+    if other:
+        any_findings = True
+        out += ["", f"### Other ({len(other)})", ""]
+        out += [render_finding_md(f) for f in other]
+    if not any_findings:
+        out += ["", "_No findings._"]
+
+    return "\n".join(out) + "\n"
+
+
+def main(argv: list[str]) -> int:
+    parser = argparse.ArgumentParser(description="Render PRD validation findings to HTML.")
+    parser.add_argument("--findings", required=True, help="Path to validation-findings.json")
+    parser.add_argument("--template", required=True, help="Path to HTML template")
+    parser.add_argument("--output", required=True, help="Path to write the rendered HTML")
+    parser.add_argument("--open", action="store_true", help="Open the rendered HTML in the default browser")
+    args = parser.parse_args(argv)
+
+    findings_path = Path(args.findings)
+    template_path = Path(args.template)
+    output_path = Path(args.output)
+
+    try:
+        data = json.loads(findings_path.read_text(encoding="utf-8"))
+    except FileNotFoundError:
+        print(f"error: findings file not found: {findings_path}", file=sys.stderr)
+        return 1
+    except json.JSONDecodeError as e:
+        print(f"error: findings file is not valid JSON ({findings_path}): {e}", file=sys.stderr)
+        return 1
+    try:
+        template = template_path.read_text(encoding="utf-8")
+    except FileNotFoundError:
+        print(f"error: template file not found: {template_path}", file=sys.stderr)
+        return 1
+
+    findings = data.get("findings", []) or []
+
+    by_cat: dict[str, list[dict]] = {}
+    for f in findings:
+        by_cat.setdefault(category_for(f), []).append(f)
+
+    sorted_cats = sorted(
+        by_cat.keys(),
+        key=lambda c: (CATEGORY_ORDER.index(c) if c in CATEGORY_ORDER else 99, c),
+    )
+    categories_html = "\n".join(render_category(c, by_cat[c]) for c in sorted_cats)
+
+    stats = compute_stats(findings)
+    grade, grade_class = grade_from(stats)
+    score_svg = render_score_bar(stats)
+
+    timestamp = data.get("timestamp") or datetime.now().isoformat(timespec="seconds")
+    substitutions = {
+        "prd_name": html.escape(str(data.get("prd_name") or "PRD")),
+        "prd_path": html.escape(str(data.get("prd_path") or "")),
+        "checklist_path": html.escape(str(data.get("checklist_path") or "")),
+        "timestamp": html.escape(timestamp),
+        "overall_synthesis": html.escape(str(data.get("overall_synthesis") or "")),
+        "grade": grade,
+        "grade_class": grade_class,
+        "total": str(stats["total"]),
+        "passed": str(stats["passed"]),
+        "failed": str(stats["failed"]),
+        "warned": str(stats["warned"]),
+        "na": str(stats["na"]),
+        "score_svg": score_svg,
+        "categories_html": categories_html,
+    }
+
+    rendered = string.Template(template).safe_substitute(substitutions)
+    output_path.write_text(rendered, encoding="utf-8")
+
+    md_path = output_path.with_suffix(".md")
+    md_path.write_text(render_markdown_report(data, findings, stats, grade), encoding="utf-8")
+
+    print(json.dumps({
+        "output": str(output_path),
+        "markdown": str(md_path),
+        "grade": grade,
+        "stats": stats,
+    }))
+
+    if args.open:
+        webbrowser.open(output_path.resolve().as_uri())
+
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main(sys.argv[1:]))

package/lib/bmad-cache/gds/src/workflows/2-design/gds-prd/assets/validation-report-template.html

@@ -0,0 +1,190 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>PRD Validation: $prd_name</title>
+<style>
+  :root {
+    --bg: #fafaf9;
+    --surface: #ffffff;
+    --border: #e7e5e4;
+    --text: #1c1917;
+    --muted: #78716c;
+    --pass: #22c55e;
+    --warn: #eab308;
+    --fail: #ef4444;
+    --na: #94a3b8;
+    --sev-low: #64748b;
+    --sev-medium: #ca8a04;
+    --sev-high: #ea580c;
+    --sev-critical: #dc2626;
+    --grade-exc: #16a34a;
+    --grade-good: #65a30d;
+    --grade-fair: #d97706;
+    --grade-poor: #dc2626;
+  }
+  * { box-sizing: border-box; }
+  html, body { margin: 0; padding: 0; }
+  body {
+    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Inter, system-ui, sans-serif;
+    background: var(--bg);
+    color: var(--text);
+    line-height: 1.55;
+    font-size: 15px;
+  }
+  .container { max-width: 960px; margin: 0 auto; padding: 32px 24px 64px; }
+
+  header.report-header {
+    display: flex;
+    align-items: center;
+    justify-content: space-between;
+    gap: 24px;
+    padding-bottom: 16px;
+    border-bottom: 1px solid var(--border);
+    margin-bottom: 24px;
+  }
+  .title h1 { margin: 0; font-size: 22px; font-weight: 600; letter-spacing: -0.01em; }
+  .title .subtitle { color: var(--muted); font-size: 13px; margin-top: 4px; font-family: ui-monospace, "SF Mono", Menlo, monospace; }
+  .grade {
+    padding: 10px 18px;
+    border-radius: 8px;
+    font-weight: 600;
+    color: white;
+    font-size: 15px;
+    white-space: nowrap;
+  }
+  .grade-excellent { background: var(--grade-exc); }
+  .grade-good { background: var(--grade-good); }
+  .grade-fair { background: var(--grade-fair); }
+  .grade-poor { background: var(--grade-poor); }
+
+  .synthesis {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-left: 3px solid var(--muted);
+    border-radius: 8px;
+    padding: 16px 20px;
+    margin-bottom: 24px;
+    color: var(--text);
+    font-size: 15px;
+  }
+  .synthesis:empty { display: none; }
+
+  .scoreboard {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    padding: 18px 20px;
+    margin-bottom: 24px;
+  }
+  .score-bar { margin: 0 0 14px; line-height: 0; }
+  .score-stats { display: flex; gap: 22px; font-size: 14px; flex-wrap: wrap; }
+  .score-stats span { display: inline-flex; align-items: center; gap: 6px; }
+  .score-stats .dot { width: 10px; height: 10px; border-radius: 50%; display: inline-block; }
+  .dot-pass { background: var(--pass); }
+  .dot-warn { background: var(--warn); }
+  .dot-fail { background: var(--fail); }
+  .dot-na { background: var(--na); }
+  .total-count { margin-left: auto; color: var(--muted); }
+
+  section.category { margin-bottom: 16px; }
+  section.category details {
+    background: var(--surface);
+    border: 1px solid var(--border);
+    border-radius: 8px;
+    overflow: hidden;
+  }
+  section.category summary {
+    padding: 14px 20px;
+    cursor: pointer;
+    user-select: none;
+    list-style: none;
+  }
+  section.category summary::-webkit-details-marker { display: none; }
+  section.category summary::before {
+    content: "▸";
+    display: inline-block;
+    margin-right: 10px;
+    color: var(--muted);
+    transition: transform 0.15s ease;
+  }
+  section.category details[open] summary::before { transform: rotate(90deg); }
+  section.category summary h2 { display: inline; margin: 0; font-size: 16px; font-weight: 600; letter-spacing: -0.005em; }
+  section.category .count { color: var(--muted); font-weight: 400; margin-left: 6px; font-size: 14px; }
+
+  article.finding { padding: 16px 20px; border-top: 1px solid var(--border); }
+  article.finding-fail { background: rgba(239, 68, 68, 0.025); }
+  article.finding header {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    flex-wrap: wrap;
+    margin-bottom: 8px;
+  }
+  .badge {
+    font-size: 10.5px;
+    padding: 3px 8px;
+    border-radius: 4px;
+    font-weight: 600;
+    text-transform: uppercase;
+    letter-spacing: 0.04em;
+    line-height: 1.4;
+  }
+  .badge-pass { background: rgba(34, 197, 94, 0.12); color: #15803d; }
+  .badge-warn { background: rgba(234, 179, 8, 0.14); color: #854d0e; }
+  .badge-fail { background: rgba(239, 68, 68, 0.12); color: #b91c1c; }
+  .badge-na { background: rgba(148, 163, 184, 0.16); color: #475569; }
+  .badge-sev-low { background: rgba(100, 116, 139, 0.12); color: var(--sev-low); }
+  .badge-sev-medium { background: rgba(202, 138, 4, 0.14); color: var(--sev-medium); }
+  .badge-sev-high { background: rgba(234, 88, 12, 0.14); color: var(--sev-high); }
+  .badge-sev-critical { background: rgba(220, 38, 38, 0.14); color: var(--sev-critical); }
+  .finding-id { font-family: ui-monospace, "SF Mono", Menlo, monospace; font-size: 12px; color: var(--muted); }
+  .finding-title { margin: 0; font-size: 15px; font-weight: 500; flex: 1; min-width: 200px; }
+  .finding-location, .finding-note, .finding-fix { margin-top: 6px; font-size: 14px; color: var(--text); }
+  .finding-location strong, .finding-fix strong { color: var(--muted); font-weight: 500; }
+
+  footer.report-footer {
+    margin-top: 40px;
+    padding-top: 16px;
+    border-top: 1px solid var(--border);
+    font-size: 12px;
+    color: var(--muted);
+    font-family: ui-monospace, "SF Mono", Menlo, monospace;
+  }
+  footer .meta { display: flex; gap: 24px; flex-wrap: wrap; }
+</style>
+</head>
+<body>
+  <div class="container">
+    <header class="report-header">
+      <div class="title">
+        <h1>$prd_name — Validation Report</h1>
+        <div class="subtitle">$prd_path</div>
+      </div>
+      <div class="grade $grade_class">$grade</div>
+    </header>
+
+    <div class="synthesis">$overall_synthesis</div>
+
+    <div class="scoreboard">
+      <div class="score-bar">$score_svg</div>
+      <div class="score-stats">
+        <span><span class="dot dot-pass"></span>$passed pass</span>
+        <span><span class="dot dot-warn"></span>$warned warn</span>
+        <span><span class="dot dot-fail"></span>$failed fail</span>
+        <span><span class="dot dot-na"></span>$na n/a</span>
+        <span class="total-count">$total items checked</span>
+      </div>
+    </div>
+
+    $categories_html
+
+    <footer class="report-footer">
+      <div class="meta">
+        <span>Checklist: $checklist_path</span>
+        <span>Generated: $timestamp</span>
+      </div>
+    </footer>
+  </div>
+</body>
+</html>

package/lib/bmad-cache/gds/src/workflows/2-design/gds-prd/customize.toml

@@ -0,0 +1,84 @@
+# DO NOT EDIT -- overwritten on every update.
+#
+# Workflow customization surface for gds-prd.
+#
+# Override files (not edited here):
+#   {project-root}/_bmad/custom/gds-prd.toml         (team)
+#   {project-root}/_bmad/custom/gds-prd.user.toml    (personal)
+
+[workflow]
+
+# --- Configurable below. Overrides merge per BMad structural rules: ---
+#   scalars: override wins • arrays: append
+
+# Steps to run before the standard activation (config load, greet).
+# Use for pre-flight loads, compliance checks, etc.
+activation_steps_prepend = []
+
+# Steps to run after greet but before the workflow begins.
+# Use for context-heavy setup that should happen once the user has been acknowledged.
+activation_steps_append = []
+
+# Persistent facts the workflow keeps in mind for the whole run
+# (standards, compliance constraints, stylistic guardrails).
+# Each entry is either a literal sentence, a skill prefixed with `skill:`, or a `file:`-prefixed
+# path/glob whose contents are loaded as facts.
+#
+# Default loads project-context.md if gds-generate-project-context has produced one — this gives
+# the facilitator persistent awareness of the project's tech, domain, and constraints without
+# re-asking. Common opt-ins (set in team/user override TOML):
+#   "skill:acme-studio:terms-and-conditions"                                  # a skill that contains relevant info
+#   "Every PRD requirement must be testable and traceable to a GDD pillar."   # generic agent instruction
+persistent_facts = [
+  "file:{project-root}/**/project-context.md",
+]
+
+# Executed when the workflow completes (after the user has been told the
+# PRD is ready). Accepts either a string scalar (single instruction)
+# or an array of instructions executed in order. Empty for none.
+on_complete = ""
+
+# Default PRD structure. Treated as a starting point — the LLM adapts it
+# to the product, project type, and domain. Override the path in team/user TOML
+# to enforce a different structure (e.g. regulated-industry, internal-tool).
+prd_template = "assets/prd-template.md"
+
+# Validation checklist used at the Validate intent and at Finalize step 3.
+# A subagent walks the checklist against prd.md and returns structured findings.
+# Override the path in team/user TOML to enforce a studio-specific checklist.
+validation_checklist = "assets/prd-validation-checklist.md"
+
+# HTML skeleton the synthesis pass fills directly when consolidating reviewer
+# outputs into a validation report. No substitution engine — the parent LLM
+# writes the final HTML. Fully overridable to match studio branding.
+# Uses inline CSS, no external dependencies, and native HTML <details> for
+# collapse — no JS.
+validation_report_template = "assets/validation-report-template.html"
+
+# Run folder location. The PRD, optional addendum, decision log, and optional
+# validation report all land inside `{output_dir}/{output_folder_name}/`.
+output_dir = "{planning_artifacts}/prds"
+output_folder_name = "prd-{project_name}-{date}"
+
+# Document standards applied to human-consumed docs at Finalize. Each entry is
+# a `skill:`, `file:`, or plain-text directive; the parent LLM applies the
+# findings before the user sees the draft. Empty by default — Game Dev Studio
+# ships no editorial-review skills. Add your own in team/user override TOML:
+#   "skill:my-studio:editorial-review-prose"
+#   "file:{project-root}/_bmad/style-guides/studio-voice.md"
+#   "Convert all dates to ISO 8601 format."
+doc_standards = []
+
+# External-source registry. Natural-language directives describing knowledge
+# bases, MCP tools, or internal systems the LLM may consult during the workflow
+# when a relevant need surfaces. The LLM does NOT query these preemptively —
+# it consults them on demand. If a named MCP tool is unavailable at runtime,
+# the LLM falls back to standard behavior and notes the gap. Empty by default.
+external_sources = []
+
+# External-handoff routing. Natural-language directives the LLM applies at
+# Finalize to route outputs beyond local files (Confluence, Notion, Google
+# Drive, ticket systems, etc.). Handoffs run after the artifact is polished
+# and before the final user-facing message. URLs or IDs returned by the
+# destination are captured and surfaced to the user. Empty by default.
+external_handoffs = []