spec

Turn vague ideas into implementation-ready PRDs through Socratic questioning and research.

8|1|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/Heavy-Chain-Engineering/etc --skill spec-heavy-chain-engineering
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec
Source: https://github.com/Heavy-Chain-Engineering/etc/tree/main/skills/spec
Command: npx skills add https://github.com/Heavy-Chain-Engineering/etc --skill spec-heavy-chain-engineering

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns vague ideas into concrete, implementation-ready PRDs through guided Socratic questioning, research, and iterative refinement.

Core Features & Use Cases

  • Socratic questioning to elicit requirements, surface ambiguities, and drive structured PRD drafts.
  • Codebase and web research to ground PRDs in real context and verifiable evidence.
  • Phase-based PRD drafting with Definition of Ready validation and artifact generation (PRD, decisions, and research notes) ready for implementation.

Quick Start

Start a new spec session with /spec and follow the prompts to refine your PRD.

Frequently Asked Questions about spec

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

FAQPage Schema
How do I turn a vague software idea into an implementation-ready PRD?

To turn a vague idea into an implementation-ready PRD, use Socratic questioning. This process elicits requirements, surfaces ambiguities, and iteratively refines your concept into a structured, traceable product specification.

What is Socratic questioning for product specification drafting?

Socratic questioning for product specification drafting is an interactive elicitation method. It applies pattern-based user prompts to drive structured PRD drafts, ensuring architecture grounding and cross-team alignment for software initiatives.

Can I ground my PRD in real codebase context and verifiable evidence?

You can ground your PRD in real codebase context by using integrated research capabilities. The system analyzes your codebase and web sources to extract verifiable evidence, ensuring traceable requirements across both code and documentation.

How do I validate if my PRD is ready for development implementation?

To validate if your PRD is ready for development, you apply Definition of Ready validation. This checks phase-based drafts against required criteria, generating decisions, research notes, and artifacts ready for implementation.

What is the best way to align cross-team requirements for software architecture?

The best way to align cross-team requirements for software architecture is through interactive elicitation and iterative refinement. This enforces traceable requirements across code and documentation, producing implementation-ready artifacts.

Do I need prior documentation to start drafting a specification?

You do not need prior documentation to start drafting a specification. The process transforms vague ideas through interactive Socratic prompts and research, building the necessary context and structure from an initial concept.