Skip to content

Commit ae1d838

Browse files
ToolboxAidToolboxAid
committed
Add team backlog SOD EOD governance
1 parent 7f36b7d commit ae1d838

15 files changed

Lines changed: 340 additions & 9 deletions

‎docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,10 @@ Existing Project Instructions outside `docs_build/dev/ProjectInstructions/` rema
5454
- `docs_build/dev/reports/` owns generated reports, audits, and validation artifacts.
5555
- root `archive/` owns historical reference material only.
5656

57+
## Team Backlog, SOD, And EOD Governance
58+
59+
`docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md` defines required Start of Day team briefings, End of Day team summaries, active team backlog fields, completion percentage update points, backlog-driven next PR selection, and official military team-name spelling.
60+
5761
## Environment Governance
5862

5963
`docs_build/dev/ProjectInstructions/addendums/environment_governance_model.md` defines the official environment model, environment invariance rule, shared API/service contract rule, required Supabase/Postgres/R2 services, required R2 prefixes, and SQLite retired status.

‎docs_build/dev/ProjectInstructions/README.txt‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -47,6 +47,7 @@ READ THIS FIRST
4747

4848
Addendum index:
4949
- Documentation Ownership: docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md
50+
- Team Backlog, SOD, And EOD Standard: docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md
5051
- Single Source and EOD Main Lock: docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
5152
- Canonical Repository Structure: docs_build/dev/ProjectInstructions/addendums/canonical_repository_structure.md
5253
- Test Structure Standardization: docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md

‎docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,7 @@ No team creates a PR branch until all checks pass:
1010
- `HEAD` SHA matches the published EOD SHA
1111

1212
Use `docs_build/dev/ProjectInstructions/` as the only active Project Instructions source.
13+
Read `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md` before implementation.
1314

