Skip to content

Commit 77bd323

Browse files
committed
OWNER: add batch governance mode and PI hygiene standards
1 parent a310b6e commit 77bd323

7 files changed

Lines changed: 161 additions & 0 deletions

File tree

docs_build/dev/ProjectInstructions/README.txt

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -26,3 +26,17 @@ When a governance or instruction state needs a history snapshot, add a new file
2626
CCYYMMDD_HHMMSS.md
2727

2828
Do not rewrite history snapshots after creation unless the owner explicitly approves.
29+
30+
READ THIS FIRST
31+
32+
1. Read Project Instructions before making changes.
33+
2. Project Instructions are append-only.
34+
3. Existing approved guidance may not be removed.
35+
4. Team ownership must be respected.
36+
5. BACKLOG_MASTER.md is the authoritative backlog.
37+
6. Build Path status derives from backlog status.
38+
7. Direct-to-main commits are prohibited.
39+
8. Use approved PR workflow.
40+
9. Follow OWNER governance decisions.
41+
10. When guidance conflicts, newest OWNER-approved guidance wins.
42+
11. Batch Governance Mode is the default for governance, documentation, and administrative work.
Lines changed: 30 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,30 @@
1+
# All-Teams Governance Rule: Batch Governance Mode
2+
3+
Status: Approved
4+
Owner: OWNER
5+
Applies To: All teams
6+
7+
## Purpose
8+
9+
Increase throughput, reduce governance overhead, reduce review churn, and allow teams to spend more time building.
10+
11+
## Rules
12+
13+
1. Prefer workstream PRs for related governance, documentation, and administrative changes.
14+
2. Avoid one-document-per-PR unless risk, dependency order, or OWNER direction requires it.
15+
3. Review by workstream, not by individual file.
16+
4. Minimize approval cycles.
17+
5. Use stacked sequential PRs only when dependency order requires it.
18+
6. Codex should provide one executable command package for the workstream.
19+
7. Avoid repeated proceed confirmations.
20+
8. Stop only for start gate failure, merge approval, conflict, or OWNER decision.
21+
9. Standard review format:
22+
- changed code files
23+
- findings
24+
- PASS / FAIL
25+
- next action
26+
10. Governance exists to enable delivery, not become the bottleneck.
27+
28+
## Default
29+
30+
Batch Governance Mode is the default operating mode for all teams unless OWNER explicitly overrides it.
Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
SQLite is deprecated.
2+
3+
Game Foundry Studio standard database:
4+
PostgreSQL
5+
6+
Rules:
7+
- No new SQLite implementations
8+
- No new SQLite dependencies
9+
- Existing SQLite references are technical debt
10+
- New persistence work targets PostgreSQL
11+
- PRs introducing SQLite should be rejected
Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
Objects referenced elsewhere cannot be directly deleted.
2+
3+
Lifecycle:
4+
- Active
5+
- Deprecated
6+
- Archived
7+
8+
Applies to:
9+
- Assets
10+
- Audio
11+
- Fonts
12+
- Tags
13+
- Messages
14+
- Emotion Profiles
15+
- TTS Profiles
16+
- Objects
17+
- Worlds
18+
- Characters
19+
- Events
20+
21+
Rule:
22+
Deprecate first.
23+
Delete only when no references exist.
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
Game Foundry Studio uses a table-first creator experience.
2+
3+
Preferred patterns:
4+
- table display
5+
- inline editing
6+
- save/cancel on row
7+
- add row at bottom
8+
- child rows for details
9+
- reusable table components
10+
11+
Avoid:
12+
- large multi-page forms
13+
- modal-heavy workflows
14+
- separate edit pages when inline editing is practical
15+
16+
Reference implementation:
17+
Idea Board is the reference implementation.
Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
# Tool Imagery Governance
2+
3+
## Badge Standard
4+
5+
- 1024x1024
6+
- Transparent background
7+
- No text
8+
- No labels
9+
10+
## Tool Hero Standard
11+
12+
- 1820x1024
13+
- Mascot scene
14+
- No text
15+
- No labels
16+
17+
## Approved Mascots
18+
19+
- Spark
20+
- Pixel Smith
21+
- ForgeBot
22+
- Foundry Bot
Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
# Team Ownership Governance
2+
3+
## OWNER
4+
5+
- Architecture
6+
- Product Direction
7+
- Cross-Team Governance
8+
- Final Approval
9+
10+
## Team Alfa
11+
12+
- Idea Board
13+
- Game Hub
14+
- Game Journey
15+
- Design
16+
- Objects
17+
- Worlds
18+
- Interface
19+
- Controls
20+
- Rules
21+
- Progression
22+
23+
## Team Bravo
24+
25+
- Graphics
26+
- Audio
27+
- Messages
28+
- TTS
29+
- MIDI
30+
- Publishing
31+
- Community
32+
- Marketplace
33+
34+
## Team Charlie
35+
36+
- Governance
37+
- Infrastructure
38+
- Operations
39+
- Diagnostics
40+
- System Health
41+
42+
## Rule
43+
44+
Ownership may only be reassigned by OWNER governance.

0 commit comments

Comments
 (0)