docs: add remote-only claim coordination mode#1724
Merged
Conversation
…ation File a visible Codex claim before editing the standalone claim protocol. The goal is to remove local broadcast/heartbeat as any hidden dependency for remote agents. Co-Authored-By: Codex <noreply@openai.com>
Make the claim protocol sufficient for agents that do not share a local filesystem, heartbeat directory, broadcast bus, or GitHub-specific host. Remote git remains the lock and minimum message bus; host surfaces such as GitHub are adapters, with Zeta's future native host kept as the long-horizon target. Also add B-0209 to test remote-only background agents that are deliberately denied local broadcast access and to scout reliable low-cost model/harness combinations. Co-Authored-By: Codex <noreply@openai.com>
Release the Codex claim in the same branch as the remote-only protocol update. Co-Authored-By: Codex <noreply@openai.com>
There was a problem hiding this comment.
Pull request overview
Adds a first-class “remote-only” mode to the agent claim protocol so claim coordination works even when agents do not share local filesystem/broadcast state, and records follow-on work as a new backlog row.
Changes:
- Documented a new “Remote-only / no shared filesystem mode” in
docs/AGENT-CLAIM-PROTOCOL.md, including remote-ref discovery and git-only progress signaling. - Added backlog item B-0209 describing a background-agent test matrix for proving remote-only coordination.
- Updated the generated backlog index entry for B-0209.
Reviewed changes
Copilot reviewed 3 out of 3 changed files in this pull request and generated no comments.
| File | Description |
|---|---|
| docs/backlog/P2/B-0209-remote-only-background-agent-test-matrix-and-model-scouting-2026-05-06.md | New P2 backlog row defining the remote-only background-agent test matrix and its long-arc motivation. |
| docs/BACKLOG.md | Adds the B-0209 index entry linking to the new per-row backlog file. |
| docs/AGENT-CLAIM-PROTOCOL.md | Adds remote-only mode guidance and links it from the TL;DR flow to make remote coordination explicit and git-first. |
2 tasks
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Verification
git diff --checkbunx markdownlint-cli2 docs/AGENT-CLAIM-PROTOCOL.md docs/BACKLOG.md docs/backlog/P2/B-0209-remote-only-background-agent-test-matrix-and-model-scouting-2026-05-06.mdbun tools/hygiene/check-role-ref-on-current-state-surfaces.ts(soft-launch exit 0; existing unrelated violations remain)