OWNER 010 add Codex ZIP completion contract

Author: ToolboxAid

dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md

@@ -102,3 +102,4 @@ That file owns Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, and invalid command be
 - `repository/canonical_repository_structure.md` owns all folder placement and file-placement rules.
 - `standards/CODEX_WORKFLOW_COMMANDS.md` owns Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, and invalid command behavior.
 - `bootstrap/codex_start_of_day_bootstrap.md` owns Start-of-Day bootstrap architecture.
+- `addendums/codex_artifact_and_reporting_standard.md` owns the Codex Completion Contract and ZIP outcome rules.

dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md

@@ -4,11 +4,68 @@
 
 Standardize Codex deliverables, completion reporting, and artifact generation.
 
-## ZIP Artifact Requirement
+## Codex Completion Contract
 
-Every Codex execution must produce a repo-structured ZIP artifact and the required reports.
+Every Codex execution must produce at least one repository-structured ZIP artifact and the required reports.
 
-This applies regardless of result:
+Each PR attempted by Codex must produce exactly one ZIP artifact representing that PR's final outcome.
+
+Missing ZIP means the Codex run did not complete correctly.
+
+Canonical ZIP location:
+
+```text
+dev/workspace/zips/
+```
+
+ZIP outcome suffixes:
+
+- `_delta.zip` = success
+- `_REVIEW.zip` = review-only
+- `_FAILED.zip` = validation or execution failure
+- `_HARD_STOP.zip` = governance or precondition hard stop
+
+## Stacked PR Rule
+
+Stacked PR work produces one ZIP per attempted PR.
+
+If PR 1 succeeds and PR 2 hard-stops, produce:
+
+```text
+PR_...001-..._delta.zip
+PR_...002-..._HARD_STOP.zip
+```
+
+Do not start later stacked PRs after a failure or hard stop.
+
+## ZIP Contents
+
+Success ZIP contents must include:
+
+- changed files
+- diff
+- PR report
+- validation report
+- requirement checklist
+
+Failing PR ZIP contents must include:
+
+- hard stop or failure report
+- branch/worktree status
+- validation output if run
+- requirement checklist
+- changed files and diff if changes occurred
+
+Review-only ZIP contents must include:
+
+- review report
+- branch/worktree status
+- requirement checklist or review checklist when applicable
+- supporting evidence files when applicable
+
+## Applicability
+
+The Codex Completion Contract applies regardless of result:
 
 - success
 - completion
@@ -23,17 +80,11 @@ This applies regardless of result:
 
 No exceptions.
 
-Minimum ZIP contents:
+Minimum repository-structured ZIP rules:
 
-- changed or preserved repo files from the run, stored at repo-relative paths
+- changed, preserved, or outcome evidence repo files from the run, stored at repo-relative paths
 - required reports under `dev/reports/`
 
-ZIP artifacts must be written under:
-
-```text
-dev/workspace/zips/
-```
-
 Reports must remain flat under `dev/reports/`. Use descriptive filenames that include the PR, team, runner, or lane context instead of nested team or runner report folders.
 
 Optional:
@@ -107,6 +158,6 @@ unless explicitly requested.
 
 ## No ZIP Means Incomplete
 
-A task is not considered complete until the ZIP artifact is generated and reported.
+A task is not considered complete until the required ZIP artifact or artifacts are 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.

dev/build/ProjectInstructions/addendums/pr_workflow.md

@@ -11,6 +11,10 @@ Official PLAN_PR, BUILD_PR, APPLY_PR, Start of Day, and invalid command behavior
 
 `dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md`
 
+The Codex Completion Contract for ZIP artifacts lives in:
+
+`dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md`
+
 This file owns PR lifecycle governance. It must not duplicate command phase rules.
 
 ## Standard Flow
@@ -112,11 +116,9 @@ Closed gates:
 - If validation fails, stop and report.
 - If conflict occurs, stop and report.
 - If OWNER decision is required, stop and report.
-- Every Codex execution must produce a repo-structured ZIP under `dev/workspace/zips/`.
-- 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 `dev/reports/`.
-- 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.
+- Every PR lifecycle state must satisfy the Codex Completion Contract when Codex executes work for that state.
+- ZIP artifacts belong under `dev/workspace/zips/` and must not replace required reports under `dev/reports/`.
+- Stacked PR chains produce one final outcome ZIP per attempted PR and stop before later PRs after failure or hard stop.
 
 ## Batch Governance Mode
 

dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md

@@ -35,6 +35,8 @@ The bootstrap loads:
 
 The bootstrap must not create branches, commit files, move files, or run implementation work by itself.
 
