PR_26177_OWNER_011-codex-zip-and-next-pr-standard

docs_build/dev/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md

@@ -6,20 +6,31 @@ Standardize Codex deliverables, completion reporting, and artifact generation.
 
 ## ZIP Artifact Requirement
 
-Every Codex task must produce a ZIP artifact.
+Every Codex execution must produce a repo-structured ZIP artifact and the required reports.
 
-Applies to:
-- Success
-- Failure
-- Stop Gate
-- Partial Completion
-- Review Deliverables
-- Governance Deliverables
+This applies regardless of result:
+
+- success
+- completion
+- partial completion
+- hard stop
+- blocked
+- validation failure
+- new information discovered
+- no files changed
+- review deliverables
+- governance deliverables
+
+No exceptions.
 
 Minimum ZIP contents:
-- summary.md
+
+- changed or preserved repo files from the run, stored at repo-relative paths
+- required reports under `docs_build/dev/reports/`
 
 Optional:
+
+- summary.md
 - changed-files.txt
 - findings.md
 - validation.txt
@@ -28,11 +39,16 @@ Optional:
 ## Completion Reporting
 
 Codex responses must include:
+
 - ZIP filename
 - ZIP location
+- repo-structured ZIP path
+- reports
+- changed file list
 - PR number(s)
 - Merge commit(s)
 - Validation results
+- branch, worktree, and local/origin sync status when relevant
 
 ## Tool MVP PR Report Requirements
 
@@ -82,3 +98,5 @@ unless explicitly requested.
 ## No ZIP Means Incomplete
 
 A task is not considered complete until the ZIP artifact is generated and reported.
+
+If execution stops before implementation, validation, or commit, the stop result must still include the repo-structured ZIP and reports that document the hard stop, blocker, validation failure, or no-change result.

docs_build/dev/ProjectInstructions/addendums/pr_workflow.md

@@ -126,10 +126,11 @@ Closed gates:
 - If validation fails, stop and report.
 - If conflict occurs, stop and report.
 - If OWNER decision is required, stop and report.
-- Every completed Codex PR run must produce a repo-structured ZIP under `tmp/`.
-- The ZIP rule applies to implementation, audit, report-only, validation-only, governance, and cleanup PRs.
+- Every Codex execution must produce a repo-structured ZIP under `tmp/`.
+- The ZIP rule applies to implementation, audit, report-only, validation-only, governance, cleanup, hard-stop, blocked, validation-failure, partial-completion, new-information, and no-change runs.
 - The ZIP must include all changed or preserved repo files from the run and must not replace required reports under `docs_build/dev/reports/`.
-- If no repo files changed, Codex must still create a ZIP containing the PR report that proves the no-change result, unless the run hard-stopped before producing outputs.
+- If no repo files changed, Codex must still create a ZIP containing the report that proves the no-change, hard-stop, blocked, validation-failure, or partial-completion result.
+- No exceptions.
 
 ## Batch Governance Mode
 
@@ -240,6 +241,35 @@ Stop only for:
 - Validation failure
 - OWNER decision
 
+## Completed PR ZIP Review And Next Logical PRs
+
+Whenever the Product Owner provides a completed PR ZIP to ChatGPT, ChatGPT shall:
+
+- review the completed work
+- identify completed scope
+- identify remaining scope
+- update the team backlog and completion percentages
+- determine the next logical PRs
+- recommend the execution order
+- generate each recommended PR with:
+  - PR summary
+  - Codex command
+  - commit comment
+  - Playwright scope
+  - manual validation steps
+
+Use plural wording: `next logical PRs`.
+
+Unless blocked by dependencies or directed otherwise by the Product Owner, ChatGPT should generate enough sequential PRs to complete the current backlog item to a Product Owner testable state rather than stopping after a single PR.
+
+The Product Owner should not have to ask:
+
+- `What is next?`
+- `Create the next PR.`
+- `Continue.`
+
+The backlog drives the next recommended PRs automatically.
+
 ## EOD Main Lock
 
 End of Day:

docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md

@@ -53,6 +53,8 @@ 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.
 
+When the Product Owner provides a completed PR ZIP, ChatGPT must review that ZIP, update the active team backlog and completion percentages, and recommend the next logical PRs needed to keep moving toward a Product Owner testable outcome.
+
 ## Start Of Day Team Briefing
 
 When a team is assigned, ChatGPT/Codex must provide this briefing before implementation begins:

docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard.md

