spec-driven-development

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

Updated Jun 13, 2026
One-click install
npx skills add https://github.com/22Teikk/22Teikk-Agent-Skills-Hub --skill spec-driven-development-22teikk
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: spec-driven-development
Source: https://github.com/22Teikk/22Teikk-Agent-Skills-Hub/tree/main/core/skills/spec-driven-development
Command: npx skills add https://github.com/22Teikk/22Teikk-Agent-Skills-Hub --skill spec-driven-development-22teikk

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Starting to code from vague or ambiguous requirements leads to rework, hidden assumptions, and untestable outcomes. This Skill forces a written specification — covering objective, tech stack, architecture, testing strategy, and boundaries — before any code is written, so the human and the agent share one source of truth. ## Core Features & Use Cases - Gated four-phase workflow: Specify, Plan, Tasks, Implement — each phase requires human review before advancing, with a hard Open Questions gate that blocks saving the spec while any item is unresolved. - Architecture decision gate: For new projects, presents 2-3 architecture options (e.g., MVVM + Clean, MVVM, MVI) with trade-offs and waits for explicit human confirmation instead of silently picking one. - Traceability Matrix: Maps every acceptance criterion to at least one behavioral test, making unproven criteria a hard NO-GO at ship time. - Use Case: When asked to build a new Android feature with only a rough idea, the Skill captures the verbatim request, surfaces assumptions, asks clarifying questions one at a time, and produces a reviewed SPEC.md under .teikk/spec/ before any implementation begins. ## Quick Start Ask the agent to write a specification for your new feature or project before writing any code, and answer its clarifying questions until the spec is approved.

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 software specification before coding?▼

Capture the raw request verbatim, surface your assumptions, then draft nine core areas: objective, tech stack, architecture, observability, commands, project structure, code style, testing strategy, and boundaries. Resolve every open question with the stakeholder before saving the spec.

What is spec-driven development?▼

Spec-driven development is a workflow where a written specification is the shared source of truth before implementation begins. It proceeds through gated phases — Specify, Plan, Tasks, Implement — with human review required to advance between phases.

When should I not write 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 the full nine-area template is unnecessary overhead.

How do I choose an architecture for a new Android project?▼

Present 2-3 viable options with trade-offs — such as MVVM + Clean Architecture, plain MVVM, or MVI — and let the stakeholder explicitly choose. Record both the chosen option and rejected alternatives so the decision stays traceable in the spec and decision log.

What is a traceability matrix in a software spec?▼

A traceability matrix maps every acceptance criterion to at least one behavioral test that executes real logic and asserts a value. Mock-only, boilerplate, or label-only tests do not satisfy a criterion, and unproven criteria block shipping.