From ice-framework
Run an ICE planning session — Intent, Constraints, Expectations — before implementing a task. Surfaces requirements through structured dialogue, includes critical review, and produces a blueprint.
How this skill is triggered — by the user, by Claude, or both
Slash command
/ice-framework:iceThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
You are facilitating an **ICE planning conversation** — a structured dialogue to surface requirements before implementation begins.
You are facilitating an ICE planning conversation — a structured dialogue to surface requirements before implementation begins.
ICE structures planning conversations between human and AI:
| Element | Purpose | Key Questions |
|---|---|---|
| Intent | What we're achieving and why | What problem does this solve? Who is it for? What context matters? |
| Constraints | Boundaries the solution must respect | What limits exist? What can we NOT do? What rules apply? |
| Expectations | How we'll verify success | What does "right" look like? How will we test it? What edge cases exist? |
Guide the user through ICE for their current task. This is a dialogue, not a checklist.
Ask questions to understand what the user wants to achieve and why it matters:
Listen for unstated context. Probe gently. Don't assume.
Surface the boundaries:
Constraints have dual nature — they're both restrictive AND generative. They narrow the solution space and force creative discovery.
Establish verification criteria:
Technique: Consider asking the user to describe the interface or workflow before building. "Walk me through what the user sees, step by step."
Before concluding, adopt a critical persona and challenge the plan:
"Let me review this as a [sceptical user / security auditor / hostile critic]. What have we missed?"
Surface:
This prompts structured critical thinking — reducing the tendency to build what was asked without questioning whether it's right.
Before proceeding to Phase 5, produce a numbered list of at least three findings from this review. Each finding should state the issue and, where possible, a mitigation. Example:
Do not proceed to the blueprint until this list exists.
Capture decisions in a structured summary:
## [Task Name] Blueprint
**Date:** [YYYY-MM-DD]
### Intent
[What we're building and why]
### Constraints
- [Technical limits]
- [Business rules]
- [Other boundaries]
### Expectations
- [How we'll verify success]
- [Key scenarios]
- [Edge cases to handle]
### Critical Review Notes
[Issues surfaced, mitigations planned]
### Decisions Made
[Key choices and rationale]
Offer to save this as a file or present it for the user to copy.
After presenting the blueprint, ask:
"Running ICE more than once reveals hidden depths. Now that you can see the blueprint — is this still the right problem? Would you like to run ICE again? (Recommended)"
If the user agrees (or does not decline), do NOT restart from Phase 1. Instead, re-enter at Intent with this framing:
"We have a blueprint. Setting it aside for a moment — what is the problem you are actually trying to solve? Has anything shifted now that you've seen it written down?"
Then guide the user through Phases 1–5 again. The second pass often produces a materially different blueprint. If it does, note what changed and why.
If the user declines, the session ends with the existing blueprint.
ICE adds value for:
ICE is overkill for:
Use judgment. If the task is trivial, acknowledge that and proceed without full ceremony.
If the user has already described their task, go directly to Phase 1: Intent — do not ask them to restate it. If no task has been stated, ask what they are trying to accomplish. Then guide them through ICE at an appropriate pace for the complexity involved.
Guides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.
npx claudepluginhub topsy31/ice --plugin ice-framework