rfc: 0001 agent architecture v1#497
Draft
Enriquefft wants to merge 2 commits intosiddharthvaddem:mainfrom
Draft
Conversation
Establishes a lightweight RFC convention for the project under docs/rfc/ and lands RFC 0001 as the first entry. Draft, opened for discussion. The RFC proposes the architectural shape for OpenScreen's agent surface (CLI + MCP + future SDK/IPC) before more verbs land on top of siddharthvaddem#350. Nine architectural concerns are catalogued with file:line citations, and a verb-registry shape (defineVerb / executeVerb / StateSource / CommandResult) is sketched as the SSOT for transport fan-out. Companion docs cover (a) the twelve GUI/CLI desync surfaces and an editor-as-server + file-as-persistence + op-log model, and (b) an audit of PR siddharthvaddem#350 grounding the RFC's claims in concrete code. Tracking: siddharthvaddem#349
Contributor
|
Important Review skippedDraft detected. Please check the settings in the CodeRabbit UI or the ⚙️ Run configurationConfiguration used: Organization UI Review profile: CHILL Plan: Pro Run ID: You can disable this status message by setting the Use the checkbox below for a quick retry:
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. Comment |
…ed concerns The index now distinguishes "designed" (state coordination, with companion doc) from "noticed, not yet planned" (two concerns surfaced via filtered review of PR siddharthvaddem#350). Audit doc dropped — PR-review observations belong on PR siddharthvaddem#350 itself, not in the RFC.
This was referenced Apr 27, 2026
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
1 participant
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
Draft RFC proposing a short planning window for the OpenScreen agent surface before more verbs land on top of #350.
Establishes a lightweight RFC convention for the project under
docs/rfc/, with this as 0001.What's in this RFC
The index is intentionally honest about asymmetry: state coordination has a companion doc; the two noticed items are starting points, not designs. The RFC's central proposal is a short planning window, not the items themselves.
Status
Draft. Not asking for merge yet — discussion first. Companion to #349 and #350; review notes on those issues point here.
Test plan