gsd-spec-phase

Clarifies project requirements via Socratic interviews and ambiguity scoring.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/nnexai/git-stacks --skill gsd-spec-phase-nnexai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsd-spec-phase
Source: https://github.com/nnexai/git-stacks/tree/main/.codex/skills/gsd-spec-phase
Command: npx skills add https://github.com/nnexai/git-stacks --skill gsd-spec-phase-nnexai

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill resolves ambiguity in project requirements by forcing a structured Socratic interview process before any planning or execution begins.

Core Features & Use Cases

  • Ambiguity Scoring: Quantitatively measures requirement clarity across four dimensions to ensure project readiness.
  • Socratic Interviewing: Uses a multi-round interview loop to uncover hidden assumptions and edge cases.
  • Automated Specification: Generates a formal SPEC.md file that serves as a falsifiable contract for subsequent development phases.

Quick Start

Invoke the spec phase skill by typing the dollar sign followed by gsd-spec-phase and the phase number to begin the requirement clarification process.

Frequently Asked Questions about gsd-spec-phase

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

FAQPage Schema
How do I clarify project requirements before starting software development?

You can clarify project requirements by using a structured Socratic interview process that uncovers hidden assumptions and edge cases. This approach quantitatively measures requirement clarity and generates a formal specification document to gate development progress.

What is Socratic questioning for software requirement specification?

Socratic questioning for software specification is a multi-round interview loop designed to resolve ambiguity in project requirements. It forces structured inquiry to expose hidden assumptions and edge cases before any planning or execution phases begin.

How do I measure ambiguity in software development requirements?

You can measure ambiguity in requirements using quantitative ambiguity scoring across four distinct dimensions. This scoring mechanism evaluates requirement clarity to ensure project readiness and gates progress until specified ambiguity thresholds are met.

How do I generate a falsifiable specification document for software workflows?

You generate a falsifiable specification document by completing a structured requirement clarification process that produces a formal SPEC.md file. This document serves as an explicit contract with defined acceptance criteria for subsequent development phases.

When do I need to perform a requirement specification phase before planning?

You need a requirement specification phase when your software development workflows require high-fidelity specifications before planning or execution. It is necessary to satisfy the need for falsifiable requirements and explicit acceptance criteria.

Can I use quantitative ambiguity scoring to gate my development workflow progress?

Yes, you can gate development workflow progress by applying quantitative ambiguity scoring to requirement clarity. The process blocks progression until ambiguity thresholds are met, ensuring high-fidelity specifications before execution begins.