Verified:GitHub

reversa-clarify

Generates targeted questions to resolve ambiguities in requirements documents and integrates answers into requirements.md.

Updated May 8, 2025

Search Tags:#requirements #clarification #document integration #reversa framework #forward engineering

Ready to run

npx skills add https://github.com/ggazzo/brewpilot --skill reversa-clarify-ggazzo

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires reversa, and includes scripts (resource) components.

What problem does it solve?

The Skill unit 'reversa-clarify' addresses the challenge of resolving ambiguities in requirements documents, ensuring clarity before planning. It helps users identify and answer open questions before proceeding to the planning phase.

Core Features & Use Cases

Ambiguity Resolution: Generates targeted questions to address unclear points in requirements.
Integration: Integrates user responses directly into the requirements.md file.
Use Case: Ideal for developers and project managers working on software features, who need to ensure requirements are well-defined before moving forward with implementation.

Quick Start

Run the command "/reversa-clarify" to generate questions for clarifying requirements.

Frequently Asked Questions about reversa-clarify

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

FAQPage Schema

How do I resolve ambiguities in software requirements before planning?▼

To resolve ambiguities in requirements, generate up to five targeted questions addressing unclear points, then integrate the answers directly back into your requirements document to ensure clarity before planning.

Can I integrate clarification answers directly into a requirements.md file?▼

Yes, you can integrate clarification answers directly into a requirements.md file. This ensures that resolved ambiguities are documented in context, keeping the requirements file updated for downstream planning.

Does the Reversa framework support requirements clarification during forward engineering?▼

Yes, the Reversa framework supports requirements clarification during the forward engineering phase by generating targeted questions to resolve open points before proceeding to implementation.

What's the best way to identify open questions in a requirements document?▼

The best way to identify open questions is to analyze the requirements document for ambiguities and automatically generate up to five targeted questions to clarify those undefined points before moving forward.

Do I need specific coding agents to automate requirements clarification?▼

You can use compatible coding agents like Claude Code, Codex, Cursor, or Gemini CLI to automate requirements clarification, ensuring your environment supports these tools for generating and integrating questions.

When should I not use automated requirements clarification?▼

You should not use automated requirements clarification if your requirements are already fully defined and unambiguous, or if you are outside the forward engineering phase where targeted question generation is optimized.