spec-driven-development

Writes structured specifications before coding through a gated four-phase workflow.

Updated Aug 11, 2026
One-click install
npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill spec-driven-development-kunj-sharma03
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/Kunj-Sharma03/agent-contextify/tree/main/templates/skills/spec-driven-development
Command: npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill spec-driven-development-kunj-sharma03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting to code from vague or ambiguous requirements leads to rework, wrong assumptions, and features nobody asked for. This Skill forces a written specification to be created and reviewed before any implementation begins, making the spec the shared source of truth between the AI agent and the human engineer. ## Core Features & Use Cases - Gated Four-Phase Workflow: Enforces a Specify → Plan → Tasks → Implement pipeline where each phase requires human review before advancing. - Structured Spec Template: Covers six core areas including objective, commands, project structure, code style, testing strategy, and Always/Ask First/Never boundaries. - Assumption Surfacing: Requires listing assumptions and reframing vague requirements into concrete, testable success criteria before writing code. - Use Case: When asked to "build a dashboard feature" with unclear requirements, the agent first drafts a spec with acceptance criteria (e.g., LCP < 2.5s), gets human approval, then plans and implements against it. ## Quick Start Ask the agent to write a specification for the new feature before writing any code, covering objectives, commands, structure, testing, and boundaries.

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 specification before coding a new feature?

Follow the four-phase gated workflow: Specify, Plan, Tasks, Implement. Write a spec covering objective, commands, project structure, code style, testing strategy, and boundaries, then get human approval before advancing to planning and implementation.

What should a software specification document include?

A spec should cover six core areas: objective with user stories, executable build and test commands, project directory structure, code style with example snippets, testing strategy with coverage expectations, and three-tier boundaries of Always do, Ask first, and Never do.

When should I skip writing a spec for a code change?

Skip the full spec for single-line fixes, typo corrections, or changes where requirements are unambiguous and self-contained. Even simple tasks benefit from a two-line spec with acceptance criteria, but lengthy specs are unnecessary for trivial work.

How do I handle vague requirements like make the dashboard faster?

Reframe vague requirements into concrete, testable success criteria. For example, translate "make it faster" into measurable targets like LCP under 2.5 seconds on 4G, initial data load under 500ms, and CLS under 0.1, then confirm these targets with the human.

Why does coding without a spec cause problems?

Coding without a spec means guessing at requirements, which hides assumptions until they surface as rework. A 15-minute spec surfaces misunderstandings before implementation, preventing hours of debugging and rebuilding the wrong solution.