Skip to content

docs(adr): 0009 — comments are sent, not dumped: a two-way review loop (proposed) - #48

Merged
folded merged 1 commit into
mainfrom
docs/adr-0009-two-way-review-loop
Sep 7, 2026
Merged

folded merged 1 commit into
mainfrom
docs/adr-0009-two-way-review-loop

Conversation

@folded

@folded folded commented Sep 7, 2026

Copy link
Copy Markdown
Collaborator

Proposed ADR for #20, merged before the work per the rule in the ADR index. Settled in a grilling session; the decision tree is in the ADR's Decision and Alternatives sections.

  • One comment lifecycle — draft → sent → delivered, with revised/withdrawn — for two counterparts: Claude in review mode, GitHub in PR mode. Send is explicit; the selection is the priority signal.
  • Review mode: scr review detaches; Claude runs scr review --wait <run_id> in the background and is woken per batch; scr comment reply/resolve answers into the thread live; the tab closing ends the session; the review follows the code (last slice).
  • PR mode: Send adds to the GitHub pending review (resumed if present); Submit publishes with Comment / Approve / Request changes; resolve fires immediately; Done, the modal and --yes go; Claude stays out.
  • Slice plan: docs/slices/two-way-review-loop.md (three slices, gated).
  • CONTEXT.md: counterpart, draft, send, sent, delivered, batch, listening, pending review, submit, outdated, addressed.

…p (proposed)

A comment is a draft until the reviewer sends it, delivered once the
counterpart holds it; Claude is the counterpart in review mode, reached
by a detached server and a re-armed background --wait, and answers into
the thread; GitHub is the counterpart in PR mode, through a pending
review and a Submit with a verdict. Done, the modal and --yes go; the tab
closing ends a session. The review follows the code as the last slice.
Settled in a grilling session; resolves #20 once built. Glossary gains
the lifecycle terms.
@folded
folded merged commit d2fbf62 into main Sep 7, 2026
5 checks passed
@folded
folded deleted the docs/adr-0009-two-way-review-loop branch September 7, 2026 10:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant