reversa-framer

Separates problems from disguised solutions and produces a structured framing.md document.

1.5k|405|Updated Apr 26, 2026
One-click install
npx skills add https://github.com/sandeco/reversa --skill reversa-framer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-framer
Source: https://github.com/sandeco/reversa/tree/main/agents/reversa-framer
Command: npx skills add https://github.com/sandeco/reversa --skill reversa-framer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often start ideation with a solution disguised as a problem, leading to building the wrong thing. This Skill acts as the first agent of the Reversa Ideation Team, forcing a clear separation between the actual pain point and the proposed solution before any exploration begins.

Core Features & Use Cases

  • Problem vs. Solution Classification: Analyzes the session's idea.md and flags when the input is a solution rather than a problem, without blocking the pipeline.
  • Structured Framing Interview: Asks five targeted questions covering the pain, who suffers it, when it occurs, the cost of inaction, and the job to be done, with a 10-turn limit.
  • Traceable framing.md Output: Generates a framing.md document in the active ideation session directory with all sections marked as planned (🟡) and explicit [INDEFINIDO] markers for unanswered items.
  • Use Case: A product manager starts a Reversa ideation session with "I want a dashboard". The Framer detects this is a solution, interviews the user to uncover the underlying pain, and records a validated problem statement with the job-to-be-done for the next pipeline stage.

Quick Start

Run the reversa-framer agent after starting an ideation session with /reversa-brainstorm to classify the idea and generate the framing.md document.

Frequently Asked Questions about reversa-framer

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

FAQPage Schema
How do I validate a product idea before building a solution?

Use a framing step that classifies the input as a problem or a disguised solution, then interview stakeholders about the pain, who suffers it, when it occurs, and the cost of inaction. This Skill automates that interview and records results in framing.md.

What is a job to be done statement in product discovery?

A job to be done statement follows the format: when <situation>, I want <motivation>, so I can <outcome>. The Framer asks the user to complete this sentence and records it in the framing document as a planned item subject to validation.

Does reversa-framer work without an active ideation session?

No. It requires .reversa/active-ideation.json created by running /reversa-brainstorm first. If no active session exists, it stops and instructs the user to start one before proceeding.

What happens if framing.md already exists in the session?

The agent asks for explicit confirmation before overwriting. Without an explicit yes, it terminates without writing anything, protecting previously generated framing work.

Can the Framer modify project code or other files?

No. Its absolute rule restricts writes to the session's framing.md and the current-stage field of active-ideation.json. It never touches other project files and never produces code.