← StoryboardsStoryboard · 6 frames · Stage 03, Instructions & contracts

Prompting Is Not the Skill You Think It Is

A prompt shapes the odds; it doesn't enforce anything. Six frames on asking versus checking, and the skill that actually matters.

01 / 06

  1. PRUNING MY POTHOSSYSTEMS · STAGE 03A STORYBOARD IN 6 FRAMESPromptingis not theskill youthink it isPLEASEALWAYS replyin JSON!!!a sign isn't a fenceasked nicely.never checked.ALWAYS.NEVER.YOU MUST.MORE INPUTREJECTA CHECK OUTSIDE THE PROMPT
    A prompt shapes what the model is likely to produce. Shaping isn't enforcing, so anything that must hold needs a check that lives outside the prompt.
    PRUNINGMYPOTHOS.COM01 / 06

    A polite lawn sign says: please, always reply in JSON. Footprints cross the grass anyway. A sign isn't a fence: it was asked nicely and never checked. Always, never and you must are just more input, which is not the same as a check outside the prompt that can reject a bad result.

  2. PRUNING MY POTHOSWHAT AN INSTRUCTION CAN EXPRESSFive things aprompt can say.1Intentwhat you're trying to achieve (the part skipped most)2Constraintswhat must not happen3Examplestwo or three showing the pattern4Requested shapethe format you want back5Prioritieswhat wins when instructions pull apart
    Each of these narrows the field of likely answers. None of them closes it.
    PRUNINGMYPOTHOS.COM02 / 06

    A prompt can express intent, what you are trying to achieve and the part skipped most; constraints, what must not happen; examples, two or three showing the pattern; the requested shape of the output; and priorities, what wins when instructions pull apart. Each narrows the field of likely answers. None of them closes it.

  3. PRUNING MY POTHOSWHAT IT CANNOT DOShoutingisn't checking.ALWAYS RESPONDIN JSON.VERY IMPORTANT!!inputnoted!{ … }{ … }{ … }{ … }Sure! Here's…occasionally.and nothing noticed.“ALWAYS”a validator
    “Always” and “never” are more input, and more input is not a check. If you want a step that notices and objects, you have to build it.
    PRUNINGMYPOTHOS.COM03 / 06

    An instruction says ALWAYS RESPOND IN JSON, VERY IMPORTANT. The Model says noted. Most replies are JSON, and occasionally one is plain text, and nothing notices. Emphasis is crossed out in favour of a validator: always and never are more input, and more input is not a check.

  4. PRUNING MY POTHOSLANGUAGE AND CONTRACTSAsk,or check?please replyin JSON :)A prompttells the modelwhat you wantorder_id: stringamount: numberreason: stringREJECTA contractgives softwaresomething to check
    Plain language can be the human-facing interface. Something checkable still has to sit underneath it.
    PRUNINGMYPOTHOS.COM04 / 06

    A prompt tells the model what you want, like a sticky note asking for JSON. A contract gives software something it can check: fields and types that pass or get rejected. Plain language can be the human-facing interface, with something checkable underneath.

  5. PRUNING MY POTHOSTHE ACTUAL SKILLRead the gap,then pick a fix.asked: 3 slogansgot: 7, and a poemthe skill is reading this gapWrong tone, lengthsay the thingyou didn't sayWrong shapenow and then? usea schema + validatorWrong factstrace the evidencebefore the wordingMostly rightwrong sometimes?design for that
    Right most of the time and wrong occasionally, in ways that matter: that's when to stop editing the prompt.
    PRUNINGMYPOTHOS.COM05 / 06

    Asked for three slogans, got seven and a poem: the skill is reading that gap. Wrong tone or length: say what you didn't say. Wrong shape now and then: use a schema and a validator. Wrong facts: trace the evidence before the wording. Mostly right but wrong sometimes: stop editing and design for that.

  6. PRUNING MY POTHOSTREAT INSTRUCTIONS LIKE CODETreat a promptlike code.prompt.mdv7: shorterv6: tone fixv5: examplesIN GITrefund requestangry customerempty inputvery long threadrerun the same setafter every edit
    If a prompt does real work, handle it like code: keep it in version control, note what a change should do, and rerun a small fixed set of inputs after every edit.
    Read the whole explanationpruningmypothos.com/systems/prompting-is-not-the-skill-you-think-it-is/PRUNINGMYPOTHOS.COM06 / 06

    A prompt file with its version history, kept in git, beside a fixed set of test inputs rerun after every edit. If a prompt does real work, keep it in version control, note what a change should do, and rerun the same inputs after each change.