interview-user

moughxyz's avatarfrom moughxyz

Interview the user to clarify provided spec.

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 2, 2026

When & Why to Use This Skill

This Claude skill streamlines the software development lifecycle by conducting intelligent user interviews to clarify and refine technical specifications. By investigating the existing codebase and asking targeted questions about architecture, UI/UX, and implementation tradeoffs, it ensures that project requirements are comprehensive, technically sound, and ready for execution.

Use Cases

  • Requirement Clarification: Transforming high-level or ambiguous user requests into detailed, actionable technical specifications through structured interviewing.
  • Architectural Alignment: Investigating current codebase architecture to identify and resolve potential conflicts or integration challenges early in the planning phase.
  • Tradeoff Analysis: Engaging users in deep-dive discussions about technical implementation, UI/UX preferences, and performance tradeoffs to ensure the final product meets all expectations.
  • Spec Documentation: Automatically generating a finalized, clarified specification file that serves as a single source of truth for the development team.
nameinterview-user
descriptionInterview the user to clarify provided spec.
  1. Read the provided spec.
  2. Conduct a codebase investigation to understand the architecture wrt to the user's request.
  3. Once you have a good understanding, interview the user in detail using the AskUserQuestionTool about literally anything:
    1. Technical implementation,
    2. UI & UX,
    3. concerns,
    4. tradeoffs,
    5. etc.
  4. Make sure the questions are not obvious or self-evident. Make default assumptions if the answer seems pretty obvious.
  5. Be in-depth and continue interviewing the user until it's complete, then write the spec to the file.