Brainstorm Solutions
Overview
Turn a rough idea into a clear decision by narrowing ambiguity, comparing options, and selecting a direction with explicit reasoning.
Workflow
- Clarify objective, users, and constraints.
- Identify assumptions and unknowns.
- Propose 2-3 realistic approaches.
- Compare approaches using explicit criteria.
- Recommend one approach and explain why.
- Convert decision into a short design summary and next actions.
- Save decision to
repo_root/agentspace/brainstorms/YYYY-MM-DD-<topic>.md.
Discussion Rules
- Ask one focused question at a time when information is missing.
- Prefer multiple-choice prompts when possible.
- Keep options grounded in current codebase and team constraints.
- Highlight complexity, risk, and delivery speed trade-offs.
- Reject over-engineering unless required by constraints.
Comparison Framework
Use this structure for options:
## Option A: <name>
- Approach: <how it works>
- Pros: <key benefits>
- Cons: <key costs>
- Risk: <main failure mode>
- Effort: <S/M/L>
## Option B: <name>
...
## Recommendation
- Chosen option: <A/B/C>
- Why: <short rationale tied to constraints>
- Preconditions: <what must be true>
- Next step: <first concrete execution action>
Output Standard
- Provide options first, recommendation second.
- Include explicit trade-offs, not generic pros/cons.
- End with a concrete next step (usually writing an implementation plan).
