refine-requirements

Refines feature requirements by asking targeted questions and updating tasks via TodoWrite for Rails projects.

14|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/Shoebtamboli/rails_claude_skills --skill refine-requirements-shoebtamboli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refine-requirements
Source: https://github.com/Shoebtamboli/rails_claude_skills/tree/main/lib/generators/claude/skills_library/refine-requirements
Command: npx skills add https://github.com/Shoebtamboli/rails_claude_skills --skill refine-requirements-shoebtamboli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill reduces rework and ambiguity by turning vague or incomplete feature descriptions into a clear set of implementation tasks, acceptance criteria, and updated technical approach.

Core Features & Use Cases

  • Targeted clarification: Asks 3-5 focused follow-up questions to expose missing fields, edge cases, and business rules.
  • Task updates: Analyzes answers and updates or creates TodoWrite tasks with acceptance criteria, dependencies, and ordering.
  • Rails planning templates: Leverages question templates for authentication, CRUD, APIs, background jobs, and UI workflows to guide refinement.

Quick Start

Ask the refine-requirements skill to clarify a feature by saying Refine requirements for [feature name] and answer the follow-up questions.

Frequently Asked Questions about refine-requirements

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

FAQPage Schema
How do I clarify ambiguous feature requirements before implementation?

To clarify ambiguous feature requirements, you need targeted follow-up questions that expose missing fields, edge cases, and business rules. This refinement process turns vague feature descriptions into clear implementation tasks and acceptance criteria.

What is the best way to refine requirements for a Rails application feature?

The best way to refine requirements for a Rails application feature is using planning templates tailored for authentication, CRUD, APIs, background jobs, and UI workflows. These templates guide the clarification process by asking 3-5 focused questions to identify scope and dependencies.

How do I update TodoWrite tasks with new acceptance criteria after a planning session?

You update TodoWrite tasks with new acceptance criteria by analyzing the answers from your clarification questions for scope, dependencies, and technical changes. The analysis results are then used to update or create new tasks with proper ordering.

Can I use requirement refinement templates for existing task-management workflows?

Yes, you can use requirement refinement templates for existing task-management workflows during post-planning sessions. The process applies whenever existing TodoWrite tasks or a new feature need clarification before implementation begins.

How many follow-up questions should I ask to refine a feature scope?

You should ask 3-5 focused follow-up questions to refine a feature scope effectively. This targeted number of questions is sufficient to expose missing fields, edge cases, and business rules without overwhelming the planning process.

What problems does requirement refinement solve in software planning?

Requirement refinement solves the problem of rework and ambiguity in software planning. It transforms incomplete feature descriptions into a clear set of implementation tasks, acceptance criteria, and an updated technical approach before coding starts.