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.