Brainstorm-First
Brainstorm-First is Jorv Builder's universal review principle. Every Mission Board card that lands in Review state opens via a brainstorm conversation in the main Orbit chat — no exceptions.
That includes:
- Audit findings that need triage
- Completed Ralph Loops awaiting merge
- Stuck Ralph Loops needing recovery
- Failed setup cards
- Sprints awaiting sign-off
There is no separate review UX per card type. One mechanism handles them all.
Why?
Traditional review surfaces try to compress decisions into buttons — "Approve / Reject", "Promote to card", "Mark Fixed". They optimise for speed at the cost of reasoning. The "why" of every decision gets lost.
In Jorv Builder, the reasoning happens in the chat, in your own words, with Orbit reading the actual code at HEAD before advising. The conversation is the audit trail. Approvals become side-effects of agreement, not standalone clicks.
What you'll see
When you open a card in Review (click → "Open in Orbit"), Orbit preloads context:
- The card metadata and any findings / build summary
- A mandatory staleness check — Orbit reads the cited files at
current HEAD and checks
git logsince the audit / build started, in case something already addressed the issue - For audit cards: a present-tense Compliance Center summary, so Orbit reasons about the card in the wider compliance context, not in isolation
Then it advises: dismiss as stale, proceed with a fix, modify scope, or promote to a follow-up card. You agree (or push back); the actions land as Brainstorm side-effects via the standard tools.
Honest exceptions
Two affordances exist outside Brainstorm because they're "no code claim" gestures:
- Per-finding Ignore in the Compliance Center (you're saying "I don't care about this", not "I fixed it").
- Card-level Dismiss all & close with a required reason (escape hatch for "accept the risk and move on" — see How-to).
There are no Mark Fixed, Promote to card, Direct Merge, or Direct Discard buttons anywhere on Review cards.