Skip to content

What This Skill Does

Explores technical approaches with structured ideation, challenge, convergence, and plan-creator handoff. Generates 3-8 ideas using one of 7 purpose-built techniques, applies anti-bias pivots, challenges the idea set before recommending, and scores ideas on feasibility/impact/simplicity/novelty when in deep mode. Produces structured reports -- never code.

Differentiator: mk:office-hours = "should we build this?" (product validation). mk:brainstorming = "how should we build this?" (technical approach). mk:plan-ceo-review = plan already exists, want to challenge scope.

When to Use

  • Multiple architecturally-distinct approaches exist for a known requirement
  • Trade-off analysis between candidate solutions is needed
  • Novel problem with no obvious pattern in the codebase
  • Pre-mortem / failure-mode exploration before committing to a design
  • Constraint-rich problem (budget, time, stack) where the solution space is narrow

NOT this skill if:

SituationUse instead
"Is this worth building?" -- product validationmk:office-hours
Plan already exists, want to challenge scopemk:plan-ceo-review
Existing brainstorm, verdict, or plan needs deeper reasoningmk:elicit
Broad codebase inventory before planningmk:scout
High-stakes multi-perspective architecture debatemk:party
Bug investigation / root causemk:investigate
Implementation detail (which library, which API call)mk:docs-finder + just decide
Stuck on a specific approach with forced assumptionsmk:problem-solving

Core Capabilities

  1. Problem Confirmation: Confirms what is being solved and the binding constraint before generating ideas. Uses AskUserQuestion capped at 3 per batch
  2. Scope Decomposition: If request bundles 3+ independently-shippable concerns, decomposes into sub-projects before brainstorming
  3. 7 Purpose-Built Techniques (auto-selected, or forced via --technique):
    • multi-alternative -- "how to build X", generates architecturally distinct approaches with mechanism/trade-off/risk table
    • first-principles -- novel problems with no existing patterns, rebuilds from fundamental constraints
    • reverse -- debugging/prevention mindset, inverts problem to generate failure modes then prevention mechanisms
    • constraint-mapping -- narrow solution space, classifies constraints as HARD vs SOFT, finds intersection
    • scamper -- improving existing things, walks 7 lenses (Substitute/Combine/Adapt/Modify/Put/Eliminate/Reverse)
    • analogical-thinking -- cross-domain transfer, extracts mechanisms from non-software domains
    • perspective-shift -- walks candidate solutions through stakeholder perspectives (SRE, Security, New Hire, PM, End User)
  4. Anti-Bias Pivot: After idea #4, pauses and asks "what orthogonal category have I not touched yet?" Forces one pivot per session to break semantic clustering
  5. Challenge Pass: Before recommendation, checks duplicate architectures, hard constraints, category diversity, conservative drift, and missing stakeholder failure modes
  6. Idea Format: Every idea must include Concept (2-3 sentence mechanism), Novelty (what makes it non-obvious -- mandatory, or idea is dropped), and Category
  7. Scoring (--depth deep only): 4 criteria weighted -- Feasibility (3x), Impact (3x), Simplicity (2x), Novelty (1x). Max 45. Anti-bias rules: score ALL before comparing, flag when all top picks are conservative
  8. Context Budgeting: Keeps discovery questions, scout bridge summaries, challenge output, rejected alternatives, and handoff packets compact
  9. Output Templates: Three structured reports -- output-ideas.md (quick, 3-8 ideas, no scoring), output-scored.md (deep, scored with top 3 recommendations), output-action-plan.md (handoff context for plan-creator)
  10. Report Self-Check: Confirms problem, binding constraint, success criterion, excluded scope, technique choice, challenge result, recommendation evidence, and handoff completeness before finalizing
  11. Anti-Rationalization: Built-in catalog of common excuses to skip the process, with counter-arguments. Covers skip-the-process, skip-decomposition, skip-discovery, and skip-anti-bias-pivot rationalizations
  12. Edge Case Handling: 8 documented edge cases (pre-decided user, novel problem that's actually standard, conflicting constraints, score ties, conservative drift, etc.) with specific response patterns

Arguments

  • --depth quick -- 3-8 ideas, qualitative picks, no scoring (default)
  • --depth deep -- scored ideas + top 3 + optional plan-creator handoff
  • --technique [name] -- force a specific technique (default: auto-select via problem-type matching with precedence: multi-alternative -> first-principles -> reverse -> constraint-mapping -> scamper -> analogical-thinking -> perspective-shift)

Workflow

The skill is done when:

  1. Problem is confirmed -- user explicitly agrees on what is being solved and the binding constraint
  2. Scope is right-sized -- multi-concern requests are decomposed
  3. A technique is selected -- matched to problem type via precedence order
  4. Ideas are generated (capped at 8) -- no scoring during generation. Anti-bias pivot applied at midpoint
  5. Challenge pass runs -- duplicate architectures are merged, hard-constraint violations are dropped, and one regeneration pass is allowed
  6. Ideas are evaluated -- scoring in separate pass (deep mode) or qualitative picks (quick mode)
  7. Output uses correct template -- quick vs scored vs handoff
  8. Handoff is offered (deep mode only) -- ask "Create plan from top idea?" If yes, pass report path plus compact handoff packet to mk:plan-creator

HARD RULE: Brainstorming MUST NOT write code, create files outside plans/reports/, or invoke implementation skills.

Usage

/mk:brainstorming                     -> quick mode, auto-selected technique
/mk:brainstorming --depth deep        -> scored mode with handoff
/mk:brainstorming --technique scamper -> force SCAMPER technique

Example Prompt

"We need to handle real-time notifications in our app. What approach should we take?"

The skill will: confirm the binding constraint (latency requirements? scale?), auto-select multi-alternative.md, generate 3-8 architecturally distinct approaches (WebSocket, SSE, polling, queue-based), apply anti-bias pivot at idea #4, evaluate qualitatively (quick) or with weighted scoring (deep), and offer to hand off the top idea to mk:plan-creator. Before recommending, it will merge same-architecture variants, check hard constraints, and either ask for a tie-break criterion or mark "no clear winner" when deep-mode scores are too close.

Common Use Cases

  • Choosing between WebSocket, SSE, polling, or queue-based architectures
  • Designing a caching strategy with multiple constraints
  • Exploring database choices for a startup with budget, skill, and scaling constraints
  • Failure-mode exploration for auth system design
  • Evaluating approaches for handling bursty API traffic

Pro Tips

  • The Novelty line is mandatory -- if you cannot write one, the idea is a duplicate and should be dropped
  • Cap discovery at 3 questions per batch -- question fatigue kills ideation momentum
  • If all 3-8 ideas cluster in 1-2 categories, the anti-bias pivot failed -- flag it and consider a focused session
  • If top deep-mode scores are within 2 points, do not force a winner -- ask for one tie-break criterion or report no clear winner
  • Max 8 ideas per run -- if the problem needs more, decompose into sub-problems and run multiple sessions
  • Never pass a full brainstorm transcript downstream -- pass the report path and compact handoff packet
  • The anti-rationalization catalog is worth reading -- it names the excuses you'll catch yourself making
  • When using constraint-mapping and the intersection is empty, do NOT fabricate a solution -- report back to the user
  • For the reverse technique: the prevention mechanisms ARE the solution ideas

Released under the MIT License.