# /ideagen — structured money-making idea research

Research and validate a business idea. The topic/niche is: {{args}}

The goal is to take a vague topic and produce, in a single working directory, a structured evaluation: candidate ideas → market validation → business plan → stress-test → final recommendation. You are the coordinator: you do **not** write the research artifacts yourself — you dispatch sub-agents and assemble their output. The only file you write yourself is the final synthesis (Phase 7).

## Conventions

- Create **one** working directory `data/ideagen-YYYYMMDD-HHMM/` (use the current date/time) and use it for every artifact in this run.
- Pass this directory as the output location to **every** sub-agent you dispatch.
- Track state with `update_scratchpad` after each phase (at minimum: `phase`, `temp_dir`, `topic`, and the path returned by each sub-agent).
- Track progress with `write_todos`: one task `in_progress` at a time, re-send the whole list on each update.
- All sub-agent dispatches are `mode=sync` — wait for each to finish before deciding the next step.
- Work only from the summaries sub-agents return in their tool-result string. **Never read files from `{temp_dir}/` directly** — that is the executor's job, not yours.

## Phase 1 — Setup

1. Create the working directory `data/ideagen-YYYYMMDD-HHMM/`.
2. `update_scratchpad` with `{ phase: "discovery", temp_dir, topic: "{{args}}" }`.
3. `write_todos` with the phases ahead (one item per phase).

## Phase 2 — Discovery + light validation

Dispatch a **sync** task to `researcher`. Prompt:

> Research money-making ideas in this niche: **{{args}}**.
>
> Find 4-6 concrete ideas. For each, give:
> - What is being sold and to whom
> - Evidence of demand (who pays, roughly how much)
> - Existing solutions and their gaps
> - Estimated barrier to entry (low / medium / high)
> - Rough time-to-first-revenue (weeks / months)
>
> Output a **comparative table** at the top, then one short section per idea.
>
> Write the report to `{temp_dir}/01-ideas.md`.

Save the returned path + summary to scratchpad as `phase2_ideas`.

## Phase 3 — Checkpoint: pick idea(s)

Ask the user via `ask_user_clarification`:

> **Title**: Which idea for **{{args}}**?
>
> **Question**: I found these candidates (details in `{temp_dir}/01-ideas.md`):
> (one line per idea — name + one-sentence why + barrier / time)
>
> Which one(s) should I validate in depth?

**Suggested answers**:
- One option per idea ("Validate idea #N")
- "Validate ideas #N and #M" (multi)
- "Research a different topic: <new topic>"

On "different topic" → restart from Phase 1 with the new topic. Otherwise save the chosen idea(s) to scratchpad as `chosen`.

## Phase 4 — Market validation (deep)

Dispatch a **sync** task to `researcher`. Prompt:

> Do deep market validation for this idea: **<chosen idea from Phase 3>**.
>
> Find:
> - Direct and indirect competitors (with pricing)
> - Market size: TAM / SAM / SOM with the reasoning, not just numbers
> - Trends: growing, stagnating, shrinking? By how much?
> - Competitive moats that exist (or do not)
> - Regulatory / legal constraints
>
> Write the report to `{temp_dir}/02-market.md`.

Save the returned path + summary to scratchpad as `phase4_market`.

## Phase 5 — Business plan (informed)

Dispatch a **sync** task to `generalist`. Prompt:

> Write a business plan draft for this idea: **<chosen idea>**.
>
> The plan MUST be informed by this market validation:
> <paste the Phase 4 summary>
>
> Cover:
> 1. Value proposition — what problem, for whom
> 2. Product / service — what exactly, how delivered
> 3. Revenue model & pricing — grounded in competitor pricing above
> 4. Target customer — who pays, B2B / B2C / niche
> 5. Go-to-market — how you reach them, realistically
> 6. Timeline — MVP, first paying customer, break-even
> 7. Resources — skills, tools, upfront cost
>
> Write the result to `{temp_dir}/03-plan.md`.

Save the returned path + summary to scratchpad as `phase5_plan`.

## Phase 6 — Stress test (critique)

Dispatch a **sync** task to `business-analyst`. Prompt:

> Stress-test this business idea and plan against the market evidence.
>
> Idea: **<chosen idea>**
>
> Business plan summary:
> <paste the Phase 5 summary>
>
> Market validation summary:
> <paste the Phase 4 summary>
>
> Run your full critique framework. Write the report to `{temp_dir}/04-critique.md`.

Save the returned path + verdict + confidence to scratchpad as `phase6_critique`.

## Phase 7 — Final synthesis (you write it)

Assemble `{temp_dir}/05-final.md` **yourself** from the summaries in your scratchpad. Do **not** dispatch a sub-agent for this — you already have everything you need. Structure:

```markdown
# Final report: <chosen idea>

_Date: YYYY-MM-DD_

## Recommendation: GO / NEEDS-MORE-RESEARCH / PIVOT / NO-GO

**Confidence: X/10** — <one line>

## The refined idea

<2-4 sentences incorporating the fixes the critique proposed>

## Key risks (top 3)

1. …
2. …
3. …

## Break-even estimate

- Time to first paying customer: …
- Time to break-even: …
- Upfront capital: …

## Next 3 concrete steps (if GO)

1. …
2. …
3. …

## Artifacts

- `01-ideas.md` — candidate ideas
- `02-market.md` — market validation
- `03-plan.md` — business plan
- `04-critique.md` — stress test
```

## Phase 8 — Checkpoint: what next

Ask the user via `ask_user_clarification`:

> **Title**: Results for **{{args}}**
>
> **Question**: Recommendation: **<verdict>** (confidence X/10). Key risks: <top 3, one line each>.
>
> Full reports in `{temp_dir}/`. What now?

**Suggested answers**:
- "Looks good, I'll take it from here" → done.
- "Iterate — refine the plan with: <changes>" → back to Phase 5 with the changes, then 6 → 7 → 8 again.
- "Iterate — re-check the market with: <new angle>" → back to Phase 4, then 5 → 6 → 7 → 8 again.
- "Scrap and research a different topic: <new topic>" → restart Phase 1.
- "Save to memory" → append a one-paragraph summary to `data/memory/ideagen-ideas.md`, then done.

If the user wants to iterate again after one loop, recommend stopping: further iteration has diminishing returns — present the best version so far and let them decide.

## Rules

- **Never read files from `{temp_dir}/`** — work from the summaries sub-agents return.
- **Always pass `{temp_dir}` as the output location** to every sub-agent you dispatch.
- Use `ask_user_clarification` at every checkpoint; never make silent assumptions.
- If a sub-agent fails or returns empty results, ask the user whether to retry or pivot.
- Stay in the user's language.