diff --git a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md index 55f4a69ec..d6617c986 100644 --- a/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md +++ b/docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md @@ -54,6 +54,10 @@ Existing Project Instructions outside `docs_build/dev/ProjectInstructions/` rema - `docs_build/dev/reports/` owns generated reports, audits, and validation artifacts. - root `archive/` owns historical reference material only. +## Team Backlog, SOD, And EOD Governance + +`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. + ## Environment Governance `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. diff --git a/docs_build/dev/ProjectInstructions/README.txt b/docs_build/dev/ProjectInstructions/README.txt index 3a2830219..1b647c6fd 100644 --- a/docs_build/dev/ProjectInstructions/README.txt +++ b/docs_build/dev/ProjectInstructions/README.txt @@ -47,6 +47,7 @@ READ THIS FIRST Addendum index: - Documentation Ownership: docs_build/dev/ProjectInstructions/addendums/documentation_ownership.md +- Team Backlog, SOD, And EOD Standard: docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md - Single Source and EOD Main Lock: docs_build/dev/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md - Canonical Repository Structure: docs_build/dev/ProjectInstructions/addendums/canonical_repository_structure.md - Test Structure Standardization: docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md diff --git a/docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md b/docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md index 292540043..5fe1c43e4 100644 --- a/docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md +++ b/docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md @@ -10,6 +10,7 @@ No team creates a PR branch until all checks pass: - `HEAD` SHA matches the published EOD SHA Use `docs_build/dev/ProjectInstructions/` as the only active Project Instructions source. +Read `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md` before implementation. Branch Lifecycle (Canonical): - Every PR follows exactly three phases: START, WORK, END. @@ -166,4 +167,16 @@ git rev-list --left-right --count main...origin/main git rev-parse HEAD Publish Branch, HEAD SHA, and Date/time. This becomes tomorrow's official baseline. + +Also provide the required EOD team summary: +- Team name +- Date +- PRs completed +- PRs merged +- Validation summary +- Overall completion percentage +- Remaining backlog +- Completion percentage for each remaining backlog item +- Recommended first PRs for the next day +- Repository status ``` diff --git a/docs_build/dev/ProjectInstructions/addendums/naming_registry.md b/docs_build/dev/ProjectInstructions/addendums/naming_registry.md index a269f204a..b08863149 100644 --- a/docs_build/dev/ProjectInstructions/addendums/naming_registry.md +++ b/docs_build/dev/ProjectInstructions/addendums/naming_registry.md @@ -43,7 +43,16 @@ Capture approved Game Foundry Studio names to reduce rename churn. Teams must use NATO phonetic naming. +Official active team codes: + +- OWNER +- ALFA +- BRAVO +- CHARLIE +- DELTA + Examples: +- Team OWNER - Team Alfa - Team Bravo - Team Charlie @@ -51,6 +60,10 @@ Examples: - Team Echo - Team Foxtrot +Rule: +- Use `Alfa` spelling when referring to Team Alfa. +- Do not rewrite historical snapshots, archived references, or non-team phrases such as `Alpha/Beta/User isolation framework` unless OWNER explicitly scopes that work. + ## Rule Do not rename approved terms without OWNER approval. diff --git a/docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md b/docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md new file mode 100644 index 000000000..437c01800 --- /dev/null +++ b/docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md @@ -0,0 +1,98 @@ +# Team Backlog, SOD, And EOD Standard + +Status: Approved +Owner: OWNER + +## Purpose + +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. + +This standard is governance/documentation only. It does not change runtime behavior, API implementation, storage implementation, database DDL, or secret values. + +## Official Team Names + +Use military phonetic spelling for active team names: + +- OWNER +- ALFA +- BRAVO +- CHARLIE +- DELTA + +Display labels may use title case: + +- Team OWNER +- Team Alfa +- Team Bravo +- Team Charlie +- Team Delta + +Do not substitute Greek spelling for team names. Use `Alfa` spelling when referring to Team Alfa. + +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. + +## Team Backlog Ownership + +Every active team owns an active backlog when it has assigned work. + +Each backlog item must track: + +- name +- description +- current completion percentage +- remaining work +- blocking dependencies + +Completion percentages are updated: + +- at SOD +- after each accepted PR +- at EOD + +The backlog is the authoritative source for determining the next PRs. + +If the backlog and a generated report conflict, the backlog wins unless OWNER explicitly approves a newer governance decision. + +## Start Of Day Team Briefing + +When a team is assigned, ChatGPT/Codex must provide this briefing before implementation begins: + +- team name +- active workstream +- current overall completion percentage +- assigned backlog items +- completion percentage for each backlog item +- remaining work for each backlog item +- recommended execution order +- current active branch +- blocking dependencies, if any + +This briefing is required before implementation begins. + +## End Of Day Team Summary + +At EOD, ChatGPT/Codex must provide: + +- team name +- date +- PRs completed +- PRs merged +- validation summary +- overall completion percentage +- remaining backlog +- completion percentage for each remaining backlog item +- recommended first PRs for the next day +- repository status: + - current branch + - worktree + - local/origin sync + +## Relationship To Existing Workflow + +This standard preserves the existing branch workflow: + +- SOD starts from latest `main`. +- SOD creates or uses the active team branch. +- All commits go to the active team branch, not `main`. +- Sequential PRs stay on the active team branch/workstream during the day. +- EOD merges OWNER-approved work, pushes, returns to `main`, and verifies clean worktree and local/origin sync `0 0`. diff --git a/docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md b/docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md index e2d6b7226..c4a3ffd9d 100644 --- a/docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md +++ b/docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md @@ -23,6 +23,8 @@ Before a team starts, validate: - work remains with the assigned team until complete or OWNER reassignment - the team's previous PR is Closed, unless OWNER documented an explicit stacked PR chain +Before implementation begins, ChatGPT/Codex must provide the SOD briefing defined in `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md`. + ## Current Four-Team Start Set The current active delivery teams for backlog start commands are: @@ -112,6 +114,8 @@ Closed readiness requires: - backlog updated - tool state updated when applicable +At EOD, ChatGPT/Codex must provide the team summary defined in `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md`. + ## Gate Behavior Release readiness is a validation gate. diff --git a/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md b/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md index 10ed1c93e..cc9ddc88c 100644 --- a/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md +++ b/docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md @@ -1,5 +1,21 @@ # BACKLOG_MASTER +## Backlog Item Tracking Standard + +Every active team owns an active backlog when it has assigned work. + +Each backlog item must track: + +- Name +- Description +- Current completion percentage +- Remaining work +- Blocking dependencies + +Completion percentages are updated at SOD, after each accepted PR, and at EOD. + +The backlog is the authoritative source for determining the next PRs. + ## Game Journey MVP ### Idea diff --git a/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md b/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md index 4e6548811..30b4f2dfe 100644 --- a/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md +++ b/docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md @@ -101,7 +101,16 @@ This current rule supersedes any prior permanent discipline ownership assumption Team names must use NATO phonetic naming. +Official active team codes: + +- OWNER +- ALFA +- BRAVO +- CHARLIE +- DELTA + Examples: +- Team OWNER - Team Alfa - Team Bravo - Team Charlie @@ -109,6 +118,8 @@ Examples: - Team Echo - Team Foxtrot +Use `Alfa` spelling when referring to Team Alfa. + ## Assignment Rule Work stays with the assigned team until either: diff --git a/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard.md b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard.md new file mode 100644 index 000000000..952857d11 --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard.md @@ -0,0 +1,55 @@ +# PR_26177_OWNER_010-team-backlog-sod-eod-standard + +Date: 2026-06-27 +Team: OWNER +Branch: PR_26177_OWNER_010-team-backlog-sod-eod-standard + +## Purpose + +Add active governance for team backlog ownership, Start of Day briefings, End of Day summaries, completion percentage tracking, and official military team-name spelling. + +## Scope + +Documentation and governance only. + +No runtime code, UI code, API code, database code, `start_of_day` files, history snapshots, or unrelated cleanup were changed. + +## Changes + +- Added `team_backlog_sod_eod_standard.md` as an active Project Instructions addendum. +- Added Start of Day team briefing requirements before implementation begins. +- Added End of Day team summary requirements. +- Defined active team backlog ownership fields: + - name + - description + - current completion percentage + - remaining work + - blocking dependencies +- Defined completion percentage update points at SOD, after each accepted PR, and at EOD. +- Confirmed the backlog is authoritative for determining next PRs. +- Added official active team codes: OWNER, ALFA, BRAVO, CHARLIE, and DELTA. +- Confirmed active team-name spelling uses `Alfa`, while historical snapshots and non-team phrases are not rewritten unless OWNER explicitly scopes that work. +- Linked the addendum from active Project Instructions index and team start guidance. + +## Validation + +- PASS: `git diff --cached --check -- . :(exclude)docs_build/dev/reports/codex_review.diff` +- PASS: documentation/governance-only changed-file check. +- PASS: SOD briefing rule exists. +- PASS: EOD summary rule exists. +- PASS: backlog ownership rule exists. +- PASS: active team codes include ALFA. +- PASS: active `Alpha` references are limited to the non-team cancelled `Alpha/Beta/User isolation framework` phrase. +- PASS: no runtime files changed. +- PASS: no UI files changed. +- PASS: no API files changed. +- PASS: no database files changed. +- PASS: no `start_of_day` files changed. + +## Artifact + +- `tmp/PR_26177_OWNER_010-team-backlog-sod-eod-standard_delta.zip` + +## Manual Validation Notes + +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. diff --git a/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_branch-validation.md b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_branch-validation.md new file mode 100644 index 000000000..902ef571d --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_branch-validation.md @@ -0,0 +1,23 @@ +# PR_26177_OWNER_010 Branch Validation + +Date: 2026-06-27 +Team: OWNER +Branch: PR_26177_OWNER_010-team-backlog-sod-eod-standard + +## Result + +PASS + +## Checks + +- PASS: Work was performed on the active OWNER PR branch, not `main`. +- PASS: Branch is stacked on the active OWNER workstream branch. +- PASS: Changes are limited to active Project Instructions and generated reports. +- PASS: No runtime, UI, API, database, or `start_of_day` files changed. +- PASS: staged whitespace validation passed with generated `codex_review.diff` excluded. +- PASS: Required report files were generated. +- PASS: Repo-structured ZIP artifact path is defined under `tmp/`. + +## Notes + +This PR remains in the OWNER workstream and must not be merged to `main` until EOD closeout or explicit OWNER approval. diff --git a/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_manual-validation-notes.md b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_manual-validation-notes.md new file mode 100644 index 000000000..7acfa05a9 --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_manual-validation-notes.md @@ -0,0 +1,19 @@ +# PR_26177_OWNER_010 Manual Validation Notes + +Date: 2026-06-27 +Team: OWNER + +## Manual Review + +Review `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md` and confirm it defines: + +- Start of Day team briefing fields. +- End of Day team summary fields. +- Active team backlog ownership. +- Completion percentage update cadence. +- Official team names: OWNER, ALFA, BRAVO, CHARLIE, DELTA. +- Existing SOD, active team branch, stacked PR, and EOD return-to-main workflow. + +## Expected Reviewer Outcome + +The Product Owner should be able to use the active Project Instructions to start and close a team day with explicit backlog percentages, remaining work, recommended execution order, and repository status. diff --git a/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_requirements-checklist.md b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_requirements-checklist.md new file mode 100644 index 000000000..299da2ffd --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_requirements-checklist.md @@ -0,0 +1,29 @@ +# PR_26177_OWNER_010 Requirements Checklist + +Date: 2026-06-27 +Team: OWNER + +## Requirement Results + +- PASS: Documentation/governance only. +- PASS: Active Project Instructions reviewed and updated. +- PASS: Active instruction files updated only. +- PASS: Historical snapshots were not rewritten. +- PASS: No runtime changes. +- PASS: Start of Day team briefing rule added. +- PASS: End of Day team summary rule added. +- PASS: Team backlog ownership rule added. +- PASS: Backlog item fields include name, description, current completion percentage, remaining work, and blocking dependencies. +- PASS: Completion percentage update cadence added for SOD, accepted PRs, and EOD. +- PASS: Backlog is documented as authoritative for determining next PRs. +- PASS: Official team names use OWNER, ALFA, BRAVO, CHARLIE, and DELTA. +- PASS: Active team references use `Alfa` spelling. +- PASS: Historical and non-team `Alpha/Beta/User isolation framework` wording was preserved. +- PASS: Required reports were generated. +- PASS: Repo-structured ZIP artifact will be generated under `tmp/`. + +## Restrictions + +- PASS: No commit was made to `main`. +- PASS: No `start_of_day` folders changed. +- PASS: No unrelated cleanup. diff --git a/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_validation-lane.md b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_validation-lane.md new file mode 100644 index 000000000..591dc6d70 --- /dev/null +++ b/docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_validation-lane.md @@ -0,0 +1,41 @@ +# PR_26177_OWNER_010 Validation Lane + +Date: 2026-06-27 +Team: OWNER + +## Commands + +```powershell +git diff --cached --check -- . ":(exclude)docs_build/dev/reports/codex_review.diff" +``` + +Result: PASS + +```powershell +node -e "documentation/governance-only changed-file check" +``` + +Result: PASS + +```powershell +node -e "required SOD/EOD/backlog/team-name governance checks" +``` + +Result: PASS + +## Targeted Results + +- PASS: SOD briefing rule exists. +- PASS: EOD summary rule exists. +- PASS: backlog ownership rule exists. +- PASS: required backlog fields exist. +- PASS: official active team code `ALFA` exists. +- PASS: active `Alpha` references are limited to the non-team cancelled initiative phrase. +- PASS: no runtime files changed. +- PASS: no UI files changed. +- PASS: no API files changed. +- PASS: no database files changed. + +## Playwright + +Not impacted. This PR is documentation/governance only. diff --git a/docs_build/dev/reports/codex_changed_files.txt b/docs_build/dev/reports/codex_changed_files.txt index 98a71e332..e97560092 100644 --- a/docs_build/dev/reports/codex_changed_files.txt +++ b/docs_build/dev/reports/codex_changed_files.txt @@ -1,11 +1,15 @@ -docs_build/dev/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md -docs_build/dev/ProjectInstructions/addendums/no_mock_repository_runtime_source.md -docs_build/dev/ProjectInstructions/addendums/pr_workflow.md -docs_build/dev/ProjectInstructions/addendums/test_structure_standardization.md -docs_build/dev/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md -docs_build/dev/reports/PR_26177_OWNER_009-project-instructions-workflow-testable-tests-alignment.md -docs_build/dev/reports/PR_26177_OWNER_009-project-instructions-workflow-testable-tests-alignment_manual-validation-notes.md -docs_build/dev/reports/PR_26177_OWNER_009-project-instructions-workflow-testable-tests-alignment_requirements-checklist.md -docs_build/dev/reports/PR_26177_OWNER_009-project-instructions-workflow-testable-tests-alignment_validation-lane.md +docs_build/dev/ProjectInstructions/PROJECT_INSTRUCTIONS.md +docs_build/dev/ProjectInstructions/README.txt +docs_build/dev/ProjectInstructions/TEAM_START_COMMANDS.md +docs_build/dev/ProjectInstructions/addendums/naming_registry.md +docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md +docs_build/dev/ProjectInstructions/addendums/team_start_and_release.md +docs_build/dev/ProjectInstructions/backlog/BACKLOG_MASTER.md +docs_build/dev/ProjectInstructions/team_assignments/team_ownership.md +docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard.md +docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_branch-validation.md +docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_manual-validation-notes.md +docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_requirements-checklist.md +docs_build/dev/reports/PR_26177_OWNER_010-team-backlog-sod-eod-standard_validation-lane.md docs_build/dev/reports/codex_changed_files.txt docs_build/dev/reports/codex_review.diff diff --git a/docs_build/dev/reports/codex_review.diff b/docs_build/dev/reports/codex_review.diff index 246e75adf..4eb5211ad 100644 Binary files a/docs_build/dev/reports/codex_review.diff and b/docs_build/dev/reports/codex_review.diff differ