spec-writing

Consolidate requirements into formal specification documents with structured templates.

1|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/yknothing/prodcraft --skill spec-writing-yknothing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-writing
Source: https://github.com/yknothing/prodcraft/tree/main/skills/01-specification/spec-writing
Command: npx skills add https://github.com/yknothing/prodcraft --skill spec-writing-yknothing

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec writing fixes scope, interfaces, rollout concerns, and open questions before architecture or implementation, ensuring a shared contract among product, engineering, and design.

Core Features & Use Cases

  • Structured templates (prd.md / rfc.md) to capture Overview, Goals, Non-Goals, Detailed Design, Security, Testing, Rollout, Open Questions.
  • Explicit scope boundaries and non-goals to prevent scope creep; detailed interfaces and data models to guide implementation.
  • Works across spec-driven, waterfall, greenfield, and brownfield workflows with a clear review and validation process.
  • Real-world use: a large feature can be captured as a single spec-doc that pairs with domain-models and requirements documents, ensuring alignment among stakeholders.

Quick Start

Begin by gathering the requirements-doc and domain-model, then draft a complete spec using the recommended template and review cycle.

Frequently Asked Questions about spec-writing

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

FAQPage Schema
How do I write a specification document to prevent scope creep in feature development?

To write a specification document that prevents scope creep, use a structured template capturing Overview, Goals, explicit Non-Goals, and Detailed Design to lock scope and align stakeholders before implementation begins.

What is the best way to consolidate reviewed requirements into a shared spec?

Consolidating reviewed requirements into a shared spec involves identifying key interfaces and data models, then applying a structured review process to produce a validation-ready document that guides architecture and development.

Can I use spec writing for brownfield projects or only greenfield workflows?

Spec writing works across both brownfield and greenfield workflows, applying a consistent structured template and validation-ready review process to lock scope and expectations regardless of the project context.

How do I structure a PRD or RFC to capture rollout concerns and open questions?

Structure a PRD or RFC by using templates that explicitly capture Security, Testing, Rollout plans, and Open Questions, ensuring all product, engineering, and design stakeholders share a clear contract.

Do I need a domain model and requirements document before drafting a formal spec?

Yes, you need to gather the requirements document and domain model first, using them as foundational inputs to draft a complete specification that pairs with existing documentation for stakeholder alignment.

When should I use spec-driven development to lock interfaces and expectations?

Use spec-driven development when you need to fix interfaces, rollout concerns, and open questions before architecture, ensuring a shared contract among product, engineering, and design teams.