Verified:GitHub

reversa-clarify

Generate clarifying questions and update requirements.md with user answers.

Updated May 13, 2026

Search Tags:#gap analysis #question generation #requirements clarification #reversa #planning readiness #policy-driven development #requirements updating

Ready to run

npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-clarify-cliffthelin

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: reversa-clarify
Source: https://github.com/cliffthelin/AXiomEngine/tree/main/skills/reversa/reversa-clarify
Command: npx skills add https://github.com/cliffthelin/AXiomEngine --skill reversa-clarify-cliffthelin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes uncertainty in requirements by asking the most important clarifying questions and then updating the active requirements document with the user’s answers so planning can proceed with confidence.

Core Features & Use Cases

Detects ambiguity drivers in a requirements.md file, including explicit [DÚVIDA] markers, vague wording, undefined terms, and missing edge cases.
Generates up to five prioritized clarifying questions (multiple choice or short answer) based on an internal taxonomy of planning-critical concerns.
Integrates answers back into requirements.md by creating/updating the Esclarecimentos section, rewriting the affected requirements sections, and updating the Lacunas section accordingly.
Persists changes atomically and provides a final status report plus the next-step recommendation (/reversa-plan or another /reversa-clarify).

Quick Start

Run reversa-clarify to resolve open points in your active requirements before planning.

Frequently Asked Questions about reversa-clarify

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

FAQPage Schema

How do I resolve ambiguous requirements before starting the planning phase?▼

To resolve ambiguous requirements before planning, you can generate targeted clarifying questions and write the answers directly back into the active requirements document. This updates vague sections and missing edge cases atomically.

What is requirements clarification and gap analysis in forward cycle planning?▼

Requirements clarification and gap analysis is the process of detecting ambiguity drivers like vague wording or open points in a requirements file, then generating prioritized questions to fill those gaps before development planning begins.

How do I update a requirements document with answers to open points and doubt markers?▼

You update a requirements document with answers by applying clarifying hooks, rewriting affected requirement sections atomically, and creating an Esclarecimentos section while updating the Lacunas gap section accordingly.

When do I need to run a requirements clarification process during my development cycle?▼

You need to run a requirements clarification process during forward cycle planning, specifically after generating initial requirements and before creating a plan, when the requirements include open points or doubt markers.

Can I use automated question generation for requirements updating without external dependencies?▼

Yes, you can use automated question generation for requirements updating without external dependencies. The skill operates standalone by reading local state files and applying internal taxonomies to produce prioritized clarifying questions.

What happens if my requirements still have gaps after running a clarification pass?▼

If requirements still have gaps after a clarification pass, the system outputs a final status report recommending another round of clarification to resolve remaining open points before proceeding to the planning phase.