draft-spec

Draft specifications through Socratic questioning of Why, How, and What.

Updated Mar 28, 2026
One-click install
npx skills add https://github.com/jsnbuchanan/claude-code-spec-skills-example --skill draft-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: draft-spec
Source: https://github.com/jsnbuchanan/claude-code-spec-skills-example/tree/main/.claude/skills/draft-spec
Command: npx skills add https://github.com/jsnbuchanan/claude-code-spec-skills-example --skill draft-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Drives a structured discovery process to convert vague ideas into a formal draft specification by guiding Socratic questioning and ensuring changes remain non-destructive to source files. It helps teams surface the underlying problem, articulate a clear Why, How, and What, and converge on a draft specification before implementation.

Core Features & Use Cases

  • Guided Golden Circle discovery (Why/How/What) to extract a clear problem statement, solution approach, and scope
  • Automatic mapping of each acceptance criterion to an automated feedback loop for early validation
  • Produces a ready-to-review draft specification in vault or project docs, without editing source files

Quick Start

Provide a seed context to initiate discovery and produce a draft specification.

Frequently Asked Questions about draft-spec

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

FAQPage Schema
How do I draft a product specification from a vague idea?

Draft a product specification from a vague idea by providing seed context to initiate guided Socratic questioning. This process surfaces the underlying problem and converts your ideas into a formal draft specification.

What is Socratic questioning for spec discovery and how does it work?

Socratic questioning for spec discovery works by applying phase-gated progress to drive structured discovery. It extracts a clear problem statement, solution approach, and scope by articulating the Why, How, and What of your project.

How do I map acceptance criteria to automated feedback loops during spec creation?

Map acceptance criteria to automated feedback loops automatically during the spec drafting workflow. This ensures early validation by mapping each defined criterion directly to an automated testing or feedback mechanism.

Can I use this spec drafting workflow without modifying my existing source files?

You can use this spec drafting workflow without modifying existing source files because it applies non-destructive output. It only produces a ready-to-review draft specification in your vault or project docs.

What is the best way to structure a specification before engineering implementation begins?

The best way to structure a specification before implementation is through Golden Circle discovery, converging on a formal draft. This phase-gated approach ensures your problem, approach, and scope are fully defined and reviewed.

When should I not use Socratic discovery for spec drafting?

You should not use Socratic discovery for spec drafting if your project scope is already fully defined and requires no problem discovery. This approach is designed to convert vague ideas into formal drafts, not to execute pre-established specifications.