Prompt Design
Prompting is like web design. Let's call it prompt design, and build better tools for it.
Posted By Arvid
7 minutes read.
I'm usually averse to the common habit of trying to find old-world analogues to new-world phenomena. So please bear with me as I commit that exact sin: let me present the case for why prompting should be called prompt design and be likened to web design.
I view prompting as communicating with a time-constrained human. While LLM-specific techniques are certainly helpful (most notably chain-of-thought), I've found that one of the best ways to improve performance is to just have extremely clear and high-quality instructions, similarly to how clarity and conciseness helps real humans understand better too.
Prompting-as-clear-communication makes prompting sound like writing. Most of the prompting I am doing, however, is parametric: I have a number of input variables, and need to dynamically adapt my prompt to those.
Hence, prompting-as-clear-communication-with-dynamic-input feels like the most accurate characterization.
What other field is about communicating clearly with dynamic input? Web design.
Let's list out all the similarities. Prompting and web design both:
require clarity, and have communication as the primary goal;
need to respond to dynamic content, unlike writing or magazine layout; and
need to adapt their content to different sizes — screen sizes for web design, context windows for prompting.
In my experience from doing both prompting and web design, I've also found that I have similar developer preferences in the two areas:
Looking at the actual prompt is super important, just like looking at the rendered website is super important. I cannot design a website if I have to simulate the HTML and CSS rendering process in my mind. Similarly, it is really hard to write good and clear prompts without looking at the rendered output of a prompt with all input variables filled in.
For example, the prompt
"Hi ${username} ${message}"
may look reasonable, until you render it and realize that the user name blends in with the message.
Composable components are useful in both prompting and web design.
Declarative is better than imperative for both. It is really hard to change a website where all HTML elements are created with
document.createElement
calls. Similarly, reading and changing a prompt that consists of a long sequence ofstr += "..."
easily becomes unmanageable.In both, I sometimes want to achieve "pixel perfection". When prompting less capable models (GPT-3.5 and worse), I want to make sure that I have no extraneous newlines or other types of imperfect formatting, and when designing a website, sometimes every pixel matters.
For LLM agents, it is possible to take the analogy even further: agent prompting can be seen as building an interactive website for the agents, where they can "click buttons" by calling functions, and where the prompt re-renders in response to a function call, just like a website re-renders in response to a button click.
Of course, there are differences between prompt design and web design:
Prompting deals with text only (for now!).
Caching is different: for agents in particular, you want to make sure that your re-renders are cheap by only changing the later parts of the prompt. There's a contrived parallel here to the web (you want to cache-optimize your website), but I think it is fundamentally quite a different challenge.
Still, the similarities have convinced me that prompting should be called prompt design, not prompt engineering. Writing a prompt feels just like designing a website, and should thus be named the same way too.
The prompt design perspective inspired me to create Priompt, a React-like, JSX-based prompt design library.
Priompt v0.1: a first attempt at a prompt design library
Priompt is a first attempt at creating a prompt design library inspired by modern web design principles. We are using it internally at Anysphere, and we like it a lot.
I think it is probably not exactly correct in all of its abstractions, but I am at least convinced that JSX is a far more ergonomic way to write prompts than string templates. Even the simple thing of trivially being able to comment out parts of your prompt makes the iteration loop much faster.
Priompt also comes with a (very hastily put together) preview website, where you can preview your prompt on real data. When developing your application, you can log the serialized props
coming into a component on every request. Then, when you see unexpected behavior, you can go to the Priompt preview, look at the exact prompt, and change the source code and have the prompt update with the same props
as the real request. We've found that this makes it easier to iterate on prompts.
If you try it out, please let me know your thoughts! I'd love to see more ideas in the same vein, or just be told that I'm completely wrong and prompt design is stupid :).
Caveats
Models change quickly, and so too do prompting techniques have to. With that, I think there are a few caveats with the prompt design characterization:
Pixel-perfect designs are unimportant for GPT-4, and will probably be obsolete for GPT-4.5 or better models.
The context window constraint may disappear, if one extrapolates the recent trend of long-context models. I am not convinced of this, though.
OpenAI appears to be moving in the direction of offering less and less control over the prompt to developers; it is possible that in a year there will be no such thing as a prompt, with the API call just asking us for the raw inputs plus an instruction. This trend of less control started with the chat format and has continued with the recently announced function calling.
It's possible that caching is one of the most important aspects of prompting, in which case it starts sounding a bit more like engineering than design.
Perhaps prompt design is too low-level, and should be left to a higher-level framework or compiler (e.g. langchain). I think this may be true, but given the quickly changing nature of the LLMs, I personally prefer to be as close to the raw model as possible.
Obligatory last note
...because I'd love to work with you: At Anysphere, we're building Cursor, an AI-first code editor. If you're excited about prompt design, LLMs for coding, or building beautiful products, please email me at arvid@anysphere.co. We're 5 people in San Francisco, all of my coworkers are exceptional, and we want a few more exceptional people — coders and designers — to join us in building the future of coding.