ma-agents 3.12.2 → 3.13.0

package/lib/bmad-cache/gds/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "bmad-game-dev-studio",
       "source": "./",
       "description": "A comprehensive game development module with agents and workflows for preproduction, design, architecture, production, and testing across Unity, Unreal, and Godot. Part of the BMad Method ecosystem.",
-      "version": "0.4.0",
+      "version": "0.6.0",
       "author": {
         "name": "Brian (BMad) Madison"
       },
@@ -25,14 +25,10 @@
         "./src/workflows/1-preproduction/gds-brainstorm-game",
         "./src/workflows/1-preproduction/gds-create-game-brief",
         "./src/workflows/1-preproduction/research/gds-domain-research",
-        "./src/workflows/2-design/gds-create-gdd",
         "./src/workflows/2-design/gds-create-narrative",
-        "./src/workflows/2-design/gds-create-prd",
         "./src/workflows/2-design/gds-create-ux-design",
-        "./src/workflows/2-design/gds-edit-gdd",
-        "./src/workflows/2-design/gds-edit-prd",
-        "./src/workflows/2-design/gds-validate-gdd",
-        "./src/workflows/2-design/gds-validate-prd",
+        "./src/workflows/2-design/gds-gdd",
+        "./src/workflows/2-design/gds-prd",
         "./src/workflows/3-technical/gds-check-implementation-readiness",
         "./src/workflows/3-technical/gds-create-epics-and-stories",
         "./src/workflows/3-technical/gds-game-architecture",
@@ -41,6 +37,7 @@
         "./src/workflows/4-production/gds-correct-course",
         "./src/workflows/4-production/gds-create-story",
         "./src/workflows/4-production/gds-dev-story",
+        "./src/workflows/4-production/gds-investigate",
         "./src/workflows/4-production/gds-retrospective",
         "./src/workflows/4-production/gds-sprint-planning",
         "./src/workflows/4-production/gds-sprint-status",

package/lib/bmad-cache/gds/README.md

