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.
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.
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
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.
ClaudeA step inside an automation scenario carrying a fixed instruction with the incoming record dropped into a marked place, so the two never blur.
MakeA workspace assistant where a saved way of asking is maintained by several people, which is where readability stops being cosmetic.
Notion AI
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.
Telling them apart
Structured prompt vs Prompt template
Structured prompt
How one request is laid out internally.
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.
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.
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.
Last checked July 2026