+Start-of-Day bootstrap must satisfy the Codex Completion Contract in `dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md` with a review-only ZIP unless a hard stop occurs.
+
 ## Wrapper Responsibilities
 
 The wrapper performs:
@@ -87,7 +89,7 @@ If a chat instruction conflicts with Project Instructions:
 
 - Stop.
 - Do not continue the PR.
-- Produce the required ZIP artifact when the active artifact rules require one.
+- Produce the required ZIP artifact according to the Codex Completion Contract.
 - Document the conflict in the run summary or PR report.
 - Ask for OWNER direction.
 

dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md

@@ -50,6 +50,8 @@ Start of Day reports:
 
 Start of Day may recommend the next execution phase, but it must not execute that phase.
 
+Start of Day must satisfy the Codex Completion Contract in `dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md`. Because Start of Day is read-only discovery, its ZIP outcome is review-only unless another outcome is explicitly documented.
+
 ## Execution Phases
 
 PLAN_PR, BUILD_PR, and APPLY_PR are Codex PR execution phases after Start of Day. They are not part of Start of Day.
@@ -84,6 +86,7 @@ Rules:
 - Identify the correct branch or start point.
 - Identify the intended PR name, purpose, and scope.
 - Identify required validation and reporting.
+- Identify the required ZIP outcome path from the Codex Completion Contract.
 - HARD STOP on unclear scope.
 - HARD STOP if Project Instructions conflict with the requested plan.
 
@@ -96,7 +99,7 @@ Rules:
 - Use the latest Project Instructions.
 - Stay inside the approved PR purpose.
 - Create required reports.
-- Create the required repo-structured ZIP artifact when the active artifact rules require one.
+- Create the required repo-structured ZIP artifact for the attempted PR according to the Codex Completion Contract.
 - Run scoped validation required by the PR and Project Instructions.
 - HARD STOP on wrong branch.
 - HARD STOP on dirty worktree when the PR requires a clean start.
@@ -111,7 +114,7 @@ APPLY_PR is the merge and closeout phase.
 Rules:
 - Verify CI status, validation status, and mergeability before merge.
 - Verify the PR merge state is clean.
-- Verify required reports and ZIP artifacts exist.
+- Verify required reports and Codex Completion Contract ZIP artifacts exist.
 - Merge only when Project Instructions and OWNER direction allow the merge.
 - Update local `main` after merge.
 - Report final branch, worktree status, local/origin sync status, final commit, and blockers.

dev/reports/PR_26179_OWNER_010-canonical-project-folder-instructions.md

@@ -1,49 +1,32 @@
 # PR_26179_OWNER_010-canonical-project-folder-instructions
 
-Updated: 2026-06-28T02:32:48Z
+Updated: 2026-06-28T02:44:56Z
 Team: OWNER
 Branch: PR_26179_OWNER_010-canonical-project-folder-instructions
 Scope: Documentation/governance only. No runtime code or production pages changed.
 
 ## Summary