1415
Branch Lifecycle (Canonical):
1516
- Every PR follows exactly three phases: START, WORK, END.
@@ -166,4 +167,16 @@ git rev-list --left-right --count main...origin/main
166167
git rev-parse HEAD
167168
168169
Publish Branch, HEAD SHA, and Date/time. This becomes tomorrow's official baseline.
170+
171+
Also provide the required EOD team summary:
172+
- Team name
173+
- Date
174+
- PRs completed
175+
- PRs merged
176+
- Validation summary
177+
- Overall completion percentage
178+
- Remaining backlog
179+
- Completion percentage for each remaining backlog item
180+
- Recommended first PRs for the next day
181+
- Repository status
169182
```

‎docs_build/dev/ProjectInstructions/addendums/naming_registry.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -43,14 +43,27 @@ Capture approved Game Foundry Studio names to reduce rename churn.
4343

4444
Teams must use NATO phonetic naming.
4545

46+
Official active team codes:
47+
48+
- OWNER
49+
- ALFA
50+
- BRAVO
51+
- CHARLIE
52+
- DELTA
53+
4654
Examples:
55+
- Team OWNER
4756
- Team Alfa
4857
- Team Bravo
4958
- Team Charlie
5059
- Team Delta
5160
- Team Echo
5261
- Team Foxtrot
5362

63+
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.
66+
5467
## Rule
5568

5669
Do not rename approved terms without OWNER approval.

‎docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md‎

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,98 @@
1+
# Team Backlog, SOD, And EOD Standard
2+
3+
Status: Approved
4+
Owner: OWNER
5+
6+
## Purpose
7+
8+
Define the required Start of Day briefing, End of Day summary, team backlog ownership, completion percentage tracking, and official military team-name spelling for all active teams.
9+
10+
This standard is governance/documentation only. It does not change runtime behavior, API implementation, storage implementation, database DDL, or secret values.
11+
12+
## Official Team Names
13+
14+
Use military phonetic spelling for active team names:
15+
16+
- OWNER
17+
- ALFA
18+
- BRAVO
19+
- CHARLIE
20+
- DELTA
21+
22+
Display labels may use title case:
23+
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.
33+
34+
## Team Backlog Ownership
35+
36+
Every active team owns an active backlog when it has assigned work.
37+
38+
Each backlog item must track:
39+
40+
- name
41+
- description
42+
- current completion percentage
43+
- remaining work
44+
- blocking dependencies
45+
46+
Completion percentages are updated:
47+
48+
- at SOD
49+
- after each accepted PR
50+
- at EOD
51+
52+
The backlog is the authoritative source for determining the next PRs.
53+
54+
If the backlog and a generated report conflict, the backlog wins unless OWNER explicitly approves a newer governance decision.
55+
56+
## Start Of Day Team Briefing
57+
58+
When a team is assigned, ChatGPT/Codex must provide this briefing before implementation begins:
59+
60+
- team name
61+
- active workstream
62+
- current overall completion percentage
63+
- assigned backlog items
64+
- completion percentage for each backlog item
65+
- remaining work for each backlog item
66+
- recommended execution order
67+
- current active branch
68+
- blocking dependencies, if any
69+
70+
This briefing is required before implementation begins.
71+
72+
## End Of Day Team Summary
73+
74+
At EOD, ChatGPT/Codex must provide:
75+
76+
- team name
77+
- date
78+
- PRs completed
79+
- PRs merged
80+
- validation summary
81+
- overall completion percentage
82+
- remaining backlog
83+
- completion percentage for each remaining backlog item
84+
- recommended first PRs for the next day
85+
- repository status:
86+
- current branch
87+
- worktree
88+
- local/origin sync
89+
90+
## Relationship To Existing Workflow
91+
92+
This standard preserves the existing branch workflow:
93+
94+
- SOD starts from latest `main`.
95+
- SOD creates or uses the active team branch.
96+
- All commits go to the active team branch, not `main`.
97+
- Sequential PRs stay on the active team branch/workstream during the day.
98+
- EOD merges OWNER-approved work, pushes, returns to `main`, and verifies clean worktree and local/origin sync `0 0`.

‎docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,8 @@ Before a team starts, validate:
2323
- work remains with the assigned team until complete or OWNER reassignment
2424
- the team's previous PR is Closed, unless OWNER documented an explicit stacked PR chain
2525

26+
Before implementation begins, ChatGPT/Codex must provide the SOD briefing defined in `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md`.
27+
2628
## Current Four-Team Start Set
2729

2830
The current active delivery teams for backlog start commands are:
@@ -112,6 +114,8 @@ Closed readiness requires:
112114
- backlog updated
113115
- tool state updated when applicable
114116

117+
At EOD, ChatGPT/Codex must provide the team summary defined in `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md`.
118+
115119
## Gate Behavior
116120

117121
Release readiness is a validation gate.

‎docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,21 @@
11
# BACKLOG_MASTER
22

3+
## Backlog Item Tracking Standard
4+
5+
Every active team owns an active backlog when it has assigned work.
6+
7+
Each backlog item must track:
8+
9+
- Name
10+
- Description
11+
- Current completion percentage
12+
- Remaining work
13+
- Blocking dependencies
14+
15+
Completion percentages are updated at SOD, after each accepted PR, and at EOD.
16+
17+
The backlog is the authoritative source for determining the next PRs.
18+
319
## Game Journey MVP
420

521
### Idea

‎docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -101,14 +101,25 @@ This current rule supersedes any prior permanent discipline ownership assumption
101101

102102
Team names must use NATO phonetic naming.
103103

104+
Official active team codes:
105+
106+
- OWNER
107+
- ALFA
108+
- BRAVO
109+
- CHARLIE
110+
- DELTA
111+
104112
Examples:
113+
- Team OWNER
105114
- Team Alfa
106115
- Team Bravo
107116
- Team Charlie
108117
- Team Delta
109118
- Team Echo
110119
- Team Foxtrot
111120

121+
Use `Alfa` spelling when referring to Team Alfa.
122+
112123
## Assignment Rule
113124

114125
Work stays with the assigned team until either:

‎docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard.md‎

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# PR_26177_OWNER_010-team-backlog-sod-eod-standard
2+
3+
Date: 2026-06-27
4+
Team: OWNER
5+
Branch: PR_26177_OWNER_010-team-backlog-sod-eod-standard
6+
7+
## Purpose
8+
9+
Add active governance for team backlog ownership, Start of Day briefings, End of Day summaries, completion percentage tracking, and official military team-name spelling.
10+
11+
## Scope
12+
13+
Documentation and governance only.
14+
15+
No runtime code, UI code, API code, database code, `start_of_day` files, history snapshots, or unrelated cleanup were changed.
16+
17+
## Changes
18+
19+
- Added `team_backlog_sod_eod_standard.md` as an active Project Instructions addendum.
20+
- Added Start of Day team briefing requirements before implementation begins.
21+
- Added End of Day team summary requirements.
22+
- Defined active team backlog ownership fields:
23+
- name
24+
- description
25+
- current completion percentage
26+
- remaining work
27+
- blocking dependencies
28+
- Defined completion percentage update points at SOD, after each accepted PR, and at EOD.
29+
- Confirmed the backlog is authoritative for determining next PRs.
30+
- Added official active team codes: OWNER, ALFA, BRAVO, CHARLIE, and DELTA.
31+
- Confirmed active team-name spelling uses `Alfa`, while historical snapshots and non-team phrases are not rewritten unless OWNER explicitly scopes that work.
32+
- Linked the addendum from active Project Instructions index and team start guidance.
33+
34+
## Validation
35+
36+
- PASS: `git diff --cached --check -- . :(exclude)docs_build/dev/reports/codex_review.diff`
37+
- PASS: documentation/governance-only changed-file check.
38+
- PASS: SOD briefing rule exists.
39+
- PASS: EOD summary rule exists.
40+
- PASS: backlog ownership rule exists.
41+
- PASS: active team codes include ALFA.
42+
- PASS: active `Alpha` references are limited to the non-team cancelled `Alpha/Beta/User isolation framework` phrase.
43+
- PASS: no runtime files changed.
44+
- PASS: no UI files changed.
45+
- PASS: no API files changed.
46+
- PASS: no database files changed.
47+
- PASS: no `start_of_day` files changed.
48+
49+
## Artifact
50+
51+
- `tmp/PR_26177_OWNER_010-team-backlog-sod-eod-standard_delta.zip`
52+
53+
## Manual Validation Notes
54+
55+
Reviewers should confirm active team work now has a required SOD briefing, required EOD summary, explicit backlog ownership fields, completion percentage update cadence, and the official team spelling standard.

‎docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_branch-validation.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
# PR_26177_OWNER_010 Branch Validation
2+
3+
Date: 2026-06-27
4+
Team: OWNER
5+
Branch: PR_26177_OWNER_010-team-backlog-sod-eod-standard
6+
7+
## Result
8+
9+
PASS
10+
11+
## Checks
12+
13+
- PASS: Work was performed on the active OWNER PR branch, not `main`.
14+
- PASS: Branch is stacked on the active OWNER workstream branch.
15+
- PASS: Changes are limited to active Project Instructions and generated reports.
16+
- PASS: No runtime, UI, API, database, or `start_of_day` files changed.
17+
- PASS: staged whitespace validation passed with generated `codex_review.diff` excluded.
18+
- PASS: Required report files were generated.
19+
- PASS: Repo-structured ZIP artifact path is defined under `tmp/`.
20+
21+
## Notes
22+
23+
This PR remains in the OWNER workstream and must not be merged to `main` until EOD closeout or explicit OWNER approval.

0 commit comments

Comments
 (0)