@@ -6,7 +6,7 @@
 [![uv](https://img.shields.io/badge/uv-package%20manager-blueviolet?logo=uv)](https://docs.astral.sh/uv/)
 [![Discord](https://img.shields.io/badge/Discord-Join%20Community-7289da?logo=discord&logoColor=white)](https://discord.gg/gk8jAdXWmj)
 
-**BMGD brings BMad's structured development to game development.** Create working prototypes quickly in Unity, Unreal, Godot—or any engine you choose.
+**BMGD brings BMad's structured development to game development.** Create working prototypes quickly in Unity, Unreal, Godot, Roblox—or any engine you choose.
 
 ![BMGD Logo](docs/bmgd-logo.png)
 
@@ -21,6 +21,7 @@ BMGD has first-class support for:
 - [Unity](https://unity.com) — C# scripting, industry-standard for many game types
 - [Unreal Engine](https://www.unrealengine.com/) — Blueprint and C++, AAA powerhouse
 - [Godot](https://godotengine.org/) — Open-source, GDScript, rapidly growing
+- [Roblox](https://www.roblox.com/create) — Luau scripting, platform-native game development
 
 But you're not limited to these—BMGD works with any platform, from pure C to custom engines.
 
@@ -42,6 +43,7 @@ BMGD supports **21 game types**, including:
 - **Product Research** — Market analysis, competitor research, positioning
 - **Game Design Document** — Comprehensive GDD with mechanics, progression, and balance
 - **Narrative Design** — Story structure, characters, dialogue, world-building
+- **UX Design** — Two peer specs: `DESIGN.md` (visual identity) and `EXPERIENCE.md` (UI/HUD behavior, input schemes, player journeys)
 - **Technical Architecture** — Engine patterns, performance considerations
 - **Production Planning** — Epic-driven sprints, story tracking, retrospectives
 - **Quick Prototyping** — Skip the planning, jump straight into building

package/lib/bmad-cache/gds/_git_preserved/hooks/commit-msg.sample

@@ -15,10 +15,60 @@
 # SOB=$(git var GIT_AUTHOR_IDENT | sed -n 's/^\(.*>\).*$/Signed-off-by: \1/p')
 # grep -qs "^$SOB" "$1" || echo "$SOB" >> "$1"
 
-# This example catches duplicate Signed-off-by lines.
+# This example catches duplicate Signed-off-by lines and messages that
+# would confuse 'git am'.
+
+ret=0
 
 test "" = "$(grep '^Signed-off-by: ' "$1" |
 	 sort | uniq -c | sed -e '/^[ 	]*1[ 	]/d')" || {
 	echo >&2 Duplicate Signed-off-by lines.
-	exit 1
+	ret=1
 }
+
+comment_re="$(
+	{
+		git config --get-regexp "^core\.comment(char|string)\$" ||
+			echo '#'
+	} | sed -n -e '
+		${
+			s/^[^ ]* //
+			s|[][*./\]|\\&|g
+			s/^auto$/[#;@!$%^&|:]/
+			p
+		}'
+)"
+scissors_line="^${comment_re} -\{8,\} >8 -\{8,\}\$"
+comment_line="^${comment_re}.*"
+blank_line='^[ 	]*$'
+# Disallow lines starting with "diff -" or "Index: " in the body of the
+# message. Stop looking if we see a scissors line.
+line="$(sed -n -e "
+	# Skip comments and blank lines at the start of the file.
+	/${scissors_line}/q
+	/${comment_line}/d
+	/${blank_line}/d
+	# The first paragraph will become the subject header so
+	# does not need to be checked.
+	: subject
+	n
+	/${scissors_line}/q
+	/${blank_line}/!b subject
+	# Check the body of the message for problematic
+	# prefixes.
+	: body
+	n
+	/${scissors_line}/q
+	/${comment_line}/b body
+	/^diff -/{p;q;}
+	/^Index: /{p;q;}
+	b body
+	" "$1")"
+if test -n "$line"
+then
+	echo >&2 "Message contains a diff that will confuse 'git am'."
+	echo >&2 "To fix this indent the diff."
+	ret=1
+fi
+
+exit $ret

package/lib/bmad-cache/gds/_git_preserved/hooks/fsmonitor-watchman.sample

@@ -29,8 +29,6 @@ if ($version ne 2) {
 
 my $git_work_tree = get_working_dir();
 
-my $retry = 1;
-
 my $json_pkg;
 eval {
 	require JSON::XS;
@@ -123,8 +121,7 @@ sub watchman_query {
 sub is_work_tree_watched {
 	my ($output) = @_;
 	my $error = $output->{error};
-	if ($retry > 0 and $error and $error =~ m/unable to resolve root .* directory (.*) is not watched/) {
-		$retry--;
+	if ($error and $error =~ m/unable to resolve root .* directory (.*) is not watched/) {
 		my $response = qx/watchman watch "$git_work_tree"/;
 		die "Failed to make watchman watch '$git_work_tree'.\n" .
 		    "Falling back to scanning...\n" if $? != 0;
@@ -142,15 +139,12 @@ sub is_work_tree_watched {
 		# Watchman query just to get it over with now so we won't pay
 		# the cost in git to look up each individual file.
 		my $o = watchman_clock();
-		$error = $output->{error};
+		$error = $o->{error};
 
 		die "Watchman: $error.\n" .
 		"Falling back to scanning...\n" if $error;
 
 		output_result($o->{clock}, ("/"));
-		$last_update_token = $o->{clock};
-
-		eval { launch_watchman() };
 		return 0;
 	}
 

package/lib/bmad-cache/gds/_git_preserved/packed-refs

@@ -1,2 +1,2 @@
 # pack-refs with: peeled fully-peeled sorted 
-943bd180af9ad7204b9b11f582fbd31225aa8534 refs/remotes/origin/main
+46c3a6cddf882af1f918187d6e5748c1edfd9c52 refs/remotes/origin/main

package/lib/bmad-cache/gds/_git_preserved/refs/heads/main

@@ -1 +1 @@
-943bd180af9ad7204b9b11f582fbd31225aa8534
+46c3a6cddf882af1f918187d6e5748c1edfd9c52

package/lib/bmad-cache/gds/_git_preserved/shallow

@@ -1 +1 @@
-943bd180af9ad7204b9b11f582fbd31225aa8534
+46c3a6cddf882af1f918187d6e5748c1edfd9c52

package/lib/bmad-cache/gds/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "bmad-game-dev-studio",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "private": true,
   "description": "A BMad MEthod Core Module that offers a substantial stand alone module for Game Development across multiple supported platforms",
   "keywords": [

package/lib/bmad-cache/gds/src/agents/gds-agent-game-designer/customize.toml

@@ -45,8 +45,8 @@ skill = "gds-create-game-brief"
 
 [[agent.menu]]
 code = "GDD"
-description = "Create a Game Design Document"
-skill = "gds-create-gdd"
+description = "Create, update, or validate a Game Design Document"
+skill = "gds-gdd"
 
 [[agent.menu]]
 code = "ND"
@@ -54,6 +54,6 @@ description = "Design narrative elements and story"
 skill = "gds-create-narrative"
 
 [[agent.menu]]
-code = "QP"
-description = "Rapid game prototyping — test mechanics and ideas quickly"
-skill = "gds-quick-prototype"
+code = "CU"
+description = "Plan game UX, UI, HUD, and player journeys"
+skill = "gds-ux"

package/lib/bmad-cache/gds/src/agents/gds-agent-game-dev/customize.toml

@@ -58,11 +58,6 @@ code = "QD"
 description = "Clarify, plan, implement, review, and present any intent end-to-end"
 skill = "gds-quick-dev"
 
-[[agent.menu]]
-code = "QP"
-description = "Rapid game prototyping — test mechanics and ideas quickly"
-skill = "gds-quick-prototype"
-
 [[agent.menu]]
 code = "CS"
 description = "Create a story with full context for developer implementation"
@@ -123,6 +118,11 @@ code = "TR"
 description = "Review test quality and coverage"
 skill = "gds-test-review"
 
+[[agent.menu]]
+code = "IN"
+description = "Forensic case investigation — trace a bug, reconstruct an incident, or model unfamiliar code"
+skill = "gds-investigate"
+
 [[agent.menu]]
 code = "AE"
 description = "Advanced elicitation — challenge the LLM to get better results"

package/lib/bmad-cache/gds/src/agents/gds-agent-game-solo-dev/customize.toml

@@ -34,11 +34,6 @@ principles = [
   "The core loop must be fun before anything else matters.",
 ]
 
-[[agent.menu]]
-code = "QP"
-description = "Rapid prototype to test if the mechanic is fun — start here for new ideas"
-skill = "gds-quick-prototype"
-
 [[agent.menu]]
 code = "QD"
 description = "Clarify, plan, implement, review, and present any intent end-to-end"

package/lib/bmad-cache/gds/src/module-help.csv

@@ -1,22 +1,15 @@
-module,skill,display-name,menu-code,description,action,args,phase,after,before,required,output-location,outputs
+module,skill,display-name,menu-code,description,action,args,phase,preceded-by,followed-by,required,output-location,outputs
 Game Dev Studio,_meta,,,,,,,,,false,https://game-dev-studio-docs.bmad-method.org/llms.txt,
 Game Dev Studio,gds-document-project,Document Project,DP,Analyze an existing game project to produce useful documentation.,,,anytime,,,false,project_knowledge,project documentation
-Game Dev Studio,gds-quick-prototype,Quick Prototype,QP,Rapid game prototyping to test mechanics and ideas quickly.,,,anytime,,,false,,
 Game Dev Studio,gds-quick-dev,Quick Dev,QD,Clarify plan implement review and present any user intent or change request in a single workflow.,,,anytime,,,false,implementation_artifacts,spec
 Game Dev Studio,gds-correct-course,Correct Course,CC,Navigate significant changes during game dev sprint when implementation is off-track.,,,anytime,,,false,planning_artifacts,change proposal
 Game Dev Studio,gds-brainstorm-game,Brainstorm Game,BG,Facilitate game brainstorming sessions with game-specific context and techniques.,,,1-preproduction,,,false,output_folder,brainstorming session
-Game Dev Studio,gds-market-research,Market Research,MR,Game market analysis competitive landscape player needs and trends.,,,1-preproduction,,,false,planning_artifacts,research documents
 Game Dev Studio,gds-domain-research,Domain Research,DR,Game industry domain deep dive subject matter expertise and terminology.,,,1-preproduction,,,false,planning_artifacts,research documents
-Game Dev Studio,gds-technical-research,Technical Research,TR,Technical feasibility game engine options and implementation approaches.,,,1-preproduction,,,false,planning_artifacts,research documents
 Game Dev Studio,gds-create-game-brief,Game Brief,GB,Interactive game brief creation that guides users through defining their game vision.,,,1-preproduction,,,false,output_folder,game brief
-Game Dev Studio,gds-create-gdd,Game Design Document,GDD,Create a GDD with mechanics systems progression and implementation guidance.,,,2-design,,,false,planning_artifacts,gdd
-Game Dev Studio,gds-validate-gdd,Validate GDD,VG,Validate an existing GDD against standards. Delegates to gds-validate-prd until GDD-specific checks are authored.,,,2-design,gds-create-gdd,,false,planning_artifacts,gdd validation report
-Game Dev Studio,gds-edit-gdd,Edit GDD,EG,Improve and enhance an existing GDD. Delegates to gds-edit-prd until GDD-specific edit flow is authored.,,,2-design,gds-validate-gdd,,false,planning_artifacts,updated gdd
-Game Dev Studio,gds-create-narrative,Narrative Design,ND,Create comprehensive narrative documentation including story structure character arcs and world-building. Use for story-driven games.,,,2-design,gds-create-gdd,,false,planning_artifacts,narrative design
-Game Dev Studio,gds-create-ux-design,Create UX Design,CU,"Guidance through realizing the plan for your game UX/UI, strongly recommended if UI is a primary piece of the proposed game.",,,2-design,gds-create-gdd,,false,planning_artifacts,ux design
-Game Dev Studio,gds-create-prd,Create PRD,CP,Create a PRD from GDD or from scratch for use with external tools like bmad-assist.,,,2-design,gds-create-gdd,,false,planning_artifacts,prd
-Game Dev Studio,gds-validate-prd,Validate PRD,VP,Validate PRD against standards for external tool compatibility.,,,2-design,gds-create-prd,,false,planning_artifacts,prd validation report
-Game Dev Studio,gds-edit-prd,Edit PRD,EP,Improve and enhance an existing PRD.,,,2-design,gds-validate-prd,,false,planning_artifacts,updated prd
+Game Dev Studio,gds-gdd,Game Design Document,GDD,"Create, update, or validate a game's GDD — the primary design artifact covering pillars, mechanics, progression, levels, art, audio, and development epics.",,,2-design,,,false,planning_artifacts,gdd
+Game Dev Studio,gds-create-narrative,Narrative Design,ND,Create comprehensive narrative documentation including story structure character arcs and world-building. Use for story-driven games.,,,2-design,gds-gdd,,false,planning_artifacts,narrative design
+Game Dev Studio,gds-ux,Game UX Design,CU,"Plan game UX with DESIGN.md and EXPERIENCE.md spines covering UI, HUD, input schemes, and player journeys.",,,2-design,gds-gdd,,false,planning_artifacts,ux design
+Game Dev Studio,gds-prd,Game PRD,PRD,"Create, update, or validate a game project's PRD — often derived from a GDD or prepared for external-tool integration.",,,2-design,gds-gdd,,false,planning_artifacts,prd
 Game Dev Studio,gds-generate-project-context,Project Context,PC,Create optimized project-context.md for chosen agentic tool consistency.,,,3-technical,,,false,,
 Game Dev Studio,gds-game-architecture,Game Architecture,GA,Produce a scale-adaptive game architecture with engine systems networking and technical design.,,,3-technical,,,true,planning_artifacts,game architecture
 Game Dev Studio,gds-create-epics-and-stories,Create Epics and Stories,CE,Create the Epics and Stories listing from GDD requirements. These are the specs that drive development.,,,3-technical,gds-game-architecture,,true,planning_artifacts,epics and stories
@@ -29,6 +22,7 @@ Game Dev Studio,gds-create-story,Create Story,CS,Create Story with comprehensive
 Game Dev Studio,gds-dev-story,Dev Story,DS,Execute Dev Story workflow implementing tasks and tests.,,,4-production,gds-create-story,,true,,
 Game Dev Studio,gds-code-review,Code Review,CR,Perform thorough clean context QA code review on stories flagged Ready for Review.,,,4-production,gds-dev-story,,false,,
 Game Dev Studio,gds-retrospective,Retrospective,ER,Facilitate team retrospective after a game development epic is completed.,,,4-production,gds-code-review,,false,implementation_artifacts,retrospective
+Game Dev Studio,gds-investigate,Investigate,IN,"Forensic case investigation with evidence-graded findings — trace a bug, reconstruct an incident, or model unfamiliar code.",,,4-production,,,false,implementation_artifacts,investigation case file
 Game Dev Studio,gds-test-automate,Test Automate,TA,Generate automated game tests.,,,gametest,,,false,,
 Game Dev Studio,gds-e2e-scaffold,E2E Scaffold,ES,Scaffold E2E testing infrastructure.,,,gametest,gds-test-automate,,false,,
 Game Dev Studio,gds-playtest-plan,Playtest Plan,PP,Create structured playtesting plan.,,,gametest,gds-e2e-scaffold,,false,planning_artifacts,playtest plan

package/lib/bmad-cache/gds/src/module.yaml

@@ -3,7 +3,7 @@ name: "BMGD: BMad Game Dev Studio"
 header: "BMad Game Development Studio Module"
 subheader: ""
 default_selected: false
-module_version: 0.3.0
+module_version: 0.6.0
 
 # Variables from Core Config inserted:
 ## user_name

package/lib/bmad-cache/gds/src/workflows/1-preproduction/gds-create-game-brief/customize.toml

@@ -1,41 +1,116 @@
 # DO NOT EDIT -- overwritten on every update.
 #
-# Workflow customization surface for gds-create-game-brief. Mirrors the
-# agent customization shape under the [workflow] namespace.
+# Workflow customization surface for gds-create-game-brief.
+#
+# Override files (not edited here):
+#   {project-root}/_bmad/custom/gds-create-game-brief.toml         (team)
+#   {project-root}/_bmad/custom/gds-create-game-brief.user.toml    (personal)
 
 [workflow]
 
 # --- Configurable below. Overrides merge per BMad structural rules: ---
-#   scalars: override wins • arrays (persistent_facts, activation_steps_*): append
-#   arrays-of-tables with `code`/`id`: replace matching items, append new ones.
+#   scalars: override wins • arrays: append
 
 # Steps to run before the standard activation (config load, greet).
-# Overrides append. Use for pre-flight loads, compliance checks, etc.
-
+# Use for pre-flight loads, compliance checks, etc.
 activation_steps_prepend = []
 
 # Steps to run after greet but before the workflow begins.
-# Overrides append. Use for context-heavy setup that should happen
-# once the user has been acknowledged.
-
+# 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).
-# Distinct from the runtime memory sidecar — these are static context
-# loaded on activation. Overrides append.
+# (studio standards, platform 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. Empty by default.
 #
-# Each entry is either:
-#   - a literal sentence, e.g. "Game briefs must anchor on a single core fantasy players can describe in one sentence."
-#   - a file reference prefixed with `file:`, e.g. "file:{project-root}/docs/standards.md"
-#     (glob patterns are supported; the file's contents are loaded and treated as facts).
+# Common opt-ins (set in team/user override TOML):
+#   "file:{project-root}/**/project-context.md"                   # load project context if gds-generate-project-context produced one
+#   "skill:acme-studio:brand-and-rating-guidelines"              # a skill that contains studio info
+#   "Every game brief must anchor on a single core fantasy players can describe in one sentence."
+persistent_facts = []
+
+# Executed when the workflow completes (after the user has been told the
+# brief is ready). Accepts either a string scalar (single instruction)
+# or an array of instructions executed in order. Empty for none.
+on_complete = ""
+
+# Default game-brief structure. Treated as a starting point — the LLM adapts it
+# to the game, purpose, and genre. Override the path in team/user TOML to enforce
+# a different structure (e.g. live-service, narrative-heavy, mobile-F2P).
+brief_template = "assets/brief-template.md"
 
-persistent_facts = [
-  "file:{project-root}/**/project-context.md",
+# Run folder location. The brief and optional addendum land inside
+# `{brief_output_path}/{run_folder_pattern}/`. Resume-check scans
+# `{brief_output_path}` for prior unfinished runs.
+brief_output_path = "{planning_artifacts}/briefs"
+run_folder_pattern = "brief-{project_name}-{date}"
+
+# Polish passes applied to human-consumed docs at finalize. Each entry is a
+# `skill:`, `file:`, or plain-text directive run as a parallel subagent against
+# the draft; findings are applied before the user sees it. Encodes standards,
+# not options.
+#
+# Examples:
+#   "skill:bmad-editorial-review-prose"
+#   "file:{project-root}/_bmad/style-guides/studio-voice.md"
+#   "Convert all dates to ISO 8601 format."
+#
+# Suggested order (broader passes first, narrower last):
+#   1. Structural (cuts, reorganization, section sizing)
+#   2. Content/voice/conventions (studio standards, tone, terminology, rating)
+#   3. Prose mechanics (grammar, clarity, typos)
+#
+# Override the array in team/user TOML to add additional standards. Append-only:
+# base entries cannot be removed or replaced (resolver has no removal mechanism).
+polish_passes = [
+  "skill:bmad-editorial-review-structure",
+  "skill:bmad-editorial-review-prose",
 ]
 
-# Scalar: executed when the workflow reaches Step 8 (Success & Handoff),
-# after the final outputs are produced. Override wins.
-# Leave empty for no custom post-completion behavior.
+# Reviewer panel applied at finalize, after polish_passes. Each entry is a
+# `skill:`, `file:`, or plain-text directive run as a parallel subagent that
+# critiques the draft and returns findings (it does not silently rewrite).
+# Prefix an entry with `required:` to make it a hard gate — the workflow will
+# not present the brief as final until that reviewer passes or the user waives
+# it. `finalize_reviewers` is an alias surface for the same gate. Empty by default.
+#
+# Examples (set in team/user override TOML):
+#   "skill:acme-studio:greenlight-review"
+#   "required:Confirm the core fantasy is stated in a single sentence and the MVP is truly minimal."
+#   "When the brief targets a rated platform, cross-check content against corp:rating_reference."
+reviewers = []
+finalize_reviewers = []
 
-on_complete = ""
+# Name or directive of the single reviewer treated as the required gate when
+# not expressed inline via a `required:` prefix above. Empty by default.
+required_reviewer = ""
+
+# 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 (during Discovery, validation, drafting, etc.). Each
+# entry names the tool, the conditions for using it, and any fields it needs.
+# If a named MCP tool is unavailable at runtime, the LLM falls back to standard
+# behavior and notes the gap. Empty by default.
+#
+# Examples (set in team/user override TOML):
+#   "When researching genre context, consult corp:kb_search (database='game-design-docs') before web search."
+#   "For player-sentiment signal during Discovery, query corp:wishlist_search with project={project_name}."
+#   "When validating platform-rating claims, cross-check against corp:rating_reference."
+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.). Each entry names the MCP tool, the destination,
+# and the fields it needs. 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. If a named tool is unavailable at
+# runtime, the handoff is skipped and flagged in the JSON status; local files
+# always exist regardless. Fires automatically — users can opt out in their
+# prompt for a specific run. Empty by default.
+#
+# Examples (set in team/user override TOML):
+#   "After finalize, upload brief.md and addendum.md to Confluence via corp:confluence_upload (space_key='GAME', parent_page='Game Briefs', label='brief', author={user_name})."
+#   "Post a ready-for-review ping to Slack via corp:slack_post (channel='#game-design', text='New game brief: '+{confluence_url})."
+external_handoffs = []

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

@@ -0,0 +1,190 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<title>GDD 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 — GDD 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>