Matcha:Why — Development skill for Claude Code
🍵 Intent Discovery — problem, goals, success criteria, What → Why → How before touching code.
How to install Matcha:Why
Installs to ~/.claude/commands/plumpslabs-matcha-matcha-why.md
mkdir -p ~/.claude/commands && curl -fsSL https://raw.githubusercontent.com/plumpslabs/matcha/HEAD/.claude/commands/matcha:why.md -o ~/.claude/commands/plumpslabs-matcha-matcha-why.md Restart Claude Code, or start a new session, for it to be picked up.
What Matcha:Why does
description: "🍵 Intent Discovery — problem, goals, success criteria, What → Why → How before touching code"
/matcha:why
**Intent Discovery.** Before planning or touching code, discover the intent: what problem is being solved, what success looks like, and the What → Why → How with evidence. Can't answer Why or How? → **STOP unless trivial** (≤5 LOC, 1 file, no logic change) — for trivia, proceed on a stated assumption and flag it. Never stop the user for a typo.
Process
| Field
Alternatives in Development
- Implement Plan — You are tasked with implementing an approved technical plan from thoughts/shared/plans/ 10k ★
- Investigate Performance — Investigate a Nimbalyst performance problem (freeze, lag, idle CPU, slow op, memory growth) with measured evid 1.6k ★
- Icpg Intent — Manually create or update an iCPG intent (ReasonNode) for a file before implementing 705 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Quickprompt
Global quick prompt for instant goal definition. Transform any idea into structured goals, requirements, and s
Formula
Define the formula. Scope the problem, challenge assumptions, establish success criteria. No formula, no cook.
Scvd Store Execution Contract
A behavioral contract for autonomous work. Name the success criteria before acting, spend the cheapest evidenc
Validate Plan
You are tasked with validating that an implementation plan was correctly executed, verifying all success crite
Arckit.Adm Preliminary
Set ADM scope, architecture vision, drivers, constraints, and success criteria
Punch Up Prompt
Enriches user prompts with deep project context, execution details, and clear success criteria
Related Agents
Engine Design Review Product Intent
Before a change you've asked for gets built, checks the plan against what you actually need — is it solving th
Compass Discuss
Product manager leading problem exploration, requirements gathering, success criteria definition, and accessib
Doey Interviewer
World-class requirements analyst — structured interview protocol for extracting clear intent, scope, constrain