When you genuinely do not know

Sometimes you cannot be specific, because you do not know enough yet. That is normal, especially early. The move is to be specific about the process instead of the outcome: Now you get options instead of a surprise. Pick one, then ask for that one thing. This pattern — look first, then act — is worth more than any prompt template. It costs you one extra message and saves you the "that is not what I meant" loop.

What you just learned

Aim for exactly one reasonable interpretation. Name the file and the actual change; skip words like "better" and "clean up". Specific is not the same as long. When you do not know the details, ask Claude to look and suggest before it acts. Next: keeping the conversation focused as it gets long.

You're reading as a guest — progress saves to this device only.

FreeYour first prompt

The specificity lever

6 min read·Lesson 2 of Your first prompt

Listen instead

2:30 · spoken companion to this lesson

0:002:30

You have the shape of a prompt: where, what, and sometimes why. This lesson is about the one dial that moves quality more than anything else, and how to turn it up without writing an essay.

Watch it fail first

Start Claude in your project and ask for something genuinely vague:

make my page better

Look at what came back. It probably changed several things at once, and some of them are not what you would have chosen. "Better" could mean the colours, the wording, the layout, the spacing, or all four. Claude had to guess, and you now have to read the whole file to find out what it decided.

Press Esc Esc and restore the code. Now do it properly.

One reasonable interpretation

in index.html, change the background to a light cream colour and make the heading font larger

Two changes, both named, nothing to guess. You can check it in five seconds instead of reading everything.

That is the whole test: is there exactly one reasonable interpretation of what I just asked for?

A quick checklist:

Did you name the file? Not "the page", not "the code".
Did you name the actual change? Not "improve", "clean up", "make it nicer".
If something new is being created, did you say where it goes?

Being specific is not the same as being long. If a detail does not change the outcome, leave it out. You are aiming for no ambiguity, not maximum words.

The words that always cost you

These sound like instructions but contain no information:

Vague	What to say instead
"make it better"	name the property: colour, size, spacing, wording

practice

Try this lesson in a guided terminal.

Context windows and /clear

Watch it fail first

One reasonable interpretation

The words that always cost you

When you genuinely do not know

Try it now

What you just learned