spec-driven-development

Generate a project specification before implementing new features.

23|6|Updated May 9, 2026
One-click install
npx skills add https://github.com/vinvcn/addyosmani-agent-skills-zh --skill spec-driven-development-vinvcn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/vinvcn/addyosmani-agent-skills-zh/tree/main/skills/spec-driven-development
Command: npx skills add https://github.com/vinvcn/addyosmani-agent-skills-zh --skill spec-driven-development-vinvcn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of ambiguous requirements and architectural drift by enforcing a structured specification phase before any code is written, ensuring alignment between human intent and machine execution.

Core Features & Use Cases

  • Structured Specification: Provides a standardized template for defining objectives, tech stacks, project structures, and success criteria.
  • Boundary Enforcement: Establishes clear rules for what an agent should always do, ask about, or never do, reducing risky assumptions.
  • Use Case: When starting a complex new feature, use this skill to generate a comprehensive spec that forces you to clarify assumptions, define testing strategies, and establish success metrics before implementation begins.

Quick Start

Use the spec-driven-development skill to generate a project specification for the new user authentication module based on the provided requirements.

Frequently Asked Questions about spec-driven-development

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

FAQPage Schema
How do I prevent scope creep when developing complex features?

Prevent scope creep by mandating a formal specification phase before implementation to define project boundaries, clarify ambiguous requirements, and establish verifiable success criteria. This structured approach ensures alignment between human intent and machine execution, reducing risky assumptions.

What is the best way to document architectural changes for software engineering?

The best way to document architectural changes is using a standardized specification template that defines objectives, tech stacks, project structures, and success metrics. This formalizes technical planning and prevents architectural drift before any code is written.

How do I generate a project specification for a new module?

Generate a project specification by applying a structured template to your requirements, forcing clarification of assumptions, defining testing strategies, and establishing success metrics. This creates a comprehensive spec that standardizes the software development lifecycle.

When do I need a formal specification phase in my development workflow?

You need a formal specification phase when initializing new projects, developing complex features, or making architectural changes where requirements are ambiguous or multi-faceted. It satisfies the need for documented technical planning to prevent rework.

Does spec-driven development work for ambiguous multi-faceted requirements?

Spec-driven development works effectively for ambiguous multi-faceted requirements by enforcing boundary rules that establish what an agent should always do, ask about, or never do. This reduces risky assumptions and ensures verifiable success criteria.