@@ -0,0 +1,56 @@
+# PR_26177_OWNER_011-codex-zip-and-next-pr-standard
+
+Date: 2026-06-27
+Team: OWNER
+Branch: PR_26177_OWNER_011-codex-zip-and-next-pr-standard
+
+## Purpose
+
+Add governance that every Codex execution produces reports and a repo-structured ZIP, and that completed PR ZIP review automatically drives the next logical PRs.
+
+## 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
+
+- Strengthened the Codex artifact standard so every Codex execution produces required reports and a repo-structured ZIP.
+- Made the ZIP/report rule apply to success, completion, partial completion, hard stop, blocked, validation failure, new information, no-change, review, and governance results.
+- Removed the previous exception that allowed hard stops before outputs to skip ZIP/report delivery.
+- Required Codex responses to return ZIP path, reports, changed file list, validation results, and branch/worktree/sync status when relevant.
+- Added completed PR ZIP review governance:
+  - review completed work
+  - identify completed and remaining scope
+  - update team backlog and completion percentages
+  - determine the next logical PRs
+  - recommend execution order
+  - generate each recommended PR with summary, Codex command, commit comment, Playwright scope, and manual validation steps
+- Confirmed the backlog drives next recommended PRs automatically.
+- Preserved the existing SOD, active team branch, sequential workstream, EOD, Product Owner testable, and page-level Playwright workflow rules.
+
+## Validation
+
+- PASS: `git diff --cached --check -- . :(exclude)docs_build/dev/reports/codex_review.diff`
+- PASS: documentation/governance-only changed-file check.
+- PASS: ZIP-on-every-result rule exists.
+- PASS: hard stops require ZIP/report output.
+- PASS: `next logical PRs` plural wording exists.
+- PASS: automatic next PR planning is tied to completed PR ZIP review.
+- PASS: SOD starts from latest synchronized `main`.
+- PASS: SOD creates or uses the active team branch.
+- PASS: all commits go to the active team branch, not `main`.
+- PASS: sequential PRs stay on the active team branch/workstream during the day.
+- PASS: EOD returns to `main` and verifies clean sync `0 0`.
+- PASS: Product Owner testable completion rule remains present.
+- PASS: page-level Playwright completion gate remains present.
+- PASS: no runtime files changed.
+
+## Artifact
+
+- `tmp/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_delta.zip`
+
+## Manual Validation Notes
+
+Reviewers should confirm the active governance now makes ZIP/report delivery mandatory for every Codex result and makes completed PR ZIP review produce the next logical PRs without requiring the Product Owner to ask for continuation.

docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_branch-validation.md

@@ -0,0 +1,23 @@
+# PR_26177_OWNER_011 Branch Validation
+
+Date: 2026-06-27
+Team: OWNER
+Branch: PR_26177_OWNER_011-codex-zip-and-next-pr-standard
+
+## Result
+
+PASS
+
+## Checks
+
+- PASS: Work was performed on the active OWNER PR branch, not `main`.
+- PASS: Branch is stacked on `PR_26177_OWNER_010-team-backlog-sod-eod-standard`.
+- 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.

docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_manual-validation-notes.md

@@ -0,0 +1,20 @@
+# PR_26177_OWNER_011 Manual Validation Notes
+
+Date: 2026-06-27
+Team: OWNER
+
+## Manual Review
+
+Review these files:
+
+- `docs_build/dev/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md`
+- `docs_build/dev/ProjectInstructions/addendums/pr_workflow.md`
+- `docs_build/dev/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md`
+
+Confirm they require every Codex result to include reports and a repo-structured ZIP, including hard stops and no-change results.
+
+Confirm completed PR ZIP review now drives the next logical PRs and produces enough sequential PRs to reach a Product Owner testable outcome unless blocked or directed otherwise.
+
+## Expected Reviewer Outcome
+
+The Product Owner should no longer need to ask for continuation after handing ChatGPT a completed PR ZIP; the backlog and ZIP review should automatically drive the next recommended PRs.

docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_requirements-checklist.md

@@ -0,0 +1,30 @@
+# PR_26177_OWNER_011 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: ZIP-on-every-result governance added.
+- PASS: Rule applies to success, completion, partial completion, hard stop, blocked, validation failure, new information, and no files changed.
+- PASS: Every Codex execution must return repo-structured ZIP path, reports, changed file list, validation results, and branch/worktree/sync status when relevant.
+- PASS: `No exceptions` wording added.
+- PASS: Automatic next PR planning tied to Product Owner completed PR ZIP review.
+- PASS: `next logical PRs` plural wording exists.
+- PASS: Recommended PR output includes PR summary, Codex command, commit comment, Playwright scope, and manual validation steps.
+- PASS: Product Owner should not need to ask `What is next?`, `Create the next PR.`, or `Continue.`
+- PASS: Backlog drives next recommended PRs automatically.
+- PASS: Existing SOD/main, active team branch, stacked PR, EOD, Product Owner testable, and page-level Playwright rules remain present.
+- 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.

docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_validation-lane.md

@@ -0,0 +1,43 @@
+# PR_26177_OWNER_011 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 ZIP, next logical PRs, workflow preservation checks"
+```
+
+Result: PASS
+
+## Targeted Results
+
+- PASS: ZIP-on-every-result rule exists.
+- PASS: hard stops require ZIP/report output.
+- PASS: `next logical PRs` plural wording exists.
+- PASS: automatic next PR planning is tied to completed PR ZIP review.
+- PASS: SOD/main active branch workflow remains present.
+- PASS: EOD clean main sync rule remains present.
+- PASS: Product Owner testable rule remains present.
+- PASS: page-level Playwright completion gate remains present.
+- 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.

docs_build/dev/reports/codex_changed_files.txt

@@ -1,15 +1,10 @@
-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/codex_artifact_and_reporting_standard.md
+docs_build/dev/ProjectInstructions/addendums/pr_workflow.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/PR_26177_OWNER_011-codex-zip-and-next-pr-standard.md
+docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_branch-validation.md
+docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_manual-validation-notes.md
+docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_requirements-checklist.md
+docs_build/dev/reports/PR_26177_OWNER_011-codex-zip-and-next-pr-standard_validation-lane.md
 docs_build/dev/reports/codex_changed_files.txt
 docs_build/dev/reports/codex_review.diff