requirement-clarification

star 60

Guidelines for asking clarifying questions when requirements are ambiguous. Use when scope is unclear, multiple approaches exist, or critical details are missing.

eser By eser schedule Updated 1/15/2026

name: requirement-clarification description: Guidelines for asking clarifying questions when requirements are ambiguous. Use when scope is unclear, multiple approaches exist, or critical details are missing.

requirement-clarification

Quick Start

  1. Identify ambiguity -> Formulate specific questions -> Ask before implementing
  2. Ask about scope, edge cases, and trade-offs when unclear
  3. Propose options with trade-offs when multiple approaches exist
  4. Never assume - verify critical decisions with user

Key Principles

  • Ask early: Clarify before writing code, not after
  • Be specific: Ask targeted questions, not vague ones
  • Offer options: Present 2-3 approaches with trade-offs
  • Batch questions: Group related questions together
  • Know when NOT to ask: Skip for trivial/obvious decisions

When to Ask

  • Multiple valid implementations exist
  • Business logic implications unclear
  • Scope boundaries undefined
  • Breaking changes possible
  • Security/performance trade-offs involved

References

See rules.md for question templates and anti-patterns.

Install via CLI
npx skills add https://github.com/eser/aya.is --skill requirement-clarification
Repository Details
star Stars 60
call_split Forks 25
navigation Branch main
article Path SKILL.md
More from Creator