24 of 81
ContentsPart III · Chapter 6

Chapter 6The prompt

Everything the model reads

This chapter uses the word prompt in its full sense: everything the model reads for one reply. Your message is part of it, usually the last part. People who build these systems also call the whole of it the context. Anthropic defines context as “the set of tokens included when sampling from” a language model, which means every piece of text the model is given when it writes its reply.1 Tokens, as Chapter 2 showed, are the word-pieces a model reads and writes.

Two parts from Chapter 1’s picture show up here before their own chapters. The harness is the app or software around the model; it puts the prompt together (Chapter 7). Tools are the actions the harness can take when the model asks, such as searching the web or reading a file (Chapter 8). For now, that is all you need to know about them.

A prompt is built in layers, and different people write different layers. Figure 6.1 shows a typical stack, top to bottom.

At the top sits the system prompt. In a company’s own chat app, the company that made the model writes it. In Anthropic’s case it supplies the date and nudges behavior, such as always putting computer code in a tidy format called Markdown.2 Anthropic publishes the system prompts for its Claude apps, and notes that those prompts don’t apply when developers use its models directly, through what the industry calls an API.2 Next come the app instructions, written by whoever built the app: a school, a bank, a software company. PS2 Pal’s persona was this layer. OpenAI’s rules name the same split: “system” messages added by OpenAI, “developer” messages from the app’s builder, and “user” messages from you.3

Below those sit the tool descriptions, a short note for each tool the app offers, saying what it does and how to ask for it. Anthropic says that when an app gives Claude tools through its API, the API “constructs a special system prompt from the tool definitions” and the app’s own instructions.4 The model never sees a tool itself. It sees only the description and, later, whatever the tool sends back.5

Then come memory and documents. A document might be a file you uploaded or pages a search found. In a 2020 study, a model that looked up relevant documents and read them along with the question gave more specific and factual answers than the same kind of model without that step.6 Memory is notes the harness saved earlier and feeds back in. As of 2026, for example, Anthropic says Claude can “remember context from your chats and carry it into new conversations”; a summary, updated every 24 hours, “provides context for every new standalone conversation.”7 Spot it today: look for a memory setting in your app, and see whether it lets you read what was saved.

System promptthe model’s maker, in its own appsApp instructionswhoever built the appTool descriptionswhoever built each toolMemory and documentssaved notes, files, search resultsConversation so farkept and resent by the harnessEarlier tool resultsprograms the tools ranYour messageyouwrittenby othersby youModel: reads it all, then replies
Figure 6.1. What the model reads for one reply. Read from the top. Each band names a layer and who writes it; only the bottom band comes from you. The order is simplified: real products arrange the layers differently.

Try it: read each layer of the stack, and who wrote it.

What the model actually reads

Illustration

A stack of seven layers the model reads, top to bottom: system prompt, app instructions, tool descriptions, memory and documents, conversation so far, earlier tool results, and your message last.

  1. System promptwritten by the model's providerCore rules and persona.
  2. App instructionswritten by whoever built the appe.g., "You are a public library's help-desk assistant. Answer questions about hours, holds and library cards."
  3. Tool descriptionswritten by the harnessWhat the model can ask for, such as "search the catalog."
  4. Memory and documentswritten by the harnessSaved preferences, files, search results.
  5. Conversation so farwritten by the harnessSometimes summarized to save space.
  6. Earlier tool resultswritten by the harnessWhat came back from tools used earlier.
  7. Your messagewritten by you"Is the library open on Sunday?"

All of it goes to the model as one long document. The reply comes back below it.

Everything above your message was written by someone other than you. Order simplified; real products arrange layers differently.

The conversation so far comes next. The model keeps nothing between replies. Each time, the harness sends the stack again, with the conversation included; Anthropic describes each new request as “containing the original messages” along with the model’s last reply and any new results.5 In a long chat, the harness may send a summary instead of every word.1 Then come earlier tool results: what came back the last time a tool ran, as plain text. Last of all comes your message, the only layer you wrote.

Even the smallest piece of tool text counts. In a 2025 test of AI agents, a tool that ran code replied “Code executed successfully with no output” whenever a program printed nothing. Even strong models read “no output” as a sign that something was wrong. They tried again, and some decided the tool was broken and fell back on counting words by hand, which failed.8 The study’s lesson was that everything about a tool, down to “the messages it sends back,” is part of the prompt.8

Notes (8)
  1. 1Anthropic, “Effective context engineering for AI agents,” Anthropic Engineering, September 29, 2025, https://www.anthropic.com/engineering/effective-context-engineering-for-ai-agents (accessed October 27, 2026).
  2. 2Anthropic, “System prompts (release notes),” Claude Platform Docs, https://platform.claude.com/docs/en/release-notes/system-prompts/overview (accessed October 26, 2026).
  3. 3OpenAI, “OpenAI Model Spec (2025-10-27 version),” October 27, 2025, https://model-spec.openai.com/2025-10-27 (accessed October 27, 2026).
  4. 4Anthropic, “Define tools,” Claude Platform Docs, n.d., https://platform.claude.com/docs/en/agents-and-tools/tool-use/define-tools (accessed October 27, 2026).
  5. 5Anthropic, “How tool use works,” Claude Platform Docs, https://platform.claude.com/docs/en/agents-and-tools/tool-use/how-tool-use-works (accessed October 26, 2026).
  6. 6Patrick Lewis, Ethan Perez, Aleksandra Piktus, Fabio Petroni, Vladimir Karpukhin, Naman Goyal, Heinrich Küttler, et al., “Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks” (preprint, arXiv, May 22, 2020), https://doi.org/10.48550/arXiv.2005.11401.
  7. 7Anthropic, “Use Claude's chat search and memory to build on previous context,” Claude Help Center, https://support.claude.com/en/articles/11817273-use-claude-s-chat-search-and-memory-to-build-on-previous-context (accessed October 26, 2026).
  8. 8JV Roig, “Towards a Standard, Enterprise-Relevant Agentic AI Benchmark: Lessons from 5.5 billion tokens' worth of agentic AI evaluations” (preprint, arXiv, November 11, 2025), https://doi.org/10.48550/arXiv.2511.08042. Cited at §5.2.6.

Chapter 6 · page 2 of 4

Turn pages with the ← and → keys.

Cite this page

Using this book

© 2026 Steve Sparks. All rights reserved. Teachers and students may assign, read, quote and excerpt chapters of this book for classes and study, with credit to Steve Sparks and a link to aifromthepartsup.com. Anyone may quote short passages and cite any page, with a link back. To repost, reproduce or sell the book or larger parts of it, ask through GitHub.

Quoted material and figures from other sources remain their owners'.