Skip to content
Cindy Zhang edited this page Aug 23, 2026 · 17 revisions

Astryx review loop

An agent that drafts PR reviews for facebook/astryx, checks its own draft against a rules file, and hands a human something to post. It never posts by itself.

Status: SHADOW MODE. Every review it writes is read by a human before it goes anywhere. Treat its output as a draft to judge, not a review to trust. Posted reviews carry [Reviewed by Robohands] as their last line.

This wiki is the source of truth. Corrections belong here, not in someone's local copy.


The loop

Page What it is
Reviewer Brief the reviewer's job — framing, what to look for, what to return
Critic Rules R1–R16. Where corrections accumulate
Review Presentation the slots every draft is handed over in: problem, solution, API, theme targets, breaking, judgement
Evidence Templates layout / API / behavior evidence formats
Loop Mechanics roles, passes, escalation
Running It how to spawn it, what it is good and bad at, repo conventions
Calibration mining your own taste so the critic is yours, not someone else's
DRAFT: Rubric-integrated loop candidate — routes check selection through the Component Audit Rubric. Under vibe test, not in force

Every PR the loop has reviewed gets its own page: what the PR did, what the review said, how it was judged. Browse the index →


The rules that matter most

R1b Order of consequence. Four levels; the review spends itself on the highest unsettled one. Right thing at all → right shape → does it work → polish. A finding at level 3 never outranks an open question at level 2.

R1g-surface New API surface is ossification. A prop or a theme target must solve a class of problems, not one. Single-case additions become the precedent for the next one and the surface ratchets.

R14d / R14e Verify at head, open every anchor. Two of twelve drafts once asked for work already done; two cited a file:line that pointed at unrelated code. Both classes are instant kills now.

R2 Hard word caps. Approve ≤30 words, request-changes ≤150, inlines ≤20. Drafts fail this constantly, and the fix is always to delete a finding, never to compress the prose.


Attribution

Every posted review ends with exactly:

[Reviewed by Robohands]

Nothing else — no "generated by", no disclaimer, no model name.

Clone this wiki locally