draft-idea

Elicit a canonical IDEA.md through a structured multi-turn interview.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/fppfurtado/pragmatic-dev-toolkit --skill draft-idea
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: draft-idea
Source: https://github.com/fppfurtado/pragmatic-dev-toolkit/tree/main/skills/draft-idea
Command: npx skills add https://github.com/fppfurtado/pragmatic-dev-toolkit --skill draft-idea

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Elicits IDEA.md (product_direction role) via structured multi-turn interview when the operator has a vague idea, upstream of /triage.

Core Features & Use Cases

  • Produces or updates IDEA.md in the canonical path using a guided interview that covers problem, persona, constraints, success criteria, and discarded alternatives.
  • Supports two modes: one-shot full creation when IDEA.md is absent, and update-by-section when IDEA.md exists.
  • Aligns with project governance rules to ensure a controlled elicitation process and no automatic commits.

Quick Start

Inicie o skill para gerar o arquivo IDEA.md com uma entrevista estruturada da direção do produto.

Frequently Asked Questions about draft-idea

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

FAQPage Schema
How do I structure a vague product idea into a clear requirement document?

To structure a vague product idea, use a guided interview process to capture the problem, user, constraints, and success criteria, generating a canonical IDEA.md draft for downstream product direction.

What is the best way to capture discarded alternatives and decision records during ideation?

Capturing discarded alternatives during ideation involves conducting a structured interview that explicitly records rejected options and constraints, ensuring the final IDEA.md serves as a comprehensive decision record.

Can I update an existing IDEA.md file section by section instead of recreating it?

Yes, you can update an existing IDEA.md section by section, using an update-by-section mode that preserves previously captured product direction data while refining specific requirements.

Does this structured interview process automatically commit changes to the repository?

No, the structured interview process does not automatically commit changes to the repository, aligning with project governance rules to ensure a controlled elicitation process for product direction.

When do I need an IDEA.md file for product direction?

You need an IDEA.md file when you have a vague concept that requires crystallizing the problem, persona, and success criteria upstream of the triage phase for structured product management.

Are there prerequisites for generating a product direction document from a vague idea?

Generating a product direction document requires no specific dependencies, but you should have a vague idea ready to be crystallized through a structured interview covering problem, user, and constraints.