spec-planner

Guide structured dialogue through CLARIFY, DISCOVER, DRAFT, REFINE, and DONE phases to produce implementation-ready specs.

Updated Feb 7, 2026
One-click install
npx skills add https://github.com/lorrandavid/.dotfiles --skill spec-planner-lorrandavid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-planner
Source: https://github.com/lorrandavid/.dotfiles/tree/main/.config/.copilot/skills/spec-planner
Command: npx skills add https://github.com/lorrandavid/.dotfiles --skill spec-planner-lorrandavid

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Dialogue-driven spec planning helps teams surface missing requirements, align on scope, and reduce rework by forcing structured exploration and iterative refinement.

Core Features & Use Cases

  • Phase-driven workflow: CLARIFY, DISCOVER, DRAFT, REFINE, DONE to guide conversations and documentation.
  • Gaps identification & trade-offs: prompts for answering scope, motivation, constraints, edge cases, and success criteria; supports decision-making with templates and references.
  • Reusable templates & references: access to decision frameworks, templates for Feature Plans, ADRs, RFCs, and estimation guidance to produce implementation-ready specs.
  • Use Case: A product team uses the spec planner to generate a complete spec for a new feature by iterating through clarifying questions and capturing acceptance criteria.

Quick Start

Draft a complete spec for a lightweight onboarding flow that reduces time-to-first-use by 30% and captures key success metrics.

Frequently Asked Questions about spec-planner

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

FAQPage Schema
How do I draft implementation-ready specs through dialogue?

Drafting implementation-ready specs through dialogue involves identifying gaps in scope, motivation, and constraints using a structured CLARIFY → DISCOVER → DRAFT → REFINE → DONE phase flow to align stakeholders and capture acceptance criteria.

What is the best way to identify missing requirements and edge cases in a feature plan?

Identifying missing requirements and edge cases is best achieved through structured dialogue that forces iterative refinement, prompting for success criteria and constraints to reduce rework and ensure alignment.

How do I document trade-offs and open questions for a new feature spec?

To document trade-offs and open questions for a new feature spec, leverage reusable templates and reference materials like ADRs and RFCs during the DRAFT and REFINE phases to capture implementation decisions.

Does this spec planning approach work for capturing acceptance criteria across multiple scenarios?

Yes, this spec planning approach works for capturing acceptance criteria across scenarios by applying the phase-driven workflow to align stakeholders and rigorously explore edge cases before finalizing the spec.

When do I need structured spec planning instead of writing requirements directly?

You need structured spec planning instead of writing requirements directly when teams must surface missing requirements, align on scope, and reduce rework by forcing structured exploration of constraints and trade-offs.

Can I generate a complete spec for a lightweight onboarding flow using this method?

Yes, you can generate a complete spec for a lightweight onboarding flow by iterating through clarifying questions to capture key success metrics and reduce time-to-first-use, producing an implementation-ready document.