idea-refine

1# Idea Refine
2 
3## Overview
4 
5Refines raw ideas into sharp, actionable concepts worth building through structured divergent and convergent thinking.
6 
7## When to Use
8 
9- Use when an idea is still vague and needs shaping before it can become a plan
10- Use when you need to stress-test assumptions before committing to a direction
11- Use when you want to expand options before converging on one
12- Trigger phrases: "Help me refine this idea", "Ideate on [concept]", "Stress-test my plan"
13- Not for: a user who is unsure what they want at all (use `interview-me`), or a direction already chosen that needs a spec (use `spec-driven-development`)
14 
15## How It Works
16 
171.  **Understand & Expand (Divergent):** Restate the idea, ask sharpening questions, and generate variations.
182.  **Evaluate & Converge:** Cluster ideas, stress-test them, and surface hidden assumptions.
193.  **Sharpen & Ship:** Produce a concrete markdown one-pager moving work forward.
20 
21## Usage
22 
23This skill is primarily an interactive dialogue. Invoke it with an idea, and the agent will guide you through the process.
24 
25```bash
26# Optional. Run from the project root so this creates ./docs/ideas.
27# <skill-dir> is the directory that contains this SKILL.md
28# (for example .agents/skills/idea-refine or .cursor/skills/idea-refine).
29bash <skill-dir>/scripts/idea-refine.sh
30```
31 
32## Output
33 
34The final output is a markdown one-pager saved to `docs/ideas/[idea-name].md` (after user confirmation), containing:
35- Problem Statement
36…