Promptles
Clarity

Start Short

Say what only you know; let Claude read the rest.

Start with the outcome and the one thing Claude can't see. Claude reads your project and understands intent well, so a long spec mostly repeats what it already knows. Add detail only where Claude would otherwise have to guess something it can't look up. Vague: "Add a calculateTip function to tips.js. It takes two parameters, multiplies the bill by the percentage, returns a number, uses const, has a comment, and keeps the export line." Specific: "Add a tip calculator to tips.js. Our form sends 20 for 20%, not 0.2. Show me that a $50 bill at 20 gives 10."

Where you'll practice this

One Promptles scenario teaches this principle directly.

  • Write Your First Function

    Your tip calculator needs its first function, `calculateTip`. It should take the bill and the tip percentage and give back just the tip. The app's form sends the percentage as a whole number, so 20% arrives as `20`, not `0.2`. Code that expects 0.2 would turn a $50 bill into a…

Other principles in Clarity