Skip to content

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

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
seonghobae merged 4 commits into from
Sep 6, 2026
+25 −1
Merged

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

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
5e49c9a
docs(agents): add cross-session coordination know-how
claude Sep 5, 2026
bd5594b
merge: restack #552 on protected reviewer truth
seonghobae Sep 6, 2026
a0d8e40
merge(context-fabric): restack agent coordination docs on protected c…
seonghobae Sep 6, 2026
1870679
merge: converge cross-session guidance onto protected #533 truth
seonghobae Sep 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
25 changes: 24 additions & 1 deletion AGENTS.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -110,4 +110,27 @@ As of 2026-08-04, code-owner review requirements (`require_code_owner_reviews` i
protection, `require_code_owner_review` in rulesets) are disabled across the ContextualWisdomLab
org: there is a single maintainer (solo developer), so a code-owner approval gate can never be
satisfied. This is ON HOLD until the org has multiple maintainers — do NOT re-enable these
settings or add CODEOWNERS-based merge gates before then.
settings or add CODEOWNERS-based merge gates before then.

## Cross-session coordination

- Independently-scheduled agent sessions across the ContextualWisdomLab org share this GitHub
account, share no memory, and have no live channel between them (a `ListAgents`-style lookup
from inside a session finds no other reachable session): the repo's own PR/issue/branch history
is the only coordination layer that persists across sessions. `ContextualWisdomLab/.github`'s
`AGENTS.md` "Verification discipline" section (present as of this checkout) covers the same root
condition from the angle of not under-claiming another session's progress — "I have not touched
X" is not evidence X is untouched. The practical complement for this repo: before starting work
that could overlap another session's, check for an existing claim (open PR, issue, or
in-progress branch); record reusable operational know-how in a repo's own
`AGENTS.md`/`CLAUDE.md` rather than only in a PR comment.
- This repo holds no upstream LLM provider keys and calls `contextual-orchestrator` exclusively
for every LLM path it participates in — already documented above in this file's "LLM gateway"
section and in `CLAUDE.md`'s "What noema is" section. That makes this repo architecturally out
of scope for the central review sidecar/egress gap tracked in
`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.
Comment on lines +131 to +136

@devin-ai-integration devin-ai-integration Bot Sep 6, 2026

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.

1 change: 1 addition & 0 deletions CLAUDE.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -52,3 +52,4 @@ Key internal conventions in the runtime composition:
- Docs in `docs/` and the changelog are largely Korean (operations, sales/acquisition-readiness package); code, code comments, and AGENTS.md are English. Match the language of whatever you are editing.
- API behavior is under a stability contract (`docs/api-spec.md`, `docs/api-stability-contract.md`); changes to `/exchange` semantics or the response envelope need corresponding doc and smoke-check updates.
- Security posture is fail-closed everywhere (audits, KPI gates, OIDC checks). Prefer adding a regression test over relaxing a check.
- See `AGENTS.md`'s "Cross-session coordination" section for the cross-session agent-coordination convention and this repo's out-of-scope status on the central review sidecar/egress gap (`ContextualWisdomLab/.github#1759`).
Loading