spec-first

Convert project ideas into vision and blueprint documents via a 10-question interview.

2|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/GuruDevvv/my-claude-skills --skill spec-first-gurudevvv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-first
Source: https://github.com/GuruDevvv/my-claude-skills/tree/main/spec-first
Command: npx skills add https://github.com/GuruDevvv/my-claude-skills --skill spec-first-gurudevvv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides you from a loose project idea to a fully defined spec, preventing blind coding and preserving context across Claude Code sessions.

Core Features & Use Cases

  • Guided 10-question interview to capture vision and constraints.
  • Generates docs/vision.md and docs/blueprint.md to anchor the project in future sessions.
  • Maintains session continuity by updating project notes and ensuring the plan is accessible in subsequent interactions.
  • Suitable for new projects, product briefs, or when teams need a reproducible build plan before coding.

Quick Start

Describe a new project idea to Claude Code and let it generate the vision and blueprint documents.

Frequently Asked Questions about spec-first

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

FAQPage Schema
How do I turn a vague project idea into a concrete build plan before coding?▼

To turn a vague project idea into a concrete build plan, you describe the concept to Claude Code to trigger a guided 10-question interview that captures your vision and constraints, outputting structured specification documents for development.

How do I preserve project context and vision across Claude Code sessions?▼

To preserve project context across Claude Code sessions, this Skill generates docs/vision.md and docs/blueprint.md files and continuously updates your project notes, ensuring the build plan remains accessible in subsequent interactions.

What is a spec-first approach and when do I need it for software planning?▼

A spec-first approach prevents blind coding by conducting a guided interview to define project constraints before development begins. You need it for new projects, product briefs, or when teams require a reproducible build blueprint.

Can I use this guided specification process for team projects and product briefs?▼

Yes, you can use this guided specification process for team projects and product briefs. It works across individual and team environments to produce a reproducible vision and build blueprint before coding starts.

What documents are generated when creating a project blueprint with Claude Code?▼

When creating a project blueprint, the tool generates docs/vision.md to anchor the project goals and docs/blueprint.md to define the build steps, ensuring documentation continuity for future Claude Code sessions.