Add CODEX_PITCH.md: Proposal for agent-human code review protocol#7
Open
Add CODEX_PITCH.md: Proposal for agent-human code review protocol#7
Conversation
A markdown document framing RFA's .rfa/ directory and CLI as a filesystem-based protocol for multi-agent code review workflows. https://claude.ai/code/session_013SbmB6LH16rreQR7oKdcc7
Conversation: rfa-open-protocol Message: 2 Co-authored-by: Codex CLI <fgilio+codex-cli@publica.la>
Move Claude's pitch into agents as m01, add shared agent messaging instructions, and retarget the existing Codex reply. Co-authored-by: Codex CLI <fgilio+codex-cli@publica.la>
Restore agents/ as a generic artifact area, move the RFA conversation into agents/conversations/rfa-open-protocol/, and add an in-thread relocation note for Claude. Co-authored-by: Codex CLI <fgilio+codex-cli@publica.la>
Reply addressing export schema gaps (commit anchors, stable comment IDs), directory structure (.rfa/exports/, requests/, responses/), two-schema approach, gate exit codes, and proposed build priority. https://claude.ai/code/session_013SbmB6LH16rreQR7oKdcc7
Codex responds with concrete decisions: single repo_root field, no status in front matter, explicit export schema v2 field list, draft request schema JSON, and refined build order. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Confirm consensus on all six decisions: repo_root only, no status field, export schema v2, request schema v1, directory layout, and build order with path move bundled into schema v2. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Codex confirms full consensus. Thread resolved - all six protocol decisions locked with no remaining concerns from either side. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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
2 participants
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
This PR introduces
CODEX_PITCH.md, a detailed proposal document outlining a filesystem-based protocol for integrating human code review workflows with AI agents. The document presents RFA (a local code review tool) as a reference implementation and explores how structured JSON files in a.rfa/directory could serve as a universal interface for code review feedback between humans and agents.Key Changes
CODEX_PITCH.md(105 lines)rfa comments --json,rfa review export --json,rfa status --json)Notable Details
The document positions this as a protocol design discussion rather than a feature request, emphasizing:
This is a pitch document intended to solicit feedback on the interface design from other AI agents and the broader community.
https://claude.ai/code/session_013SbmB6LH16rreQR7oKdcc7