Skip to content

Commit 8327d4e

Browse files
committed
OWNER 010 align Project Instructions team and command state
1 parent 60d89d8 commit 8327d4e

21 files changed

Lines changed: 1254 additions & 704 deletions

dev/build/ProjectInstructions/PROJECT_STATE.md

Lines changed: 15 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -5,22 +5,24 @@ project_state_version: "2026-06-28.PR_26179_OWNER_010"
55
last_updated: "2026-06-28"
66
current_main_commit: "40de767476d70cadfd1292c916844c2f31b6f185"
77
repository_status:
8-
state: "active-owner-pr"
9-
current_pr: "PR_26179_OWNER_010-canonical-project-folder-instructions"
10-
required_start_branch: "main"
11-
required_start_sync: "main...origin/main == 0 0"
8+
state: "active"
9+
governance_source: "dev/build/ProjectInstructions/"
10+
runtime_database: "Postgres"
11+
creator_metadata: "API to Postgres"
12+
creator_assets: "API to R2"
1213
project_instructions_version: "2026-06-28.PR_26179_OWNER_010"
13-
canonical_layout_version: "2026-06-27.PR_26179_OWNER_010"
14+
repository_structure_version: "2026-06-28.PR_26179_OWNER_010"
15+
canonical_layout_version: "2026-06-28.PR_26179_OWNER_010"
1416
active_teams:
15-
- "Team OWNER"
16-
- "Team Alfa"
17-
- "Team Bravo"
18-
- "Team Charlie"
19-
- "Team Delta"
20-
- "Team Golf"
17+
- "Owner"
18+
- "Alfa"
19+
- "Bravo"
20+
- "Charlie"
21+
- "Delta"
22+
- "Golf"
2123
latest_owner_pr: "PR_26179_OWNER_010-canonical-project-folder-instructions"
2224
latest_structure_pr: "PR_26179_OWNER_010-canonical-project-folder-instructions"
23-
current_valid_top_level_folders:
25+
valid_top_level_folders:
2426
- "account/"
2527
- "admin/"
2628
- "assets/"
@@ -37,7 +39,7 @@ current_valid_top_level_folders:
3739
- "owner/"
3840
- "src/"
3941
- "toolbox/"
40-
current_valid_dev_folders:
42+
valid_dev_folders:
4143
- "dev/archive/"
4244
- "dev/build/"
4345
- "dev/config/"

dev/build/ProjectInstructions/TEAM_START_COMMANDS.md

Lines changed: 41 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -23,123 +23,123 @@ Branch Lifecycle (Canonical):
2323

2424
## Team Migration Note
2525

26-
Team Alfa, Team Bravo, Team Charlie, and historical Team Gamma lanes must update from current `main` before starting work and use the folder-placement SSoT:
26+
Alfa, Bravo, Charlie, and historical retired non-canonical lanes must update from current `main` before starting work and use the folder-placement SSoT:
2727

2828
`dev/build/ProjectInstructions/repository/canonical_repository_structure.md`
2929

3030
Do not create or reuse invalid legacy folders. Use the SSoT invalid legacy path list.
3131

3232
If a proposed file does not clearly belong in a canonical folder, HARD STOP and report the proposed path.
3333

34-
## Start Team Alfa
34+
## Start Alfa
3535

3636
Ready-to-copy command:
3737

3838
```text
39-
OWNER override approved: Start Team Alfa from the ProjectInstructions release gate.
39+
OWNER override approved: Start Alfa from the ProjectInstructions release gate.
4040
4141
Read dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md first.
4242
Read dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md.
4343
Read dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md.
4444
45-
Pull one [ ] item for Team Alfa from BACKLOG_MASTER.md.
46-
Stop if Team Alfa already has an active branch.
47-
Stop if Team Alfa already has an active assignment.
48-
Stop if no [ ] Team Alfa backlog item is available.
45+
Pull one [ ] item for Alfa from BACKLOG_MASTER.md.
46+
Stop if Alfa already has an active branch.
47+
Stop if Alfa already has an active assignment.
48+
Stop if no [ ] Alfa backlog item is available.
4949
5050
Change the selected backlog item from [ ] to [.].
51-
Add the selected assignment under Team Alfa in TEAM_ASSIGNMENTS.md.
52-
Create one Team Alfa branch for the selected assignment.
51+
Add the selected assignment under Alfa in TEAM_ASSIGNMENTS.md.
52+
Create one Alfa branch for the selected assignment.
5353
Work only that assignment.
5454
```
5555