-- Standardized active Project Instructions team names to Owner, Alfa, Bravo, Charlie, Delta, and Golf.
-- Removed active Alpha/Gamma wording and speculative non-canonical team lists from Project Instructions.
-- Updated Start of Day examples to Owner, Alfa, Bravo, Charlie, Delta, and Golf.
-- Made `PROJECT_STATE.md` repository-truth oriented by removing transient current PR/current branch/worktree-style status.
-- Clarified Start of Day as read-only discovery only and separated it from PLAN_PR, BUILD_PR, and APPLY_PR execution phases.
-
-## Team Naming Result
-- Canonical active teams: Owner, Alfa, Bravo, Charlie, Delta, Golf.
-- Active ProjectInstructions grep for Alpha/Gamma/non-canonical team names: PASS, no historical exceptions remain.
-- OWNER remains as approval authority wording where it is not used as a team name.
-
-## PROJECT_STATE.md Result
-- Required fields present: `project_state_version`, `last_updated`, `repository_status`, `current_main_commit`, `project_instructions_version`, `repository_structure_version`, `canonical_layout_version`, `active_teams`, `latest_owner_pr`, `latest_structure_pr`, `valid_top_level_folders`, `valid_dev_folders`, `known_technical_debt`.
-- Removed transient fields: `current_pr`, active branch, current worktree status, today's task, and backlog task list.
-
-## Lifecycle Clarification Result
-- Start of Day is read-only discovery only and may recommend the next phase without executing it.
-- PLAN_PR, BUILD_PR, and APPLY_PR are Codex PR execution phases after Start of Day.
-- Lifecycle documented as Start of Day {Team} -> PLAN_PR -> BUILD_PR -> APPLY_PR.
+- Added the Codex Completion Contract to the artifact/reporting standard.
+- Defined canonical ZIP location as `dev/workspace/zips/`.
+- Defined outcome suffixes: `_delta.zip`, `_REVIEW.zip`, `_FAILED.zip`, and `_HARD_STOP.zip`.
+- Clarified one ZIP per attempted PR, with at least one repository-structured ZIP for every Codex execution.
+- Added stacked PR ZIP handling and failure/hard-stop ZIP content requirements.
+- Updated Start of Day, PLAN_PR, BUILD_PR, APPLY_PR, and PR workflow references to the completion contract.
+
+## Completion Contract Result
+- SSoT: `dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md`.
+- Every Codex execution must produce at least one repository-structured ZIP.
+- Each PR attempted by Codex must produce exactly one final outcome ZIP.
+- Missing ZIP means the Codex run did not complete correctly.
+- Grep for conflicting `exactly one repository-structured ZIP` wording: PASS, no conflicting wording found.
 
 ## Changed Files
 ```
-M	dev/build/ProjectInstructions/PROJECT_STATE.md
-M	dev/build/ProjectInstructions/TEAM_START_COMMANDS.md
-M	dev/build/ProjectInstructions/addendums/branch_lock_governance.md
-M	dev/build/ProjectInstructions/addendums/multi_team.md
-M	dev/build/ProjectInstructions/addendums/naming_registry.md
+M	dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
+M	dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md
 M	dev/build/ProjectInstructions/addendums/pr_workflow.md
-M	dev/build/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
-M	dev/build/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md
-M	dev/build/ProjectInstructions/addendums/team_release_readiness.md
-M	dev/build/ProjectInstructions/addendums/team_start_and_release.md
-M	dev/build/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md
-M	dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md
+M	dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md
 M	dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md
-M	dev/build/ProjectInstructions/team_assignments/ACTIVE_TEAM_REGISTRY.md
-M	dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
-M	dev/build/ProjectInstructions/team_assignments/team_ownership.md
 M	dev/reports/codex_changed_files.txt
 M	dev/reports/codex_review.diff
 M	dev/reports/PR_26179_OWNER_010-canonical-project-folder-instructions.md
@@ -55,7 +38,7 @@ M	dev/reports/PR_26179_OWNER_010-canonical-project-folder-instructions_validatio
 - `git diff --check`: PASS.
 - `npm run validate:canonical-structure`: PASS.
 - `node ./dev/scripts/run-platform-validation-suite.mjs`: PASS, 8/8 scenarios.
-- Grep ProjectInstructions for Alpha/Gamma/non-canonical team names: PASS, no historical exceptions.
+- Grep for `exactly one repository-structured ZIP`: PASS, no replacement needed beyond SSoT wording.
 
 ## Blockers
 None.

dev/reports/PR_26179_OWNER_010-canonical-project-folder-instructions_requirement-checklist.md

@@ -1,22 +1,22 @@
 # PR_26179_OWNER_010-canonical-project-folder-instructions Requirement Checklist
 
-Updated: 2026-06-28T02:32:48Z
+Updated: 2026-06-28T02:44:56Z
 
 - [x] Continued on current branch.
 - [x] Documentation/governance only.
 - [x] Runtime code not modified.
 - [x] Production pages not modified.
-- [x] Canonical teams set to Owner, Alfa, Bravo, Charlie, Delta, Golf.
-- [x] Active Alpha references replaced.
-- [x] Active Gamma references replaced or removed.
-- [x] Non-canonical active team-name examples removed.
-- [x] Start of Day examples updated.
-- [x] PROJECT_STATE.md transient current PR/current branch/worktree fields removed.
-- [x] PROJECT_STATE.md required repository-truth fields present.
-- [x] Start of Day documented as read-only discovery only.
-- [x] PLAN_PR, BUILD_PR, and APPLY_PR documented as execution phases after Start of Day.
-- [x] Lifecycle Start of Day -> PLAN_PR -> BUILD_PR -> APPLY_PR documented.
+- [x] Codex Completion Contract documented.
+- [x] Every Codex execution requires at least one repository-structured ZIP.
+- [x] Each attempted PR requires exactly one final outcome ZIP.
+- [x] Missing ZIP means the Codex run did not complete correctly.
+- [x] Canonical ZIP location documented as `dev/workspace/zips/`.
+- [x] ZIP suffixes documented.
+- [x] Stacked PR ZIP rule documented.
+- [x] Failure/hard-stop ZIP contents documented.
+- [x] Success ZIP contents documented.
+- [x] Start of Day, PLAN_PR, BUILD_PR, and APPLY_PR docs reference the completion contract.
+- [x] Conflicting exactly-one-per-execution wording checked.
 - [x] git diff --check passed.
 - [x] npm run validate:canonical-structure passed.
 - [x] node ./dev/scripts/run-platform-validation-suite.mjs passed.
-- [x] Alpha/Gamma/non-canonical team-name grep passed with no historical exceptions.

dev/reports/PR_26179_OWNER_010-canonical-project-folder-instructions_validation-report.md

@@ -1,22 +1,21 @@
 # PR_26179_OWNER_010-canonical-project-folder-instructions Validation Report
 
-Updated: 2026-06-28T02:32:48Z
+Updated: 2026-06-28T02:44:56Z
 
 ## Commands
 - `git diff --check`: PASS
 - `npm run validate:canonical-structure`: PASS
 - `node ./dev/scripts/run-platform-validation-suite.mjs`: PASS, 8/8 scenarios
-- `rg` Alpha/Gamma/non-canonical team-name grep: PASS, no historical exceptions
-- `rg` PROJECT_STATE transient-field grep: PASS
+- `rg 'exactly one repository-structured ZIP' dev/build/ProjectInstructions`: PASS, no conflicting wording remains
 
 ## Scope Checks
 - Runtime code changed: NO
 - Production pages changed: NO
 - Documentation/governance only: YES
 
 ## Notes
-- OWNER remains as approval authority wording where it is not used as a team name.
-- PROJECT_STATE.md now describes repository truth rather than the current PR branch.
+- Completion contract SSoT is `dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md`.
+- Command and PR workflow docs point to the contract instead of duplicating ZIP rules.
 
 ## Blockers
 None.

dev/reports/codex_changed_files.txt

@@ -1,39 +1,17 @@
 PR_26179_OWNER_010-canonical-project-folder-instructions
-Updated: 2026-06-28T02:32:48Z
+Updated: 2026-06-28T02:44:56Z
 Branch: PR_26179_OWNER_010-canonical-project-folder-instructions
 
 Changed files staged for this update:
-M	dev/build/ProjectInstructions/PROJECT_STATE.md
-M	dev/build/ProjectInstructions/TEAM_START_COMMANDS.md
-M	dev/build/ProjectInstructions/addendums/branch_lock_governance.md
-M	dev/build/ProjectInstructions/addendums/multi_team.md
-M	dev/build/ProjectInstructions/addendums/naming_registry.md
+M	dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
+M	dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md
 M	dev/build/ProjectInstructions/addendums/pr_workflow.md
-M	dev/build/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
-M	dev/build/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md
-M	dev/build/ProjectInstructions/addendums/team_release_readiness.md
-M	dev/build/ProjectInstructions/addendums/team_start_and_release.md
-M	dev/build/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md
-M	dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md
+M	dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md
 M	dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md
-M	dev/build/ProjectInstructions/team_assignments/ACTIVE_TEAM_REGISTRY.md
-M	dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
-M	dev/build/ProjectInstructions/team_assignments/team_ownership.md
 
 Working tree status at report generation:
-M  dev/build/ProjectInstructions/PROJECT_STATE.md
-M  dev/build/ProjectInstructions/TEAM_START_COMMANDS.md
-M  dev/build/ProjectInstructions/addendums/branch_lock_governance.md
-M  dev/build/ProjectInstructions/addendums/multi_team.md
-M  dev/build/ProjectInstructions/addendums/naming_registry.md
+M  dev/build/ProjectInstructions/PROJECT_INSTRUCTIONS.md
+M  dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md
 M  dev/build/ProjectInstructions/addendums/pr_workflow.md
-M  dev/build/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
-M  dev/build/ProjectInstructions/addendums/team_backlog_sod_eod_standard.md
-M  dev/build/ProjectInstructions/addendums/team_release_readiness.md
-M  dev/build/ProjectInstructions/addendums/team_start_and_release.md
-M  dev/build/ProjectInstructions/addendums/tool_mvp_stacked_pr_standard.md
-M  dev/build/ProjectInstructions/backlog/BACKLOG_MASTER.md
+M  dev/build/ProjectInstructions/bootstrap/codex_start_of_day_bootstrap.md
 M  dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md
-M  dev/build/ProjectInstructions/team_assignments/ACTIVE_TEAM_REGISTRY.md
-M  dev/build/ProjectInstructions/team_assignments/TEAM_ASSIGNMENTS.md
-M  dev/build/ProjectInstructions/team_assignments/team_ownership.md