gsd-spec-phase

Clarify phase requirements via Socratic questioning and generate SPEC.md.

Updated Jan 28, 2025
One-click install
npx skills add https://github.com/aslaii/dotfiles --skill gsd-spec-phase-aslaii
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-spec-phase
Source: https://github.com/aslaii/dotfiles/tree/main/claude/skills/gsd-spec-phase
Command: npx skills add https://github.com/aslaii/dotfiles --skill gsd-spec-phase-aslaii

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Clarifies phase requirements through Socratic questioning to reduce ambiguity before discuss-phase.

Core Features & Use Cases

  • Structured Socratic questioning to elicit and refine requirements across phases.
  • Ambiguity scoring with a gated SPEC.md generation to ensure falsifiability prior to implementation.
  • Workflow integration: ties spec-phase to discuss-phase, plan-phase, and execute-phase in sequential pipelines.

Quick Start

Identify the phase to refine and run the spec-phase workflow to generate SPEC.md.

Frequently Asked Questions about gsd-spec-phase

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

FAQPage Schema
How do I reduce ambiguity in software specifications before implementation?

To reduce ambiguity in software specifications, Socratic questioning clarifies phase requirements through structured interview rounds. It scores ambiguity levels and enforces a strict gate to generate a falsifiable SPEC.md, ensuring requirements are clear before implementation.

What is Socratic spec refinement and how does it work?

Socratic spec refinement is a process that elicits and refines requirements through structured questioning across software phases. It loads codebase context, runs interview rounds, scores ambiguity, and produces a gated SPEC.md to ensure falsifiability prior to implementation.

How do I generate a falsifiable SPEC.md for my codebase?

You generate a falsifiable SPEC.md by running a spec-phase workflow that loads codebase context and conducts Socratic questioning. The workflow applies a strict gate and commit step, scoring ambiguity to ensure the specification is falsifiable before proceeding.

Can I integrate specification refinement with downstream planning and execution phases?

Yes, specification refinement integrates with sequential pipelines by tying spec-phase to discuss-phase, plan-phase, and execute-phase. After generating the committed SPEC.md, the workflow connects directly to these subsequent steps for continuous development.

When should I use Socratic questioning for software specification workflows?

You should use Socratic questioning for software specification workflows when you need to clarify phase requirements and reduce ambiguity before the discuss-phase. It is essential when producing a falsifiable SPEC.md requires strict gating and context loading across codebases.