Skip to content

Glossary

Structured prompt

A structured prompt organises a request into labelled sections instead of one continuous paragraph, which makes a long instruction much easier to follow and to edit.

In plain terms

Laying the request out with headings instead of writing it as prose. The task here, the material there, the rules somewhere else, the shape of the answer at the end. It looks fussy for a short request and becomes the difference between working and not once the instruction gets long.

01

Why it matters

Because long instructions written as prose lose their middle. Conditions stated in the third sentence of a dense paragraph are followed less reliably than the same conditions under a heading, and the effect grows with length, which is exactly when the instruction matters most.

02

How it works

The labels separate kinds of thing that would otherwise blur. Instructions, material to work on, examples and the required shape of the answer are four different sorts of content, and running them together as prose leaves the reader inferring which is which. Marking them explicitly removes an inference that was never reliable.

The gain scales with length, which is why short requests do not need it. A two-sentence instruction has no middle to lose. A page of conditions, exceptions and material has a great deal of middle, and that is where things stated once and never repeated tend to go unheeded.

Separating the material from the instruction is the part that also matters for safety. When the two are visually distinct, text arriving in the material that looks like an instruction is easier to keep in its place. That does not make it a defence, and it removes one of the easier ways for the boundary to be lost by accident.

The maintenance benefit is larger than the quality benefit and is the one nobody mentions. A sectioned request can be edited in one place without rereading the whole thing, reviewed by somebody who did not write it, and diffed when it changes. A dense paragraph has to be reread entirely every time anybody touches it.

The same instruction, two layouts

The same instruction, two layoutsThe reason this looks like a style question and is not is that both layouts contain identical words. Nothing has been added, clarified or emphasised; the same conditions are present either way, and a careful human reader would extract the same instruction from both. What changes is how much of that extraction has to be done by inference. In prose, whether a sentence is an instruction, an example or part of the material is worked out from context, and context is exactly what thins in the middle of a long passage. Marking it explicitly removes that inference. The second effect is organisational and, over a year, larger: a request nobody can safely edit stops being edited, then stops matching what the team actually wants, and quietly becomes something everybody works around rather than fixes.One paragraphReads naturally.Fine at two sentences.Loses its middle as it grows.Reread in full on every edit.Labelled sectionsLooks fussy at two sentences.Holds together at a page.Conditions stay where they wereput.Edited in one place,reviewable.Neither column is better ingeneral, and the crossoverarrives earlier than peopleexpect. It is usually the momenta second person has to changesomething they did not write.
The reason this looks like a style question and is not is that both layouts contain identical words. Nothing has been added, clarified or emphasised; the same conditions are present either way, and a careful human reader would extract the same instruction from both. What changes is how much of that extraction has to be done by inference. In prose, whether a sentence is an instruction, an example or part of the material is worked out from context, and context is exactly what thins in the middle of a long passage. Marking it explicitly removes that inference. The second effect is organisational and, over a year, larger: a request nobody can safely edit stops being edited, then stops matching what the team actually wants, and quietly becomes something everybody works around rather than fixes.
03

Seen in the wild

  • An assistant given a long standing instruction covering several conditions, where the conditions stated in the middle are the ones most often missed.

    Claude
  • A step inside an automation scenario carrying a fixed instruction with the incoming record dropped into a marked place, so the two never blur.

    Make
  • A workspace assistant where a saved way of asking is maintained by several people, which is where readability stops being cosmetic.

    Notion AI
04

Common misconceptions

People assume

It is a formatting preference.

In fact

It changes results on long requests, and the effect grows with length. Conditions buried mid-paragraph are followed less reliably than the same conditions under a heading. That is a behavioural difference rather than a stylistic one, even though the change looks purely cosmetic.

People assume

It matters most to the system reading it.

In fact

The larger benefit accrues to the people maintaining it. A sectioned request can be edited in one place, reviewed by somebody who did not write it, and compared across versions. A dense paragraph forces a full reread on every change, which is what makes long requests decay.

05

Telling them apart

Structured prompt vs Prompt template

Structured prompt

How one request is laid out internally.

Prompt template

A request reused with the variable parts marked.

Structure is about legibility; a template is about reuse. Most working requests are both, and the two are decided separately.

06

Questions

When is it worth the effort?
Once the instruction is long enough to have a middle, or once more than one person maintains it. Below that, prose is fine and the sections are overhead. The threshold arrives sooner than people expect, usually the first time somebody adds a condition to something written by a colleague.
Does the labelling itself matter?
Consistency matters more than the particular scheme. What the sections are called is largely arbitrary; that the same kinds of content are always marked the same way is what makes a request legible to a reader and stable to edit. Changing the scheme mid-life is where confusion arrives.
Does it help with instructions hidden in the material?
It helps by keeping the boundary visible and it is not a defence. When material is clearly marked as material, text inside it that reads like an instruction is easier to treat as content. Anything that must not happen still needs a check outside the request rather than a layout convention.
07

Key takeaways

  • Labels separate instructions, material, examples and the required shape.
  • The benefit scales with length, so short requests genuinely do not need it.
  • Marking material as material keeps a boundary visible; it is not a defence.
  • The maintenance gain is the larger one, and the one nobody mentions.
09

Tools that use this

  • Claude

    Long standing instructions where mid-paragraph conditions are missed.

  • Make

    A fixed instruction with the record dropped into a marked place.

  • Notion AI

    A saved way of asking maintained by more than one person.

Last checked July 2026

All glossary terms