chore: default persistent_facts to an empty array

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.
 

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.
 

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.
 

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
 

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."

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."

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."

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."

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."

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.

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.

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.

src/workflows/2-design/gds-gdd/customize.toml

@@ -24,14 +24,13 @@ 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 = [
-  "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)

src/workflows/2-design/gds-prd/customize.toml

@@ -24,14 +24,13 @@ 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 = [
-  "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)

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 = ""

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.

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.

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.

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.

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
 

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.

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.

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.

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.

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,

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.

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.

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.

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.

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.

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.

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.

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.

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.