Skip to content

PR_26179_OWNER_011-team-stacked-pr-policy#256

Merged
ToolboxAid merged 1 commit into
mainfrom
PR_26179_OWNER_011-team-stacked-pr-policy
Jun 28, 2026
Merged

PR_26179_OWNER_011-team-stacked-pr-policy#256
ToolboxAid merged 1 commit into
mainfrom
PR_26179_OWNER_011-team-stacked-pr-policy

Conversation

@ToolboxAid

Copy link
Copy Markdown
Owner

PR_26179_OWNER_011-team-stacked-pr-policy Report

Purpose

Update active Project Instructions so OWNER may create independent PRs from main, while non-Owner teams use stacked PR workstreams by default.

Branching Model

Governance Outcome

  • OWNER PRs may start from synchronized main when independent and no direct dependency exists.
  • Non-Owner team PRs use Stacked PR workstreams by default.
  • Non-Owner team PRs may start from main only when OWNER explicitly marks the PR as standalone/no-dependency.
  • Stacked PRs still must document dependency order, review order, and merge order.
  • Codex must hard-stop when a branch/model mismatch is detected.
  • Missing ZIP output is clarified as an incomplete Codex run.

Updated Documents

  • dev/build/ProjectInstructions/addendums/pr_workflow.md
  • dev/build/ProjectInstructions/addendums/project_instructions_single_source_eod_lock.md
  • dev/build/ProjectInstructions/addendums/branch_lock_governance.md
  • dev/build/ProjectInstructions/addendums/branch_context_governance.md
  • dev/build/ProjectInstructions/standards/CODEX_WORKFLOW_COMMANDS.md
  • dev/build/ProjectInstructions/TEAM_START_COMMANDS.md
  • dev/build/ProjectInstructions/addendums/codex_artifact_and_reporting_standard.md

Runtime Impact

None. This PR changes documentation/governance only.

ZIP

  • dev/workspace/zips/PR_26179_OWNER_011-team-stacked-pr-policy_delta.zip

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 154f027bf1

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".


OWNER PRs may start from synchronized `main` when marked Independent and no direct dependency exists.

A non-Owner team PR may start from `main` only when OWNER explicitly marks the PR as `standalone/no-dependency`. Otherwise, non-Owner team PRs use Stacked PR workstreams by default and must start from the active team workstream branch or documented previous PR branch.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Permit first stacked workstream branch from main

For a non-Owner team starting the first PR in a new stacked workstream, this file's Team Branch Creation Gate still requires the initial branch to be created only after the main checks pass, but this new rule makes any non-Owner start from main require standalone/no-dependency and otherwise requires an active workstream or previous PR branch. In that first-stack scenario neither a previous branch nor an active workstream branch exists yet, so valid new non-Owner stacks will hard-stop unless they are incorrectly reclassified as standalone; carve out the first PR in a new stacked workstream from this prohibition.

Useful? React with 👍 / 👎.

Rules:
- Stacked PRs may start from the previous PR branch when there is a direct dependency.
- Non-Owner team PRs should use Stacked PR workstreams by default.
- A Stacked PR belongs under the active team workstream and must use the documented previous PR branch or active workstream branch as its starting point.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Permit active workstream branch starts

When a stacked PR is meant to continue from an active team workstream branch that is not itself the documented previous PR branch, this new alternative is immediately contradicted by the existing hard-stop rule below that only permits the documented previous PR branch. As written, Codex will still hard-stop for the active-workstream branch path introduced here; update the mismatch rule to accept the documented active workstream branch as well.

Useful? React with 👍 / 👎.

@ToolboxAid ToolboxAid changed the base branch from PR_26179_OWNER_011-pr-branching-model-docs to main June 28, 2026 15:34
@ToolboxAid ToolboxAid merged commit eb36313 into main Jun 28, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant