docs(agents): record session handoff and platform-divergence know-how

[seonghobae]

Appends verified cross-session coordination guidance to AGENTS.md and adds test/agents-session-handoff-contract.test.ts so automatic-succession and unexplained platform-divergence regressions fail executable CI.

The guidance requires a resumed session to compare its local tip/working tree with the live PR head and protected main, forbids treating an ordinary merge as automatic complete succession, keeps both lanes open until every valid delta/test/fixture/contract/evidence item is verified inherited, and requires causal reproduction or isolation before classifying a local failure as platform-only. Push rejection recovery remains ordinary/non-force convergence followed by lane-scoped re-verification.

Current exact is f003c13aa017a97b751f3570c9d9169d6ae8e1b8. Changed paths are exactly AGENTS.md and test/agents-session-handoff-contract.test.ts; this is not a single-file docs-only lane. It does not overlap #559's product-gap baseline authority, #562/#563 reviewer dependency hashes, #564 hourly workflow, #565 token-growth test, or #566 patch-validator workflow/cache contracts.

Keep Draft until unchanged exact f003c13aa017a97b751f3570c9d9169d6ae8e1b8 receives terminal SUCCESS for application CI, reviewer-ci, required Security Scan, and patch-validator-image and fresh review is clean. Predecessor/local evidence does not transfer.

Summary by CodeRabbit

• 문서

  • 세션 간 작업 인수인계 절차를 보강했습니다.
  • 브랜치 동기화, 푸시 전 확인, 충돌 발생 시 병합 및 검증 절차를 명확히 했습니다.
  • macOS와 CI 환경 간 테스트 차이를 재현하거나 원인별로 격리하도록 안내를 추가했습니다.

• 테스트

  • 인수인계 지침이 필수 검증 항목과 플랫폼별 실패 처리 원칙을 포함하는지 자동으로 확인합니다.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: 3564df94-10d8-4125-8ade-136d600a03b5

📥 Commits

Reviewing files that changed from the base of the PR and between e3aa77c and f003c13.

📒 Files selected for processing (2)

• AGENTS.md
• test/agents-session-handoff-contract.test.ts

---

📝 Walkthrough

Walkthrough

AGENTS.md에 세션 인계와 플랫폼별 테스트 지침을 추가합니다. 새 Vitest 테스트는 인계 완료와 플랫폼 차이 처리에 필요한 문구 및 금지 문구를 검증합니다.

Changes

세션 인계 지침

Layer / File(s)	Summary
인계 지침 및 계약 검증 AGENTS.md, test/agents-session-handoff-contract.test.ts	AGENTS.md에 PR head와 main 비교, 양쪽 작업 유지, push 전 fetch, 비강제 병합, RED/GREEN 커밋, gh pr view 재확인, 플랫폼별 테스트 처리 규칙을 추가합니다. Vitest 테스트는 필수 문구와 금지 문구를 확인합니다.

Estimated code review effort: 1 (Trivial) | ~5 minutes

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/agent-session-coordination-knowhow

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[chatgpt-codex-connector]

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-09T02:57:56.959839Z	f003c13	Draft marked ready

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