56-
## Start Team Bravo
56+
## Start Bravo
5757

5858
Ready-to-copy command:
5959

6060
```text
61-
OWNER override approved: Start Team Bravo from the ProjectInstructions release gate.
61+
OWNER override approved: Start Bravo from the ProjectInstructions release gate.
6262
6363
Read dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md first.
6464
Read dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md.
6565
Read dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md.
6666
67-
Pull one [ ] item for Team Bravo from BACKLOG_MASTER.md.
68-
Stop if Team Bravo already has an active branch.
69-
Stop if Team Bravo already has an active assignment.
70-
Stop if no [ ] Team Bravo backlog item is available.
67+
Pull one [ ] item for Bravo from BACKLOG_MASTER.md.
68+
Stop if Bravo already has an active branch.
69+
Stop if Bravo already has an active assignment.
70+
Stop if no [ ] Bravo backlog item is available.
7171
7272
Change the selected backlog item from [ ] to [.].
73-
Add the selected assignment under Team Bravo in TEAM_ASSIGNMENTS.md.
74-
Create one Team Bravo branch for the selected assignment.
73+
Add the selected assignment under Bravo in TEAM_ASSIGNMENTS.md.
74+
Create one Bravo branch for the selected assignment.
7575
Work only that assignment.
7676
```
7777

78-
## Start Team Charlie
78+
## Start Charlie
7979

8080
Ready-to-copy command:
8181

8282
```text
83-
OWNER override approved: Start Team Charlie from the ProjectInstructions release gate.
83+
OWNER override approved: Start Charlie from the ProjectInstructions release gate.
8484
8585
Read dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md first.
8686
Read dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md.
8787
Read dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md.
8888
89-
Pull one [ ] item for Team Charlie from BACKLOG_MASTER.md.
90-
Stop if Team Charlie already has an active branch.
91-
Stop if Team Charlie already has an active assignment.
92-
Stop if no [ ] Team Charlie backlog item is available.
89+
Pull one [ ] item for Charlie from BACKLOG_MASTER.md.
90+
Stop if Charlie already has an active branch.
91+
Stop if Charlie already has an active assignment.
92+
Stop if no [ ] Charlie backlog item is available.
9393
9494
Change the selected backlog item from [ ] to [.].
95-
Add the selected assignment under Team Charlie in TEAM_ASSIGNMENTS.md.
96-
Create one Team Charlie branch for the selected assignment.
95+
Add the selected assignment under Charlie in TEAM_ASSIGNMENTS.md.
96+
Create one Charlie branch for the selected assignment.
9797
Work only that assignment.
9898
```
9999

100-
## Start Team Delta
100+
## Start Delta
101101

102102
Ready-to-copy command:
103103

104104
```text
105-
OWNER override approved: Start Team Delta from the ProjectInstructions release gate.
105+
OWNER override approved: Start Delta from the ProjectInstructions release gate.
106106
107107
Read dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md first.
108108
Read dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md.
109109
Read dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md.
110110
Read dev/build/ProjectInstructions/team_assignments/team_ownership.md.
111111
112-
Pull one [ ] item for Team Delta from BACKLOG_MASTER.md.
113-
Stop if Team Delta already has an active branch.
114-
Stop if Team Delta already has an active assignment.
115-
Stop if no [ ] Team Delta backlog item is available.
116-
Stop if the selected item is outside Team Delta ownership.
112+
Pull one [ ] item for Delta from BACKLOG_MASTER.md.
113+
Stop if Delta already has an active branch.
114+
Stop if Delta already has an active assignment.
115+
Stop if no [ ] Delta backlog item is available.
116+
Stop if the selected item is outside Delta ownership.
117117
118118
Change the selected backlog item from [ ] to [.].
119-
Add the selected assignment under Team Delta in TEAM_ASSIGNMENTS.md.
120-
Create one Team Delta branch for the selected assignment.
119+
Add the selected assignment under Delta in TEAM_ASSIGNMENTS.md.
120+
Create one Delta branch for the selected assignment.
121121
Work only that assignment.
122122
```
123123

124-
## Start Team Golf
124+
## Start Golf
125125

126126
Ready-to-copy command:
127127

128128
```text
129-
OWNER override approved: Start Team Golf from the ProjectInstructions release gate.
129+
OWNER override approved: Start Golf from the ProjectInstructions release gate.
130130
131131
Read dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md first.
132132
Read dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md.
133133
Read dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md.
134134
Read dev/build/ProjectInstructions/team_assignments/team_ownership.md.
135135
136-
Stop if Team Golf already has an active branch.
137-
Stop if Team Golf already has an active assignment.
138-
Stop if OWNER has not explicitly assigned Team Golf work.
136+
Stop if Golf already has an active branch.
137+
Stop if Golf already has an active assignment.
138+
Stop if OWNER has not explicitly assigned Golf work.
139139
Stop if the selected work conflicts with current Alfa, Bravo, Charlie, or Delta ownership.
140140
141-
Record the selected assignment under Team Golf in TEAM_ASSIGNMENTS.md.
142-
Create or use one Team Golf branch for the selected assignment.
141+
Record the selected assignment under Golf in TEAM_ASSIGNMENTS.md.
142+
Create or use one Golf branch for the selected assignment.
143143
Work only that assignment.
144144
```
145145

dev/build/ProjectInstructions/addendums/branch_lock_governance.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ This file owns branch lock enforcement and OWNER override handling; it must not
1414
## Active Work Lock
1515

1616
- Work must occur on the active team branch.
17-
- This rule applies to all teams: OWNER, Team Alfa, Team Bravo, Team Charlie, Team Delta, and any future team.
17+
- This rule applies to all canonical teams: Owner, Alfa, Bravo, Charlie, Delta, and Golf.
1818
- An assigned work item keeps its owner of record until complete or OWNER reassignment.
1919
- Work must not move to another team, branch, or PR without OWNER approval.
2020
- A team with no active assignment, active branch, or active PR is inactive.

dev/build/ProjectInstructions/addendums/multi_team.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -25,30 +25,29 @@ OWNER override approved.
2525

2626
The current active ownership lanes are:
2727

28-
- Team Alfa
29-
- Team Bravo
30-
- Team Charlie
31-
- Team Delta
32-
- Team Golf
33-
- Team OWNER
28+
- Alfa
29+
- Bravo
30+
- Charlie
31+
- Delta
32+
- Golf
33+
- Owner
3434

3535
Migration note:
36-
Team Gamma is retired. Team Golf is the replacement active ownership lane.
36+
Golf is the only active replacement for the retired prior lane.
3737

3838
Rules:
39-
- Historical PR references and branch names that mention Gamma remain unchanged for traceability.
40-
- New active work that would previously have used Team Gamma routes to Team Golf.
41-
- Team Golf work requires OWNER assignment, an active branch, an active draft/open PR, or active release/cleanup responsibility.
42-
- If Team Golf work touches Alfa, Bravo, Charlie, or Delta ownership areas, the PR must document the OWNER cross-team decision.
39+
- Historical PR references and branch names that mention retired non-canonical lane remain unchanged for traceability.
40+
- New active work that would previously have used a retired non-canonical lane routes to Golf.
41+
- Golf work requires OWNER assignment, an active branch, an active draft/open PR, or active release/cleanup responsibility.
42+
- If Golf work touches Alfa, Bravo, Charlie, or Delta ownership areas, the PR must document the OWNER cross-team decision.
4343

4444
## All-Team Preferred Codex Execution Method
4545

4646
Preferred execution model:
4747
Single Codex session with multiple sequential PRs.
4848

4949
Applies to:
50-
- Team Alfa through Team Zulu
51-
- Team OWNER
50+
- Owner, Alfa, Bravo, Charlie, Delta, and Golf
5251

5352
Purpose:
5453
Reduce back-and-forth between owner and Codex while keeping PRs reviewable and scoped.

dev/build/ProjectInstructions/addendums/naming_registry.md

Lines changed: 16 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Naming Registry Governance
22

3-
Status: Approved
3+
Status: Approved
44
Owner: OWNER
55

66
## Purpose
@@ -41,28 +41,28 @@ Capture approved Game Foundry Studio names to reduce rename churn.
4141

4242
## Approved Team Naming
4343

44-
Teams must use NATO phonetic naming.
44+
Teams must use the canonical Owner plus military team-name set.
4545

4646
Official active team codes:
4747

