shape-idea

Shape idea — conversation in, prompt out

The user invoked /shape-idea with: {{args}}

One job: turn a raw idea into ONE prompt file the user pastes somewhere else. Utility bucket. The value is the conversation BEFORE the prompt — pushback, what already exists, what is really being asked — so the prompt's "Decided" section is settled and the next step does not re-ask it. /groom-panel caps its own questions at four in one round; this skill is where the long argument happens.

Steps

1. Get the idea and the target repo

If {{args}} is empty, ask for the idea. Then settle, in one AskUserQuestion call if not already clear from the idea:

• Target repo — the repo where the prompt will be RUN (not necessarily the cwd). The prompt file goes in THAT repo's docs/.
• Target kind — groom (run /groom-panel in that repo: Jira Epic + tickets, no code) or cloud (paste into a claude.ai/code cloud session: builds on GitHub, opens a PR). Cloud only fits GitHub-only work; work bound to the user's machine (local schedulers, daemons, local data) and builds that need hosts the cloud cannot reach (e.g. Android Gradle against Google Maven) cannot run there — say so and steer to groom.

2. Inventory what already exists — before any question

Spawn ONE Explore agent on the target repo: its CLAUDE.md, handoff/status docs, existing features, connectors, open Jira epics named in docs, anything in the idea that may already be built, and the shared components and functions (UI pieces, data writers) the idea could call with its own data instead of rebuilding. End its prompt with the verified-vs-inferred return contract. Spot-check any "already exists" / "missing" claim yourself (one grep) before relaying it. Half of a past idea's asks already existed; this step is what found it.

If the idea names an outside product, tool or model (often misheard in a voice dump), confirm the exact name with the user, then research it with WebSearch in the same step: what it is, how it plugs in, cost, what data leaves the machine, maturity. Cite the sources in your reply. Never build questions on a guessed name.