reversa-clarify

Generate targeted questions to clarify ambiguous requirements and update requirements.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolves ambiguous or missing requirement details by asking targeted questions and integrating the answers back into the active feature’s requirements document.

Core Features & Use Cases

  • Ambiguity detection: Finds explicit [DÚVIDA] markers, vague phrasing, undefined terms, missing edge cases, and coverage gaps in the feature’s requirements.md.
  • Up to five prioritized questions: Produces multiple-choice or short-answer questions (no open-ended questions) ranked by their impact on the eventual plan.
  • Requirement back-integration: Writes resolved answers into requirements.md under ## Esclarecimentos (right before ## Lacunas), removes corresponding [DÚVIDA] items, and updates the remaining gaps.

Quick Start

Use the command reversa-clarify when you want to clarify open points in the requirements before running planning.

Frequently Asked Questions about reversa-clarify

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

FAQPage Schema
How do I clarify ambiguous requirements before creating a forward plan?

Clarifying ambiguous requirements involves generating up to five prioritized questions to resolve gaps in your active requirements document. The process detects vague phrasing, undefined terms, and missing edge cases, ensuring your forward plan has complete coverage before execution.

What is the best way to resolve missing edge cases in feature specifications?

The best way to resolve missing edge cases in feature specifications is by generating up to five prioritized multiple-choice or short-answer questions. This avoids open-ended questions and captures specific answers to update your requirements documentation atomically.

How do I document requirement clarifications and track remaining gaps?

You document requirement clarifications by writing resolved answers into a dedicated section of your requirements document and removing corresponding ambiguity markers. Remaining unresolved items are maintained in a separate gaps section to ensure ongoing tracking of specification issues.

Does requirements clarification work during the active forward planning cycle?

Yes, requirements clarification works specifically during the forward cycle to resolve gaps between active requirements and planning steps for a specific feature. It requires reading state configuration files to locate output folders and validating the presence of active requirements data before proceeding.

What are the limitations of using automated questions for requirements ambiguity detection?

A key limitation is that automated requirements ambiguity detection generates a maximum of five questions and restricts formats to multiple-choice or short answers. It cannot handle open-ended inquiries and relies entirely on existing markers and state files to identify and resolve documentation gaps.