Solution exploration

SkillDev tools

Lets your agent explore a problem and compare possible approaches before any code is written.

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add ahel to your AI once: Claude, ChatGPT, Cursor, Claude Code or Codex. Then ask it to use this.

Then ask your AI: use the Solution exploration skill

About this skill

Explores the problem and the range of possible approaches before any code is written, clarifying what is actually being asked, surfacing options with their tradeoffs, and converging on one. Use this at the start of any feature, component, or behavior change, when a request is ambiguous, when the fi

What this skill tells your AI

The instructions your AI receives, as published by cbrock84/headcount in plugins/technology/skills/solution-exploration/SKILL.md and read by ahel’s review.

The most expensive bugs are decisions, not defects. This runs before implementation, not instead of it.

Establish what is actually wanted

The stated request is a proposed solution wearing the clothes of a requirement. Get underneath it:

  • What outcome does the person want? What breaks today without it?
  • Who else touches this, and what do they assume about it now?
  • What is explicitly not being asked for?
  • How will we know it worked — the observable difference.

If the answers conflict, stop and resolve that first. Building the average of two requirements satisfies neither.

Generate genuinely different options

Two variations of the same idea are one option. Force real range:

  • The smallest thing that could work.
  • The version that assumes this doubles in scope next quarter.
  • The version that requires no new moving parts.
  • Buy, borrow, or do nothing.

For each: what it costs, what it forecloses, and what has to be true for it to be right.

Converge

Recommend one and say why the others lost. A comparison that ends without a recommendation has moved the work, not done it.

Name the assumption the recommendation rests on most heavily — that is where the plan will break if it breaks.

Never

  • Present options you would not accept as padding around the one you want.
  • Skip this because the task "is simple." Simple tasks take five minutes here.
  • Let a preference stand in for a reason.

Signals

GitHub stars
2k
Forks
262
Last commit
Sep 2026
Advanced
Item type
skill
Key
solution-exploration
Source
github.com/cbrock84/headcount