From 52959f064a1add6f907393c9442d83ca5ff43d04 Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 16 Aug 2026 10:06:47 -0500 Subject: [PATCH 1/2] chore: default persistent_facts to an empty array Every customize.toml shipped with a skill seeded persistent_facts with file:{project-root}/**/project-context.md. That made project-context an opt-out default rather than an opt-in customization. Ship the arrays empty so nothing is loaded unless the user adds it. --- src/agents/gds-agent-game-architect/customize.toml | 4 +--- src/agents/gds-agent-game-designer/customize.toml | 4 +--- src/agents/gds-agent-game-dev/customize.toml | 4 +--- src/agents/gds-agent-game-solo-dev/customize.toml | 4 +--- src/agents/gds-agent-tech-writer/customize.toml | 5 +---- .../1-preproduction/gds-brainstorm-game/customize.toml | 4 +--- .../research/gds-domain-research/customize.toml | 4 +--- src/workflows/2-design/gds-create-narrative/customize.toml | 4 +--- src/workflows/2-design/gds-gdd/customize.toml | 4 +--- src/workflows/2-design/gds-prd/customize.toml | 4 +--- src/workflows/2-design/gds-ux/customize.toml | 4 +--- .../gds-check-implementation-readiness/customize.toml | 4 +--- .../3-technical/gds-create-epics-and-stories/customize.toml | 4 +--- .../3-technical/gds-game-architecture/customize.toml | 4 +--- .../3-technical/gds-generate-project-context/customize.toml | 4 +--- src/workflows/4-production/gds-code-review/customize.toml | 4 +--- src/workflows/4-production/gds-correct-course/customize.toml | 4 +--- src/workflows/4-production/gds-create-story/customize.toml | 4 +--- src/workflows/4-production/gds-dev-story/customize.toml | 4 +--- src/workflows/4-production/gds-investigate/customize.toml | 4 +--- src/workflows/4-production/gds-retrospective/customize.toml | 4 +--- .../4-production/gds-sprint-planning/customize.toml | 4 +--- src/workflows/4-production/gds-sprint-status/customize.toml | 4 +--- src/workflows/gametest/gds-e2e-scaffold/customize.toml | 4 +--- src/workflows/gametest/gds-performance-test/customize.toml | 4 +--- src/workflows/gametest/gds-playtest-plan/customize.toml | 4 +--- src/workflows/gametest/gds-test-automate/customize.toml | 4 +--- src/workflows/gametest/gds-test-design/customize.toml | 4 +--- src/workflows/gametest/gds-test-framework/customize.toml | 4 +--- src/workflows/gametest/gds-test-review/customize.toml | 4 +--- src/workflows/gds-document-project/customize.toml | 4 +--- src/workflows/gds-quick-flow/gds-quick-dev/customize.toml | 4 +--- 32 files changed, 32 insertions(+), 97 deletions(-) diff --git a/src/agents/gds-agent-game-architect/customize.toml b/src/agents/gds-agent-game-architect/customize.toml index 870438f..dba2489 100644 --- a/src/agents/gds-agent-game-architect/customize.toml +++ b/src/agents/gds-agent-game-architect/customize.toml @@ -18,9 +18,7 @@ icon = "🏛ī¸" activation_steps_prepend = [] activation_steps_append = [] -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] role = "Design scalable game architectures, engine systems, and multiplayer infrastructure that keep the implementation phase honest." identity = "Twenty years shipping 30+ titles across distributed systems, engine design, multiplayer architecture, and technical leadership — channels John Carmack's engine-architect pragmatism and Tim Sweeney's systems-level long view, lived with every bad decision long enough to name it." diff --git a/src/agents/gds-agent-game-designer/customize.toml b/src/agents/gds-agent-game-designer/customize.toml index ffda0a4..01a2d53 100644 --- a/src/agents/gds-agent-game-designer/customize.toml +++ b/src/agents/gds-agent-game-designer/customize.toml @@ -18,9 +18,7 @@ icon = "🎲" activation_steps_prepend = [] activation_steps_append = [] -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] role = "Drive creative vision, game design documents, and narrative design so every mechanic earns its place in the core fantasy." identity = "Fifteen years crafting AAA and indie hits — channels Shigeru Miyamoto's obsession with player-feel and Sid Meier's 'series of interesting decisions' philosophy, fluent in mechanics, player psychology, narrative design, and systemic thinking." diff --git a/src/agents/gds-agent-game-dev/customize.toml b/src/agents/gds-agent-game-dev/customize.toml index e991c24..8282c69 100644 --- a/src/agents/gds-agent-game-dev/customize.toml +++ b/src/agents/gds-agent-game-dev/customize.toml @@ -22,9 +22,7 @@ icon = "🕹ī¸" activation_steps_prepend = [] activation_steps_append = [] -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] role = "Implement features, execute dev stories, perform code reviews, author tests and QA automation, and orchestrate sprints during the implementation phase." identity = "Ten-year dev fluent in Unity, Unreal, and custom engines — channels Casey Muratori's hands-on engine craftsmanship and Naoki Yoshida's ruthless-shipping discipline, has shipped across mobile, console, and PC with clean, performant code and the tests that prove it. Runs sprints like a solo speedrun: relentlessly tracked, ruthlessly scoped." diff --git a/src/agents/gds-agent-game-solo-dev/customize.toml b/src/agents/gds-agent-game-solo-dev/customize.toml index 3d89c9f..db4bdd6 100644 --- a/src/agents/gds-agent-game-solo-dev/customize.toml +++ b/src/agents/gds-agent-game-solo-dev/customize.toml @@ -18,9 +18,7 @@ icon = "🎮" activation_steps_prepend = [] activation_steps_append = [] -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] role = "Ship complete games from concept to launch using the Quick Flow workflow — prototype fast, iterate faster, ship before the hype dies." identity = "Battle-hardened solo dev fluent in Unity, Unreal, and Godot — channels Eric Barone's years-long Stardew Valley solo grind and Edmund McMillen's ship-it-and-iterate indie hustle, has shipped titles across mobile, PC, and console with no team politics and no endless meetings." diff --git a/src/agents/gds-agent-tech-writer/customize.toml b/src/agents/gds-agent-tech-writer/customize.toml index d1a84fb..41675b7 100644 --- a/src/agents/gds-agent-tech-writer/customize.toml +++ b/src/agents/gds-agent-tech-writer/customize.toml @@ -18,10 +18,7 @@ icon = "📚" activation_steps_prepend = [] activation_steps_append = [] -persistent_facts = [ - "file:{project-root}/**/project-context.md", - "file:{skill-root}/documentation-standards.md", -] +persistent_facts = [] role = "Capture and curate game project knowledge so designers, engineers, and future LLM agents stay in sync." identity = "Expert in CommonMark, DITA, OpenAPI, and Mermaid — writes with Julia Evans's accessibility and Edward Tufte's visual precision." diff --git a/src/workflows/1-preproduction/gds-brainstorm-game/customize.toml b/src/workflows/1-preproduction/gds-brainstorm-game/customize.toml index 39e1fce..aa09ec9 100644 --- a/src/workflows/1-preproduction/gds-brainstorm-game/customize.toml +++ b/src/workflows/1-preproduction/gds-brainstorm-game/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 4 (Complete Session), # after the final outputs are produced. Override wins. diff --git a/src/workflows/1-preproduction/research/gds-domain-research/customize.toml b/src/workflows/1-preproduction/research/gds-domain-research/customize.toml index 81aefc0..03c51af 100644 --- a/src/workflows/1-preproduction/research/gds-domain-research/customize.toml +++ b/src/workflows/1-preproduction/research/gds-domain-research/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 6, # after the final outputs are produced. Override wins. diff --git a/src/workflows/2-design/gds-create-narrative/customize.toml b/src/workflows/2-design/gds-create-narrative/customize.toml index 3207438..106901e 100644 --- a/src/workflows/2-design/gds-create-narrative/customize.toml +++ b/src/workflows/2-design/gds-create-narrative/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 11 (Complete), # after the final outputs are produced. Override wins. diff --git a/src/workflows/2-design/gds-gdd/customize.toml b/src/workflows/2-design/gds-gdd/customize.toml index 982a5ac..917439b 100644 --- a/src/workflows/2-design/gds-gdd/customize.toml +++ b/src/workflows/2-design/gds-gdd/customize.toml @@ -29,9 +29,7 @@ activation_steps_append = [] # 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", -] +persistent_facts = [] # Executed when the workflow completes (after the user has been told the # GDD is ready). Accepts either a string scalar (single instruction) diff --git a/src/workflows/2-design/gds-prd/customize.toml b/src/workflows/2-design/gds-prd/customize.toml index 40029b0..f55e3b2 100644 --- a/src/workflows/2-design/gds-prd/customize.toml +++ b/src/workflows/2-design/gds-prd/customize.toml @@ -29,9 +29,7 @@ activation_steps_append = [] # 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", -] +persistent_facts = [] # Executed when the workflow completes (after the user has been told the # PRD is ready). Accepts either a string scalar (single instruction) diff --git a/src/workflows/2-design/gds-ux/customize.toml b/src/workflows/2-design/gds-ux/customize.toml index 0b12dc3..0db8f47 100644 --- a/src/workflows/2-design/gds-ux/customize.toml +++ b/src/workflows/2-design/gds-ux/customize.toml @@ -14,9 +14,7 @@ activation_steps_append = [] # Persistent facts loaded at activation and kept in mind for the run. # Entries: literal sentence, `skill:NAME`, or `file:PATH` (glob ok). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Runs at workflow completion. String or array of instructions. on_complete = "" diff --git a/src/workflows/3-technical/gds-check-implementation-readiness/customize.toml b/src/workflows/3-technical/gds-check-implementation-readiness/customize.toml index bb16b3a..8fffcc5 100644 --- a/src/workflows/3-technical/gds-check-implementation-readiness/customize.toml +++ b/src/workflows/3-technical/gds-check-implementation-readiness/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 6 (Final Assessment), # after the final outputs are produced. Override wins. diff --git a/src/workflows/3-technical/gds-create-epics-and-stories/customize.toml b/src/workflows/3-technical/gds-create-epics-and-stories/customize.toml index d403d29..5d6b3eb 100644 --- a/src/workflows/3-technical/gds-create-epics-and-stories/customize.toml +++ b/src/workflows/3-technical/gds-create-epics-and-stories/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 4 (Final Validation), # after the final outputs are produced. Override wins. diff --git a/src/workflows/3-technical/gds-game-architecture/customize.toml b/src/workflows/3-technical/gds-game-architecture/customize.toml index 0e7aac7..4ad6336 100644 --- a/src/workflows/3-technical/gds-game-architecture/customize.toml +++ b/src/workflows/3-technical/gds-game-architecture/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 9 (Completion), # after the final outputs are produced. Override wins. diff --git a/src/workflows/3-technical/gds-generate-project-context/customize.toml b/src/workflows/3-technical/gds-generate-project-context/customize.toml index 2f6b462..359b4f3 100644 --- a/src/workflows/3-technical/gds-generate-project-context/customize.toml +++ b/src/workflows/3-technical/gds-generate-project-context/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 3 (Context Completion & Finalization), # after the final outputs are produced. Override wins. diff --git a/src/workflows/4-production/gds-code-review/customize.toml b/src/workflows/4-production/gds-code-review/customize.toml index 6aba24d..d3b5d03 100644 --- a/src/workflows/4-production/gds-code-review/customize.toml +++ b/src/workflows/4-production/gds-code-review/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 4 (Present and Act), # after the final outputs are produced. Override wins. diff --git a/src/workflows/4-production/gds-correct-course/customize.toml b/src/workflows/4-production/gds-correct-course/customize.toml index da6c83e..3314f71 100644 --- a/src/workflows/4-production/gds-correct-course/customize.toml +++ b/src/workflows/4-production/gds-correct-course/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 6 (Workflow Completion), # after the Sprint Change Proposal is routed and handoff is confirmed. Override wins. diff --git a/src/workflows/4-production/gds-create-story/customize.toml b/src/workflows/4-production/gds-create-story/customize.toml index 2b1b3c8..d2e0f95 100644 --- a/src/workflows/4-production/gds-create-story/customize.toml +++ b/src/workflows/4-production/gds-create-story/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 6 (Update sprint status and finalize), # after the final outputs are produced. Override wins. diff --git a/src/workflows/4-production/gds-dev-story/customize.toml b/src/workflows/4-production/gds-dev-story/customize.toml index d20fb57..71ac9c5 100644 --- a/src/workflows/4-production/gds-dev-story/customize.toml +++ b/src/workflows/4-production/gds-dev-story/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 10 (Completion communication and user support), # after the final outputs are produced. Override wins. diff --git a/src/workflows/4-production/gds-investigate/customize.toml b/src/workflows/4-production/gds-investigate/customize.toml index 744a6cf..7101bb9 100644 --- a/src/workflows/4-production/gds-investigate/customize.toml +++ b/src/workflows/4-production/gds-investigate/customize.toml @@ -33,9 +33,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: path to the case-file template, resolved from the skill root. # Override to point at an org-shaped template (compliance sections, diff --git a/src/workflows/4-production/gds-retrospective/customize.toml b/src/workflows/4-production/gds-retrospective/customize.toml index 0b2ce89..d887753 100644 --- a/src/workflows/4-production/gds-retrospective/customize.toml +++ b/src/workflows/4-production/gds-retrospective/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 12 (Final Summary and Handoff), # after the final outputs are produced. Override wins. diff --git a/src/workflows/4-production/gds-sprint-planning/customize.toml b/src/workflows/4-production/gds-sprint-planning/customize.toml index 8e29a45..3a42e6b 100644 --- a/src/workflows/4-production/gds-sprint-planning/customize.toml +++ b/src/workflows/4-production/gds-sprint-planning/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 5 (Validate and report), # after the final outputs are produced. Override wins. diff --git a/src/workflows/4-production/gds-sprint-status/customize.toml b/src/workflows/4-production/gds-sprint-status/customize.toml index 8c5d136..4f56fa9 100644 --- a/src/workflows/4-production/gds-sprint-status/customize.toml +++ b/src/workflows/4-production/gds-sprint-status/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 30 (Validate sprint-status file), # after the final outputs are produced. Override wins. diff --git a/src/workflows/gametest/gds-e2e-scaffold/customize.toml b/src/workflows/gametest/gds-e2e-scaffold/customize.toml index fb7e94c..0d0b348 100644 --- a/src/workflows/gametest/gds-e2e-scaffold/customize.toml +++ b/src/workflows/gametest/gds-e2e-scaffold/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 5 (Output Summary), # after the final outputs are produced. Override wins. diff --git a/src/workflows/gametest/gds-performance-test/customize.toml b/src/workflows/gametest/gds-performance-test/customize.toml index bb31611..5a84f4b 100644 --- a/src/workflows/gametest/gds-performance-test/customize.toml +++ b/src/workflows/gametest/gds-performance-test/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 6 (Generate Performance Test Plan), # after the final outputs are produced. Override wins. diff --git a/src/workflows/gametest/gds-playtest-plan/customize.toml b/src/workflows/gametest/gds-playtest-plan/customize.toml index 4885eeb..9bf7fd6 100644 --- a/src/workflows/gametest/gds-playtest-plan/customize.toml +++ b/src/workflows/gametest/gds-playtest-plan/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed at the end of the workflow — after the final # deliverables, output summary, and validation references are produced. Override wins. diff --git a/src/workflows/gametest/gds-test-automate/customize.toml b/src/workflows/gametest/gds-test-automate/customize.toml index 23fde1f..2db6a3f 100644 --- a/src/workflows/gametest/gds-test-automate/customize.toml +++ b/src/workflows/gametest/gds-test-automate/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 5 (Generate Test Report), # after the final outputs are produced. Override wins. diff --git a/src/workflows/gametest/gds-test-design/customize.toml b/src/workflows/gametest/gds-test-design/customize.toml index 70b38e8..c1daba2 100644 --- a/src/workflows/gametest/gds-test-design/customize.toml +++ b/src/workflows/gametest/gds-test-design/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed at the end of the workflow — after the final # deliverables, output summary, and validation references are produced. Override wins. diff --git a/src/workflows/gametest/gds-test-framework/customize.toml b/src/workflows/gametest/gds-test-framework/customize.toml index 1759e22..f9e1ad0 100644 --- a/src/workflows/gametest/gds-test-framework/customize.toml +++ b/src/workflows/gametest/gds-test-framework/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed at the end of the workflow — after the final # deliverables, output summary, and validation references are produced. Override wins. diff --git a/src/workflows/gametest/gds-test-review/customize.toml b/src/workflows/gametest/gds-test-review/customize.toml index d18ef57..eba918b 100644 --- a/src/workflows/gametest/gds-test-review/customize.toml +++ b/src/workflows/gametest/gds-test-review/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed at the end of the workflow — after the final # deliverables, output summary, and validation references are produced. Override wins. diff --git a/src/workflows/gds-document-project/customize.toml b/src/workflows/gds-document-project/customize.toml index 5e5a290..59e3e16 100644 --- a/src/workflows/gds-document-project/customize.toml +++ b/src/workflows/gds-document-project/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches Step 4 (Update status and complete), # after the final outputs are produced. Override wins. diff --git a/src/workflows/gds-quick-flow/gds-quick-dev/customize.toml b/src/workflows/gds-quick-flow/gds-quick-dev/customize.toml index 1fa64db..08194e7 100644 --- a/src/workflows/gds-quick-flow/gds-quick-dev/customize.toml +++ b/src/workflows/gds-quick-flow/gds-quick-dev/customize.toml @@ -30,9 +30,7 @@ activation_steps_append = [] # - 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). -persistent_facts = [ - "file:{project-root}/**/project-context.md", -] +persistent_facts = [] # Scalar: executed when the workflow reaches step-05-present.md (final present/review # step), after the artifact is produced and reviewed. Override wins. From ad9462617510f9cefd9beb2ac5c37564c8fc454c Mon Sep 17 00:00:00 2001 From: Brian Madison Date: Sun, 16 Aug 2026 10:35:36 -0500 Subject: [PATCH 2/2] docs: correct the persistent_facts default in comments and docs MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Comments and docs still described project-context.md as loading by default. They were wrong twice over: the array now ships empty, and bmad-project-context no longer produces a project-context.md at all — it writes a verified block into AGENTS.md and treats project-context.md as a legacy artifact. Replace those claims with the actual model: repo-wide context belongs in AGENTS.md, which every skill already sees; persistent_facts carries context only one skill needs, loaded on demand instead of as constant memory. Each site shows the file: entry users can add to opt back in. --- docs/how-to/setup-godot.md | 2 +- docs/how-to/setup-unity.md | 2 +- docs/how-to/setup-unreal.md | 2 +- docs/reference/agents.md | 8 +++++--- src/workflows/2-design/gds-gdd/customize.toml | 7 ++++--- src/workflows/2-design/gds-prd/customize.toml | 7 ++++--- .../steps/step-03-complete.md | 2 +- 7 files changed, 17 insertions(+), 13 deletions(-) diff --git a/docs/how-to/setup-godot.md b/docs/how-to/setup-godot.md index b1957e4..2e7ac4e 100644 --- a/docs/how-to/setup-godot.md +++ b/docs/how-to/setup-godot.md @@ -229,7 +229,7 @@ This sets up GUT (Godot Unit Test) with: ## Tips -> **Best Practice:** Always run `bmgd-generate-project-context` after creating a new Godot project. The `project-context.md` file is the "single source of truth" that all BMGD agents reference. +> **Best Practice:** Always run `gds-generate-project-context` after creating a new Godot project. The `project-context.md` file is the "single source of truth" for project decisions, and the production workflows read it automatically. The conversational agents pick it up only if you add it to their `persistent_facts`. > **Avoid:** Don't create deeply nested scene trees. Godot's scene system encourages composition — prefer many small scenes over one large scene. diff --git a/docs/how-to/setup-unity.md b/docs/how-to/setup-unity.md index f1c0ecf..46a57f1 100644 --- a/docs/how-to/setup-unity.md +++ b/docs/how-to/setup-unity.md @@ -222,7 +222,7 @@ This sets up Unity Test Framework with: ## Tips -> **Best Practice:** Always run `bmgd-generate-project-context` after creating a new Unity project. The `project-context.md` file is the "single source of truth" that all BMGD agents reference. +> **Best Practice:** Always run `gds-generate-project-context` after creating a new Unity project. The `project-context.md` file is the "single source of truth" for project decisions, and the production workflows read it automatically. The conversational agents pick it up only if you add it to their `persistent_facts`. > **Avoid:** Don't manually organize your Assets folder before running `bmgd-create-architecture`. Let the Game Architect define the structure first, then follow it consistently. diff --git a/docs/how-to/setup-unreal.md b/docs/how-to/setup-unreal.md index 9c20b80..896b248 100644 --- a/docs/how-to/setup-unreal.md +++ b/docs/how-to/setup-unreal.md @@ -230,7 +230,7 @@ This sets up Unreal Automation System with: ## Tips -> **Best Practice:** Always run `bmgd-generate-project-context` after creating a new Unreal project. The `project-context.md` file is the "single source of truth" that all BMGD agents reference. +> **Best Practice:** Always run `gds-generate-project-context` after creating a new Unreal project. The `project-context.md` file is the "single source of truth" for project decisions, and the production workflows read it automatically. The conversational agents pick it up only if you add it to their `persistent_facts`. > **Avoid:** Don't start with the First Person template if you're making a third-person game. Choose the template closest to your final game — the Game Architect can advise if unsure. diff --git a/docs/reference/agents.md b/docs/reference/agents.md index 6add116..06b7c31 100644 --- a/docs/reference/agents.md +++ b/docs/reference/agents.md @@ -302,11 +302,13 @@ Game Developer integrates testing at multiple points within Phase 4: ## Project Context -All agents share the principle: +Production workflows such as `gds-create-story`, `gds-dev-story`, and `gds-code-review` load `**/project-context.md` directly if it exists, and treat it as the source of truth for project decisions and constraints. -> "Find if this exists, and if it does, always treat it as the source of truth for planning and execution: `**/project-context.md`" +The conversational agents do not. They pick up standing context only through `persistent_facts` in their `customize.toml`, which ships empty. Put studio-wide rules in `AGENTS.md` so every agent sees them, or add an explicit entry to opt a single agent in: -The `project-context.md` file (if present) serves as the authoritative source for project decisions and constraints. +```toml +persistent_facts = ["file:{project-root}/**/project-context.md"] +``` ## Next Steps diff --git a/src/workflows/2-design/gds-gdd/customize.toml b/src/workflows/2-design/gds-gdd/customize.toml index 917439b..7a3e4a7 100644 --- a/src/workflows/2-design/gds-gdd/customize.toml +++ b/src/workflows/2-design/gds-gdd/customize.toml @@ -24,9 +24,10 @@ activation_steps_append = [] # 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): +# Empty by default. Studio-wide context belongs in AGENTS.md, which every skill already sees; use +# this for context only this workflow needs, loaded on demand rather than carried as constant +# memory. Common opt-ins (set in team/user override TOML): +# "file:{project-root}/**/project-context.md" # if you keep a project-context.md # "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 = [] diff --git a/src/workflows/2-design/gds-prd/customize.toml b/src/workflows/2-design/gds-prd/customize.toml index f55e3b2..430788a 100644 --- a/src/workflows/2-design/gds-prd/customize.toml +++ b/src/workflows/2-design/gds-prd/customize.toml @@ -24,9 +24,10 @@ activation_steps_append = [] # 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): +# Empty by default. Studio-wide context belongs in AGENTS.md, which every skill already sees; use +# this for context only this workflow needs, loaded on demand rather than carried as constant +# memory. Common opt-ins (set in team/user override TOML): +# "file:{project-root}/**/project-context.md" # if you keep a project-context.md # "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 = [] diff --git a/src/workflows/3-technical/gds-generate-project-context/steps/step-03-complete.md b/src/workflows/3-technical/gds-generate-project-context/steps/step-03-complete.md index e3e619a..7cfd6b9 100644 --- a/src/workflows/3-technical/gds-generate-project-context/steps/step-03-complete.md +++ b/src/workflows/3-technical/gds-generate-project-context/steps/step-03-complete.md @@ -248,7 +248,7 @@ Your optimized project context file is ready at: **Next Steps:** -1. AI agents will automatically read this file when implementing +1. Production workflows (create-story, dev-story, code-review) read this file automatically when implementing. The conversational agents do not — add `"file:{project-root}/**/project-context.md"` to an agent's `persistent_facts` to opt it in 2. Update this file when your technology stack or patterns evolve 3. Review quarterly to optimize and remove outdated rules