spec-driven-planning

Transform ambiguous requirements into formal specifications with goals, data models, and API contracts.

1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/hohai99/antigravity-skills --skill spec-driven-planning-hohai99
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-driven-planning
Source: https://github.com/hohai99/antigravity-skills/tree/main/global_skills/spec-driven-planning
Command: npx skills add https://github.com/hohai99/antigravity-skills --skill spec-driven-planning-hohai99

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps product teams and engineers translate vague requirements into precise, testable specifications that guide implementation and testing.

Core Features & Use Cases

  • Specification authoring: Capture goals, non-goals, assumptions, and constraints in a single source of truth.
  • Dependency-aware planning: Aligns with related skills like project-vision-normalizer and mvp-scope-guard to ensure cohesive scope.
  • Documentation-ready output: Produces a formal spec template including goals, behaviors, data models, and API contracts for downstream teams.

Quick Start

  1. Define Goals and Non-Goals, freeze assumptions, and map system interactions.
  2. Use the spec template to lock the spec into a stable, actionable document before coding.
  3. Validate alignment with related processes (planning, risk assessment) prior to implementation.

Frequently Asked Questions about spec-driven-planning

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

FAQPage Schema
How do I turn vague product requirements into precise specifications for coding?

You can automate the transformation of ambiguous requirements into precise specifications by generating a formal spec framework. This framework includes goals, non-goals, assumptions, behaviors, data models, and API contracts to guide downstream implementation and testing work.

What should be included in a software specification document for MVP scoping?

A software specification document for MVP scoping should include formal goals, non-goals, assumptions, behaviors, data models, and API contracts. Capturing these elements creates a single source of truth that aligns engineering and QA teams during implementation.

How do I write testable acceptance criteria from ambiguous feature ideas?

Writing testable acceptance criteria from ambiguous feature ideas requires mapping system interactions and freezing assumptions. This produces a documentation-ready specification template with clearly defined behaviors and API contracts that downstream QA teams can validate.

When do I need to generate a formal spec framework for high-risk changes?

You need to generate a formal spec framework for high-risk changes during feature discovery and MVP scoping. This ensures that ambiguous requirements are translated into precise, testable specifications before any implementation work starts.

Does this specification planning approach work for aligning engineering and QA teams?

Yes, this specification planning approach works for aligning engineering and QA teams by producing a single source of truth. The formal spec template defines behaviors, data models, and API contracts to guide downstream work for all teams.