reversa-arbiter

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

Updated Jun 12, 2026
One-click install
npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-arbiter-lacsousa
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: reversa-arbiter
Source: https://github.com/lacsousa/mediclaw-system/tree/main/.agents/skills/reversa-arbiter
Command: npx skills add https://github.com/lacsousa/mediclaw-system --skill reversa-arbiter-lacsousa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Teams often jump from brainstorming to building without an explicit, documented decision. This Skill converges an ideation session by scoring each option against fixed criteria, making a recommendation with explicit trade-offs, and recording the user's final choice as an auditable human decision. ## Core Features & Use Cases - Structured Scoring: Rates each option from options.md on job-to-be-done fit, effort, residual risk, and legacy cost using fixed 1-5 scales with no weighting negotiation. - Explicit Trade-off Recommendation: Produces a recommendation that names what is lost, under what condition it would change, and what to test before committing. - Human Decision Recording: Presents a decision menu, waits for explicit user input, and writes decision.md with the scorecard, recommendation, divergence notes, and accepted risks. - Use Case: After running framing, exploration, and risk-challenge stages of an ideation session, invoke this Skill to converge on one option and produce a decision.md artifact that the pre-spec stage consumes. ## Quick Start Run the reversa-arbiter skill to score the options in my active ideation session and record 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 converge an ideation session into a documented decision?▼

Run this Skill after the framing, options, and risks stages exist in the session directory. It scores each option on four fixed criteria, recommends one with explicit trade-offs, and writes decision.md only after you explicitly choose an option.

What criteria does the Arbiter use to score options?▼

It scores each option from 1 to 5 on job-to-be-done fit, effort, residual risk, and legacy cost, then sums without weighting. Ties are recorded as legitimate results rather than broken artificially.

What happens if risks.md is missing from the session?▼

The Skill stops and instructs you to run the challenger stage first. It requires framing.md, options.md, and risks.md in the active session directory before it can score anything.

Can the Arbiter decide on behalf of the user?▼

No. It only recommends; the decision section of decision.md is written solely after an explicit user response. If you choose against the recommendation, your choice is recorded as the decision and the recommendation as a divergence.

What files does this Skill write to?▼

It writes only decision.md in the session directory and updates the current-stage field in active-ideation.json. It never modifies other project files and never produces code.