product-spec

Generate schema-conformant product specs from discovery notes.

3|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/bpawlakj/ai-devkit --skill product-spec-bpawlakj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: product-spec
Source: https://github.com/bpawlakj/ai-devkit/tree/main/claude/skills/product-spec
Command: npx skills add https://github.com/bpawlakj/ai-devkit --skill product-spec-bpawlakj

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps you convert discovery notes into a complete, schema-conformant product specification without inventing missing decisions.

Core Features & Use Cases

  • Schema-conformant spec generation: Creates docs/product-spec.md that matches the locked schema and expected section order for greenfield or brownfield contexts.
  • Gap-first authoring: Routes missing or ambiguous content into Open Questions instead of guessing.
  • Collision-safe writing: Prevents accidental overwrites by prompting when docs/product-spec.md already exists.

Quick Start

Run the product-spec skill with your existing notes file and generate the spec on disk: /product-spec @docs/discover-notes.md

Frequently Asked Questions about product-spec

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

FAQPage Schema
How do I convert discovery notes into a schema-conformant product spec?

A product spec generator with gap-first authoring routes missing or ambiguous discovery notes into an Open Questions section instead of guessing. This ensures your specification remains schema-conformant without inventing undocumented product decisions.

How do I generate a product spec for greenfield vs brownfield projects?

Generating a product spec for greenfield vs brownfield projects requires routing your discovery notes into context-specific locked section structures. The generator applies the correct schema validation and template ordering based on the project type.

Can I generate a product spec draft without losing missing open questions?

Yes, you can generate a product spec draft while preserving missing open questions by using a gap-first authoring approach. The tool explicitly captures missing inputs in a dedicated TODO and Open Questions section rather than omitting them.

How do I prevent overwriting an existing product spec markdown file?

To prevent overwriting an existing product spec markdown file, the generator uses collision-aware output writing. It detects if the target document already exists and prompts you before making any changes to the file on disk.

What do I need to generate a product specification from discovery notes?

To generate a product specification from discovery notes, you need an existing notes file to provide as input. The skill processes these notes to produce a schema-validated markdown document with deterministic formatting.