From 77bd3234c6a97d68be7166b6907db440712baeb4 Mon Sep 17 00:00:00 2001 From: "Mr. Q" <97194984+ToolboxAid@users.noreply.github.com> Date: Sun, 21 Jun 2026 23:37:33 -0400 Subject: [PATCH] OWNER: add batch governance mode and PI hygiene standards --- docs_build/dev/ProjectInstructions/README.txt | 14 ++++++ .../addendums/batch_governance_mode.md | 30 +++++++++++++ .../addendums/postgres_only.md | 11 +++++ .../addendums/referenced_asset_protection.md | 23 ++++++++++ .../addendums/table_first_ui.md | 17 +++++++ .../addendums/tool_imagery.md | 22 ++++++++++ .../team_assignments/team_ownership.md | 44 +++++++++++++++++++ 7 files changed, 161 insertions(+) create mode 100644 docs_build/dev/ProjectInstructions/addendums/batch_governance_mode.md create mode 100644 docs_build/dev/ProjectInstructions/addendums/postgres_only.md create mode 100644 docs_build/dev/ProjectInstructions/addendums/referenced_asset_protection.md create mode 100644 docs_build/dev/ProjectInstructions/addendums/table_first_ui.md create mode 100644 docs_build/dev/ProjectInstructions/addendums/tool_imagery.md create mode 100644 docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md diff --git a/docs_build/dev/ProjectInstructions/README.txt b/docs_build/dev/ProjectInstructions/README.txt index 27495ad8f..77de19c20 100644 --- a/docs_build/dev/ProjectInstructions/README.txt +++ b/docs_build/dev/ProjectInstructions/README.txt @@ -26,3 +26,17 @@ When a governance or instruction state needs a history snapshot, add a new file CCYYMMDD_HHMMSS.md Do not rewrite history snapshots after creation unless the owner explicitly approves. + +READ THIS FIRST + +1. Read Project Instructions before making changes. +2. Project Instructions are append-only. +3. Existing approved guidance may not be removed. +4. Team ownership must be respected. +5. BACKLOG_MASTER.md is the authoritative backlog. +6. Build Path status derives from backlog status. +7. Direct-to-main commits are prohibited. +8. Use approved PR workflow. +9. Follow OWNER governance decisions. +10. When guidance conflicts, newest OWNER-approved guidance wins. +11. Batch Governance Mode is the default for governance, documentation, and administrative work. diff --git a/docs_build/dev/ProjectInstructions/addendums/batch_governance_mode.md b/docs_build/dev/ProjectInstructions/addendums/batch_governance_mode.md new file mode 100644 index 000000000..9dc557f8a --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/batch_governance_mode.md @@ -0,0 +1,30 @@ +# All-Teams Governance Rule: Batch Governance Mode + +Status: Approved +Owner: OWNER +Applies To: All teams + +## Purpose + +Increase throughput, reduce governance overhead, reduce review churn, and allow teams to spend more time building. + +## Rules + +1. Prefer workstream PRs for related governance, documentation, and administrative changes. +2. Avoid one-document-per-PR unless risk, dependency order, or OWNER direction requires it. +3. Review by workstream, not by individual file. +4. Minimize approval cycles. +5. Use stacked sequential PRs only when dependency order requires it. +6. Codex should provide one executable command package for the workstream. +7. Avoid repeated proceed confirmations. +8. Stop only for start gate failure, merge approval, conflict, or OWNER decision. +9. Standard review format: + - changed code files + - findings + - PASS / FAIL + - next action +10. Governance exists to enable delivery, not become the bottleneck. + +## Default + +Batch Governance Mode is the default operating mode for all teams unless OWNER explicitly overrides it. diff --git a/docs_build/dev/ProjectInstructions/addendums/postgres_only.md b/docs_build/dev/ProjectInstructions/addendums/postgres_only.md new file mode 100644 index 000000000..55af64381 --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/postgres_only.md @@ -0,0 +1,11 @@ +SQLite is deprecated. + +Game Foundry Studio standard database: +PostgreSQL + +Rules: +- No new SQLite implementations +- No new SQLite dependencies +- Existing SQLite references are technical debt +- New persistence work targets PostgreSQL +- PRs introducing SQLite should be rejected diff --git a/docs_build/dev/ProjectInstructions/addendums/referenced_asset_protection.md b/docs_build/dev/ProjectInstructions/addendums/referenced_asset_protection.md new file mode 100644 index 000000000..1c6804061 --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/referenced_asset_protection.md @@ -0,0 +1,23 @@ +Objects referenced elsewhere cannot be directly deleted. + +Lifecycle: +- Active +- Deprecated +- Archived + +Applies to: +- Assets +- Audio +- Fonts +- Tags +- Messages +- Emotion Profiles +- TTS Profiles +- Objects +- Worlds +- Characters +- Events + +Rule: +Deprecate first. +Delete only when no references exist. diff --git a/docs_build/dev/ProjectInstructions/addendums/table_first_ui.md b/docs_build/dev/ProjectInstructions/addendums/table_first_ui.md new file mode 100644 index 000000000..23ceb1622 --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/table_first_ui.md @@ -0,0 +1,17 @@ +Game Foundry Studio uses a table-first creator experience. + +Preferred patterns: +- table display +- inline editing +- save/cancel on row +- add row at bottom +- child rows for details +- reusable table components + +Avoid: +- large multi-page forms +- modal-heavy workflows +- separate edit pages when inline editing is practical + +Reference implementation: +Idea Board is the reference implementation. diff --git a/docs_build/dev/ProjectInstructions/addendums/tool_imagery.md b/docs_build/dev/ProjectInstructions/addendums/tool_imagery.md new file mode 100644 index 000000000..1dd83ef5a --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/tool_imagery.md @@ -0,0 +1,22 @@ +# Tool Imagery Governance + +## Badge Standard + +- 1024x1024 +- Transparent background +- No text +- No labels + +## Tool Hero Standard + +- 1820x1024 +- Mascot scene +- No text +- No labels + +## Approved Mascots + +- Spark +- Pixel Smith +- ForgeBot +- Foundry Bot diff --git a/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md b/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md new file mode 100644 index 000000000..a44c64662 --- /dev/null +++ b/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md @@ -0,0 +1,44 @@ +# Team Ownership Governance + +## OWNER + +- Architecture +- Product Direction +- Cross-Team Governance +- Final Approval + +## Team Alfa + +- Idea Board +- Game Hub +- Game Journey +- Design +- Objects +- Worlds +- Interface +- Controls +- Rules +- Progression + +## Team Bravo + +- Graphics +- Audio +- Messages +- TTS +- MIDI +- Publishing +- Community +- Marketplace + +## Team Charlie + +- Governance +- Infrastructure +- Operations +- Diagnostics +- System Health + +## Rule + +Ownership may only be reassigned by OWNER governance.