reversa-arbiter

Scores ideation options against risks and records the human decision in decision.md.

Updated Aug 14, 2026
One-click install
npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-arbiter-ruggery
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-arbiter
Source: https://github.com/Ruggery/OCR_Cartorio/tree/main/.agents/skills/reversa-arbiter
Command: npx skills add https://github.com/Ruggery/OCR_Cartorio --skill reversa-arbiter-ruggery

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often stall between brainstorming and specification because no one converges on a single option with an explicit trade-off. This Skill acts as the Arbiter agent of the Reversa Ideation Team: it scores each option against fixed criteria, recommends one with the trade-off stated plainly, and records the user's choice as a human decision in decision.md. ## Core Features & Use Cases - Fixed-criteria scoring: Rates each option 1-5 on job-to-be-done fit, effort, residual risk, and legacy cost, with no weighting negotiation and legitimate ties preserved. - Explicit trade-off recommendation: States which option wins, what is lost by choosing it, under what condition the recommendation changes, and what cheap test to run before committing. - Human decision recording: Never writes decision.md before an explicit user answer; when the user chooses against the recommendation, it logs the divergence instead of re-arguing. - Use Case: After running brainstorm, explorer, and challenger sessions, a product team invokes the Arbiter to converge three architecture options into one scored decision document, then hands off to /reversa-pre-spec. ## Quick Start Ask the agent to run the Arbiter step on the active ideation session so it scores the options in options.md against risks.md and records my decision in decision.md.

Frequently Asked Questions about reversa-arbiter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I decide between multiple product options after brainstorming?▼

Run the Arbiter step after generating options and risks. It scores each option 1-5 on job-to-be-done fit, effort, residual risk, and legacy cost, then recommends one with the explicit trade-off and waits for your decision before writing decision.md.

What files does the reversa-arbiter skill need to run?▼

It requires .reversa/state.json, .reversa/active-ideation.json, and framing.md, options.md, and risks.md inside the active session directory. If risks.md is missing, it stops and tells you to run /reversa-challenger first.

Can the Arbiter write the decision file without user confirmation?▼

No. It never writes decision.md before an explicit menu response from the user, and silence is not acceptance. If decision.md already exists, it asks for an explicit yes before overwriting.

What happens if I choose an option the Arbiter did not recommend?▼

Your choice is recorded as the decision and the Arbiter's recommendation is logged as a registered divergence, without re-arguing. The scoreboard is never adjusted to match the human choice.

What are the limitations of the Arbiter scoring method?▼

Scores are 1-5 judgments on four fixed criteria summed without weighting, so they reflect structured reasoning rather than quantitative analysis. Ties are legitimate outcomes and are recorded with an explanation of what decides in practice.