48-
- OWNER
49-
- ALFA
50-
- BRAVO
51-
- CHARLIE
52-
- DELTA
48+
- Owner
49+
- Alfa
50+
- Bravo
51+
- Charlie
52+
- Delta
53+
- Golf
5354

5455
Examples:
55-
- Team OWNER
56-
- Team Alfa
57-
- Team Bravo
58-
- Team Charlie
59-
- Team Delta
60-
- Team Echo
61-
- Team Foxtrot
56+
- Owner
57+
- Alfa
58+
- Bravo
59+
- Charlie
60+
- Delta
61+
- Golf
6262

6363
Rule:
64-
- Use `Alfa` spelling when referring to Team Alfa.
65-
- Do not rewrite historical snapshots, archived references, or non-team phrases such as `Alpha/Beta/User isolation framework` unless OWNER explicitly scopes that work.
64+
- Use `Alfa` spelling when referring to Alfa.
65+
- Do not rewrite historical snapshots, archived references, or non-team phrases such as `Alfa/Beta/User isolation framework` unless OWNER explicitly scopes that work.
6666

6767
## Rule
6868

dev/build/ProjectInstructions/addendums/pr_workflow.md

Lines changed: 8 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# PR Workflow Governance
22

3-
Status: Approved
3+
Status: Approved
44
Owner: OWNER
55

66
## Purpose
@@ -46,7 +46,7 @@ Team-neutral daily workflow:
4646
- current branch is `main`
4747
- worktree clean
4848
- local/origin sync is `0 0`
49-
- This rule applies to all teams: OWNER, Team Alfa, Team Bravo, Team Charlie, Team Delta, and any future team.
49+
- This rule applies to all canonical teams: Owner, Alfa, Bravo, Charlie, Delta, and Golf.
5050

5151
This section supersedes older active wording that implies returning to `main` between every PR inside an OWNER-approved stacked/sequential workstream.
5252

@@ -198,13 +198,12 @@ Meaning:
198198
Generate the complete stacked sequential Codex PR chain required to finish the current workstream.
199199

200200
Applies to:
201-
- OWNER
202-
- Team Alfa
203-
- Team Bravo
204-
- Team Charlie
205-
- Team Delta
206-
- Team Golf
207-
- Any future NATO-named team
201+
- Owner
202+
- Alfa
203+
- Bravo
204+
- Charlie
205+
- Delta
206+
- Golf
208207

209208
Behavior:
210209
- Determine completed work.

dev/build/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -117,7 +117,7 @@ From branch creation until merge:
117117
- Open/update the PR from the PR branch.
118118
- For OWNER-approved stacked/sequential workstreams, PR branches/commits stay on the active team branch/workstream between sequential PRs during the day.
119119
- Do not return to `main` between sequential PRs in the same active workstream unless OWNER explicitly approves an EOD or intermediate merge checkpoint.
120-
- This rule applies to all teams: OWNER, Team Alfa, Team Bravo, Team Charlie, Team Delta, and any future team.
120+
- This rule applies to all canonical teams: Owner, Alfa, Bravo, Charlie, Delta, and Golf.
121121

122122
Hard Stops:
123123

dev/build/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md

Lines changed: 8 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -13,23 +13,16 @@ This standard is governance/documentation only. It does not change runtime behav
1313

1414
Use military phonetic spelling for active team names:
1515

16-
- OWNER
17-
- ALFA
18-
- BRAVO
19-
- CHARLIE
20-
- DELTA
16+
- Owner
17+
- Alfa
18+
- Bravo
19+
- Charlie
20+
- Delta
21+
- Golf
2122

22-
Display labels may use title case:
23+
Do not substitute Greek spelling for team names. Use `Alfa` spelling when referring to Alfa.
2324

24-
- Team OWNER
25-
- Team Alfa
26-
- Team Bravo
27-
- Team Charlie
28-
- Team Delta
29-
30-
Do not substitute Greek spelling for team names. Use `Alfa` spelling when referring to Team Alfa.
31-
32-
Historical snapshots, archived references, and non-team phrases such as `Alpha/Beta/User isolation framework` must not be rewritten unless OWNER explicitly scopes that work.
25+
Historical snapshots, archived references, and non-team phrases such as `Alfa/Beta/User isolation framework` must not be rewritten unless OWNER explicitly scopes that work.
3326

3427
## Team Backlog Ownership
3528

0 commit comments

Comments
 (0)