question-me

Interview a spec to surface hidden requirements and produce spec-refined.md.

2|Updated Sep 28, 2025
One-click install
npx skills add https://github.com/abhay-rana/create-modern-react --skill question-me
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: question-me
Source: https://github.com/abhay-rana/create-modern-react/tree/main/.claude/skills/question-me
Command: npx skills add https://github.com/abhay-rana/create-modern-react --skill question-me

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides a senior technical architect through a structured Socratic interview to surface implicit assumptions, missing requirements, and potential edge cases before code is written.

Core Features & Use Cases

  • Guided Interview Protocol: Enforces cycles of 2-3 non-obvious questions at a time to elicit unstated assumptions and risk factors.
  • Phase-based Analysis: Breaks down the spec review into Load & Analyze, Interview Protocol, and Synthesis phases, culminating in a refined spec document.
  • Output Synthesis: Produces a consolidated spec-refined.md capturing decisions, tradeoffs, and open questions for stakeholders.

Quick Start

Initiate the skill on a target spec file. The system will guide the first question cycle and progressively generate spec-refined.md.

Frequently Asked Questions about question-me

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

FAQPage Schema
How do I surface hidden requirements and edge cases in a software spec before implementation?

A Socratic spec analysis identifies hidden requirements by applying a structured interview protocol to your specification. It surfaces implicit assumptions and missing constraints through non-obvious questions, yielding a refined specification with clear tradeoffs before development begins.

What is the best way to analyze architecture assumptions and missing constraints in a project spec?

Analyzing architecture assumptions is best achieved through a phase-based Socratic interview. This method breaks down spec review into Load, Interview, and Synthesis phases, systematically extracting unstated risk factors and documenting them for stakeholder alignment.

How do I start a Socratic interview for requirements analysis on an existing spec?

To start a Socratic interview for requirements analysis, initiate the process on your target spec file. The system automatically guides the first question cycle, asking 2-3 non-obvious questions at a time to elicit unstated assumptions before progressing to synthesis.

What output format does Socratic spec analysis produce for documenting decisions and tradeoffs?

Socratic spec analysis produces a consolidated Markdown file named spec-refined.md. This output document captures all extracted decisions, tradeoffs, and open questions, providing a clear, actionable specification for stakeholders and developers.

When should I use Socratic requirements analysis instead of direct implementation?

Use Socratic requirements analysis when your spec is ambiguous or high-risk and you need to surface edge cases before coding. It enforces safety and anti-pattern checks to deliver a clear specification, preventing costly architectural rework later.