| name | brainstorm |
| description | Explore a rough idea with the user, clarify requirements, and draft a spec. Also decomposes large specs into smaller ones (e.g. /brainstorm "offline mode", /brainstorm <gest-id>). |
| args | <rough idea or gest artifact ID to decompose> |
Brainstorm
Explore a problem space with the user and produce a spec.
Instructions
1. Explore the Problem Space
Read the input provided by the user. Determine the mode:
- Rough idea -- the user has a new idea to explore
- Existing spec -- the user provides a gest artifact ID to decompose
For rough ideas, delegate to the brainstormer agent with the idea. The agent will research the codebase and return a
structured context report covering existing patterns, constraints, complexity, and open questions. Use the research
report to ground the conversation.
For existing specs, retrieve the spec via
cargo run -- artifact show <id> --json for structured parsing,
or without --json for human-readable output. Identify natural decomposition boundaries.
2. Clarify Requirements
Ask clarifying questions one at a time. Do not front-load a list of questions. Wait for the user's answer before
asking the next. Use the brainstormer's open questions as a starting point for rough ideas, or scope boundaries for
decomposition.
3. Propose Approaches
Once the problem is well-understood, propose 2-3 approaches with trade-offs and complexity estimates. Ground each
approach in the constraints and existing patterns surfaced by the brainstormer. Ask the user which approach to pursue.
4. Draft the Spec
Invoke /write-spec with the agreed-upon approach. The skill will output a gest artifact ID for the new spec.
For decomposition, invoke /write-spec for each sub-spec, linking them back to the parent.
Print next-step hint: invoke /plan <id> when you're ready for the next step (using the spec's gest ID).
