Skip to content

docs(agents): add cross-session coordination know-how - #552

Merged
seonghobae merged 4 commits into
mainfrom
docs/cross-session-agent-knowhow
Sep 6, 2026
Merged

docs(agents): add cross-session coordination know-how#552
seonghobae merged 4 commits into
mainfrom
docs/cross-session-agent-knowhow

Conversation

@seonghobae

@seonghobae seonghobae commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

Scope

Documentation-only cross-session coordination guidance for Noema. Exact source remains 5e49c9af86cc63cd00e4f64fc6298a85c9594b7d: AGENTS.md records repository/PR/issue/branch history as the durable coordination surface available to independent sessions and points to central .github verification discipline; CLAUDE.md points to that section. Provider-key and central review-sidecar migration ownership remains outside Noema; .github#1759 owns orchestrator-free-sidecar migration for central review-pipeline consumers.

Current exact authority — 2026-09-06 KST

  • protected Noema base: main@e1ac9d50f6c646f04be8c137c8acdc7200182fcd;
  • exact PR head: 5e49c9af86cc63cd00e4f64fc6298a85c9594b7d;
  • lifecycle: open / Draft;
  • exact source already has terminal application CI, required Security Scan, patch-validator-image and reviewer workflow success;
  • repository-wide semantic-review prerequisite is fix(reviewer): fail closed on empty CodeGraph semantics #546 exact 95144d5bcf8f1cb4b9a7c552ede66737c23d6bca. The existing reviewer execution predates that repaired semantic-evidence contract reaching protected truth and cannot be promoted to merge-authoritative semantic GREEN.

This PR stays Draft without source churn. After #546 reaches protected truth, regenerate semantic reviewer evidence for this unchanged exact head and re-read live governance before promotion. Do not manufacture a review event with a no-op commit, transfer predecessor semantic authority, self-approve, rewrite history, or move provider/routing authority into Noema.

Append-only addition to AGENTS.md (new "Cross-session coordination"
section) and a one-line CLAUDE.md pointer to it. Documents the
org-wide constraint that independently-scheduled agent sessions
share no memory and no live channel, so repo/PR/issue history is
the only durable coordination layer, and records this repo's
verified-in-checkout out-of-scope status relative to the central
review sidecar/egress migration tracked in
ContextualWisdomLab/.github#1759. No code, workflow, or test
change.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KPmJErfkcHer4UVEgrQxUX
@coderabbitai

coderabbitai Bot commented Sep 5, 2026

Copy link
Copy Markdown

Review Change Stack

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Team

Run ID: d569ef93-261b-4c6f-a3d1-d27c2d53b5a0

📥 Commits

Reviewing files that changed from the base of the PR and between e1ac9d5 and 5e49c9a.

📒 Files selected for processing (2)
  • AGENTS.md
  • CLAUDE.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

에이전트 세션 간 조정 규칙을 AGENTS.md에 추가했습니다. CLAUDE.md는 해당 규칙과 중앙 리뷰 사이드카 범위를 참조합니다.

Changes

세션 조정 문서화

Layer / File(s) Summary
조정 규칙 및 범위 문서화
AGENTS.md, CLAUDE.md
AGENTS.md에 세션 간 조정 방식, LLM 경로, 중앙 리뷰 사이드카 범위를 문서화했습니다. CLAUDE.md는 해당 섹션을 참조합니다.

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

Merge Risk: ⚪ Minimal · up to 5e49c

This change documents cross-session coordination and links the related repository-scope guidance without changing runtime behavior, workflows, credentials, or API contracts. No merge-blocking risk remains.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check. Docstring coverage is scoped to functions touched by this diff. Analyzed 0 functions across 0…
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed 제목은 문서 변경 사항인 AGENTS.md의 교차 세션 조정 지식 추가를 정확하고 간결하게 설명합니다.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs/cross-session-agent-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

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

@seonghobae
seonghobae marked this pull request as ready for review September 5, 2026 14:39
@seonghobae
seonghobae marked this pull request as draft September 5, 2026 15:06
@seonghobae
seonghobae marked this pull request as ready for review September 6, 2026 08:03
@seonghobae
seonghobae merged commit 5b8e620 into main Sep 6, 2026
14 of 16 checks passed
@seonghobae
seonghobae deleted the docs/cross-session-agent-knowhow branch September 6, 2026 08:03

@devin-ai-integration devin-ai-integration 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.

Devin Review found 1 potential issue.

Devin Review

Comment thread AGENTS.md
Comment on lines +131 to +136
`ContextualWisdomLab/.github#1759` (open as of this checkout): that issue is about migrating four
`.github`-side review-pipeline workflow consumers (`noema-review.yml`, `strix.yml`,
`opencode-review-dispatch.yml`, `pr-review-autofix.yml`) — confirmed on `.github`'s `main` to
still call `scripts/ci/contextual_orchestrator_review_sidecar.sh` directly — onto the shared
`orchestrator-free-sidecar` composite action (`.github/actions/orchestrator-free-sidecar/action.yml`,
present on `.github`'s `main`), not this repo's own OIDC-broker `/exchange` path. No newline at end of file

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

🔍 External status claims can become stale

The guidance records issue #1759 as open and describes another repository's current branch. Those unchecked facts can silently invalidate its scope conclusion.

Devin Review

Was this helpful? React with 👍 or 👎 to provide feedback.

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.

2 participants