diff --git a/AGENTS.md b/AGENTS.md index c66fef094..1082eb257 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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. \ No newline at end of file +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. \ No newline at end of file diff --git a/CLAUDE.md b/CLAUDE.md index 68035ffba..59e10ffa3 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -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`).