ideate

Overview

Capture a user's idea and write a single markdown file in design/ideas/ using the required format: Idea summary, research, and a sketch in a code block.

Workflow

1. Clarify briefly if needed: Ask 1–3 quick questions only if the idea is too vague to summarize or research.
2. Read local context: Enumerate and read all files under design/ (recursive). Summarize only what is relevant to the idea.
3. Do research: Use both local context and web research when it materially improves the idea. Prefer concise, credible sources.
4. Write the idea file:
   • Ensure design/ideas/ exists; create it if missing.
   • File name: YYYY-MM-DD-<kebab-idea-title>.md. If a file already exists, append -2, -3, etc.
   • Content format must be exactly:

# Idea

{summarization from the user}

# Research

{agent research supporting the idea}

# Sketch

```{format}
{agent generated sketch (ASCII, Mermaid, or pseudocode UI)}
```

Sketch guidance

• Use a single code block in the Sketch section.
• Preferred formats: mermaid, text, or md (ASCII wireframe). Pick the one that best conveys the concept.
• Keep the sketch lightweight and illustrative, not exhaustive.

Research guidance

• Incorporate relevant findings from design/ files first.
• Add web research only when it adds concrete value; include source links in the Research section when used.
• Keep it concise and directly tied to the idea.