docs(agents): record restack queue discipline around slow image workflow

[seonghobae]

Follow-up operational guidance from integrating #567/#565/#559/#562, ordinary/non-force reconverged after #566 and again after protected #573. This lane remains limited to AGENTS.md and its executable handoff contract test; it does not own hourly workflow semantics or patch-validator image/runtime provenance.

Fresh review repaired the original authority defect: a slow patch-validator-image blocks only that PR lane while path-isolated work that consumes no mutable authority may continue, but the waiting PR itself requires application CI, reviewer-ci, Security Scan, and patch-validator-image GREEN on one unchanged exact head. Stale branches ordinary/non-force reconverge from live PR head/current protected base; destructive reset/rebase/force-push is forbidden. The executable handoff contract rejects regression to the old gate semantics.

After #573 normally integrated, this branch reconverged without force onto protected main@6e9b68d8302a4c3e8b2af65f592c16e51d368482. Current exact is 902cb600d53966d8a1d18789ab65ac026d0fdf9f. Application CI 34375485743, reviewer-ci 34375485712, Security Scan 34375485753, and patch-validator-image 34375485885 are all SUCCESS on this unchanged exact. There are no unresolved review threads. The prior COMMENTED authority finding is preserved as review provenance and is addressed by the current text/test contract; no self-approval is claimed.

Fresh successor review verified that #570's AGENTS.md contains the complete #572 transitive platform-binding discipline: dependency bumps must re-prove platform bindings, reproduce the WASI materialize battery, pin a still-published binding with lock-version alignment, and regenerate lock plus lockfile policy in one lane. #572 remains open until this exact integrates normally and protected-main comparison confirms complete inheritance of #572's valid delta/test/contract/evidence.

No release authority is inferred.

Summary by CodeRabbit

• 문서

  • 세션 간 작업 조율 지침을 보완했습니다.
  • 느린 이미지 검증 작업의 레인별 처리, 정확한 커밋 기준의 병합 조건, 비파괴적 브랜치 재수렴 및 강제 변경 금지 사항을 명확히 했습니다.
  • 의존성 업데이트 시 전이적 플랫폼 바인딩과 잠금 파일 정합성을 재검증하는 절차를 추가했습니다.

• 테스트

  • 이미지 검증 결과가 해당 PR 레인에만 영향을 주는지와 필수 검사 조건이 문서에 유지되는지 확인하는 검증을 추가했습니다.

[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: e7f3693a-6b1e-4591-abbe-b3f8dea0cd2e

📥 Commits

Reviewing files that changed from the base of the PR and between 6e9b68d and 902cb60.

📒 Files selected for processing (2)

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

---

📝 Walkthrough

Walkthrough

AGENTS.md에 restack 큐 관리와 dependency-bump 검증 지침을 추가했습니다. 관련 계약 테스트는 exact-head 병합 조건과 비파괴 재수렴 규칙을 확인합니다.

Changes

Cross-session coordination 지침

Layer / File(s)	Summary
Restack 큐 규율 AGENTS.md, test/agents-session-handoff-contract.test.ts	느린 patch-validator-image 레인을 분리하고, 지정된 CI 검사가 모두 GREEN인 exact head만 병합하도록 지침을 추가했습니다. stale 브랜치는 비파괴 방식으로 재수렴하며 destructive reset/rebase/force-push를 금지합니다. 계약 테스트가 이 규칙과 중앙 Security Scan 단독 게이트 문구의 제거를 확인합니다.
Dependency-bump 검증 AGENTS.md	transitive platform bindings 변경을 로컬 이미지 materialize 배터리로 재현하도록 지침을 추가했습니다. 게시된 패키지는 lock-version-alignment 회귀 테스트로 명시적으로 고정하고 lock 및 lockfile 변경 정책을 재생성합니다.

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-restack-queue-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.}

[seonghobae]

Current review finding: this AGENTS change weakens Noema's merge evidence contract. The sentence merge GREEN lanes without waiting for the image job: the only required merge gate is the central Security Scan ... while verify/reviewer/image are supporting evidence converts a repository ruleset observation into permission to merge without exact-head application CI/reviewer/image completion. That contradicts the standing commercial-development contract and the repository's established four-gate exact-head evidence discipline. Repair the guidance so slow image execution blocks only that lane's merge authority while other independent lanes remain work-conserving; it must not authorize merging the affected lane before its own exact-head verification set is GREEN. Also avoid ambiguous reset wording for stale branches: require ordinary/non-force reconvergence from the live PR head/base, with no destructive reset/rebase/force-push. Keep Draft until the text and executable contract test encode those semantics and the exact head is revalidated.