Skip to content

docs(agents): add exact-head PR playbook - #1558

Draft
seonghobae wants to merge 4 commits into
developfrom
codex/agent-pr-loop-playbook
Draft

seonghobae wants to merge 4 commits into
developfrom
codex/agent-pr-loop-playbook

Conversation

@seonghobae

@seonghobae seonghobae commented Sep 4, 2026 •

Copy link
Copy Markdown
Contributor

Current exact state

  • protected base: develop@042b0c70531b229af3acbd0421a2f23098d848b3
  • exact branch head: e5c5eee14050db40ae54ac1b33319b8c2feb7478
  • lifecycle: Draft / source-review repairs current / hosted review and governance evidence incomplete
  • scope: AGENTS.md only

This lane documents the exact-head PR execution playbook, repository-local skill usage, CodeGraph availability fallback, bounded retry behavior, succession rules, review-only agent separation, and truthful commit/merge-ref provenance.

Fresh verification distinguishes authored branch commits from GitHub generated merge refs. The actual head commit e5c5eee... contains both Assisted-by: OpenAI Codex and Signed-off-by: Seongho Bae <me@seonghobae.me>. Findings that treated generated PR merge refs (0405b8b..., d2ab066...) as authored branch heads were answered with current commit-object evidence and resolved. The current source also retains bounded validation retries for truncated API/archive responses and keeps CodeGraph/shared-skill requirements conditional when unavailable.

Author-side governance tests (35 passed) and diff-check evidence remain useful source evidence, not protected merge authority. CodeRabbit review capacity is currently exhausted and the live Naruon ruleset still requires one approval, dismisses stale reviews, requires thread resolution and last-push approval, with no bypass actor. Keep this PR Draft until one unchanged head has every then-live hosted required check terminal-success and effective governance is satisfiable without fabricated/self approval.

No no-op requeue commit, self-approval, bot-as-human substitution, gate weakening, admin bypass, force-push, destructive rebase, or predecessor evidence transfer.

Record required skills, isolated worktree practice, evidence-backed verification, succession rules, and truthful attribution.

Assisted-by: OpenAI Codex
Signed-off-by: Seongho Bae <me@seonghobae.me>
@coderabbitai

coderabbitai Bot commented Sep 4, 2026 •

Copy link
Copy Markdown
Contributor

Important

Approval pending

CodeRabbit has no unresolved comments, but it has not reviewed the latest commit.

Use the checkbox below to review the latest commit. CodeRabbit will approve the changes if it finds no blocking issues.

  • 🔍 Trigger review

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Sep 4, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-09-04T13:18:28.320102Z e5c5eee New commits
ℹ️ 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" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@seonghobae
seonghobae marked this pull request as draft September 4, 2026 11:47

@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: 31334f9eb7

ℹ️ 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".

Comment thread AGENTS.md
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
Add portable fallbacks, scope mutation steps away from review-only agents, align robot evidence with the active gate, and cite NIST SSDF.

Assisted-by: OpenAI Codex
Signed-off-by: Seongho Bae <me@seonghobae.me>
Route same-head infrastructure retries through existing runs or one official central scheduler dispatch, and preserve source history when the organization Actions queue is already verified.

Assisted-by: OpenAI Codex
Signed-off-by: Seongho Bae <me@seonghobae.me>
@seonghobae
seonghobae marked this pull request as ready for review September 4, 2026 12:37

@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: 3d9ea27d42

ℹ️ 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".

Comment thread AGENTS.md Outdated
Comment thread AGENTS.md
Comment thread AGENTS.md Outdated
Permit bounded validation for truncated GitHub responses and distinguish generated merge refs from AI-authored commits.

Assisted-by: OpenAI Codex
Signed-off-by: Seongho Bae <me@seonghobae.me>

@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: e5c5eee140

ℹ️ 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".

Comment thread AGENTS.md
Comment thread AGENTS.md
@seonghobae

Copy link
Copy Markdown
Contributor Author

Current ref evidence: refs/pull/1558/head is author commit e5c5eee14050db40ae54ac1b33319b8c2feb7478, which contains both Assisted-by: OpenAI Codex and Signed-off-by. The cited d2ab06698039575c309435fd47bc55a4101f1e13 is no longer a Git object exposed by the repository (REST returns 404) and was a transient GitHub-generated merge ref, not the author head. GitHub has since regenerated refs/pull/1558/merge as f49a8a98d19cf547ff1f75416acf339011144c50; generated merge refs are transport evidence verified by parent/tree and are not rewritten as authored commits. The PR authority block correctly names current author head e5c5eee...; hosted current-head checks and independent approval remain pending.

@seonghobae

Copy link
Copy Markdown
Contributor Author

#1566의 exact head 27211368e3885525746b542fa6d35162ebddabde가 이 PR의 유효 절차를 포함합니다. 최신 develop을 base로 한 단일 AGENTS.md PR에 exact-head, CI 재시도, succession, attribution, SSDF 규칙을 통합했고 문서 계약 테스트 51개를 통과했습니다. 중복 Checks를 줄이기 위해 verified successor로 닫습니다.

@seonghobae seonghobae closed this Sep 4, 2026
@seonghobae

Copy link
Copy Markdown
Contributor Author

정정: 계승 PR #1566의 실제 원격 exact head는 27211368f1915ffdad496e2b5e2b17df5e9bf7eb입니다. 앞선 코멘트의 잘못된 전체 SHA는 폐기합니다.

@seonghobae seonghobae reopened this Sep 4, 2026
@seonghobae seonghobae added documentation Improvements or additions to documentation priority: medium Normal-priority or P2 work type: docs Documentation, ADR, PRD, or technical writing labels Sep 7, 2026 — with ChatGPT Codex Connector

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation priority: medium Normal-priority or P2 work type: docs Documentation, ADR, PRD, or technical writing

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant