spec-driven-development

Define structured specifications with six core sections before coding.

2|Updated Oct 28, 2022
One-click install
npx skills add https://github.com/jmanuelrosa/dotfiles --skill spec-driven-development-jmanuelrosa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/jmanuelrosa/dotfiles/tree/main/roles/ai/files/claude/skill-groups/product-manager/spec-driven-development
Command: npx skills add https://github.com/jmanuelrosa/dotfiles --skill spec-driven-development-jmanuelrosa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec-driven development reduces ambiguity by formalizing a detailed spec before coding, aligning stakeholders and guiding implementation.

Core Features & Use Cases

  • Create a stable spec with six core sections (Objective, Commands, Project Structure, Code Style, Testing Strategy, Boundaries) to guide product and engineering work.
  • Reframe vague requests into concrete success criteria and measurable milestones.
  • Use as a living document linked to PRs to ensure traceability and scope control.

Quick Start

Write a concise spec for a new feature before coding.

Frequently Asked Questions about spec-driven-development

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

FAQPage Schema
How do I write a project specification from vague ideas before coding?

To write a project specification from vague ideas, formalize a detailed spec with six core sections: Objective, Commands, Project Structure, Code Style, Testing Strategy, and Boundaries. This reduces ambiguity and aligns stakeholders before implementation begins.

What is spec-driven development and when do I need it?

Spec-driven development is formalizing a detailed specification before coding to prevent ambiguity. You need it for early-stage projects where requirements are unclear and require cross-functional collaboration to define success criteria and ongoing maintenance.

How do I turn vague product requirements into measurable milestones?

To turn vague product requirements into measurable milestones, reframe them into concrete success criteria within a structured specification. This living document guides implementation and links directly to PRs for traceability and scope control.

Can I use a specification document for ongoing project maintenance and scope control?

Yes, you can use a specification document for ongoing maintenance and scope control. The spec functions as a living document linked to PRs, ensuring continuous traceability and aligning stakeholders throughout the project lifecycle.

Does spec-driven development work for early-stage projects with unclear requirements?

Spec-driven development works effectively for early-stage projects with unclear requirements. It prescribes a structured specification with defined boundaries to formalize cross-functional collaboration and guide implementation.

What's the best way to structure a technical specification for cross-functional teams?

The best way to structure a technical specification for cross-functional teams is using six core sections: Objective, Commands, Project Structure, Code Style, Testing Strategy, and Boundaries. This framework ensures stable alignment across product and engineering work.