intent-first

# Intent-First: Clarify Before You Execute

## Purpose

Transform vague requests into clear, actionable specifications before starting work.

## When to Use

- User request is ambiguous or could mean multiple things
- Task scope is unclear
- Success criteria are not defined
- You're about to start significant work

## The Intent Clarification Framework

### Step 1: Identify the Intent Type

| Type | Signal Words | Example |
|------|-------------|---------|
| **Create** | make, build, write, generate | "Make a report" |
| **Modify** | change, update, fix, improve | "Fix this code" |
| **Analyze** | review, check, find, understand | "Review this design" |
| **Decide** | should I, which is better, compare | "Should I use X or Y?" |
| **Learn** | explain, how does, what is | "How does this work?" |

### Step 2: Ask the 5 Clarifying Questions

Not all questions apply to every request. Select the relevant ones:

#### 1. PURPOSE (Why)
> "What problem are you trying to solve?" or "Who will use this and for what?"

#### 2. SCOPE (What)
> "What should be included? What should NOT be included?"

#### 3. FORMAT (How)
> "What format do you expect? (bullet points, prose, code, diagram)"

#### 4. CONSTRAINTS (Limits)
> "Any constraints? (time, length, technology, style)"

#### 5. SUCCESS (Done)
> "How will you know this is successful?"

### Step 3: Confirm Understanding

Before proceeding, summarize:

```
I understand you want to:
- [Action]: [specific task]
- [Purpose]: [why this matters]
- [Output]: [expected deliverable]
- [Constraints]: [limitations to respect]

Shall I proceed?
```

## Examples

### Vague Request
> "Help me with my presentation"

### Clarified Intent
```
I understand you want to:
- Action: Improve/create presentation slides
- Purpose: [Need to ask - what's the presentation for?]
- Output: [Need to ask - slides? script? both?]
- Constraints: [Need to ask - time limit? audience?]

Let me ask:
1. What is the presentation about and who is the audience?
2. Do you