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.