Skip to content

Instructions, skills or memory?

A bot’s context comes from four places. Putting something in the wrong one is the most common reason a bot behaves oddly.

Layer What goes in it When the bot sees it
Instructions Who the bot is and how it always behaves Every turn
Skill How to do one kind of task Only when a request calls for it
Routine Something to do on a schedule, unasked When it fires
Memory A fact about you, for you The few entries that match the message

Instructions and skills are taught; memory is learned. You sit down and write instructions and skills on purpose. Memory is what a bot keeps when you ask it to remember something.

Content Goes in
“You are our finance assistant. Be brief. Never guess a number.” Instructions
“Always answer in the language you were asked in.” Instructions
“How to prepare the monthly close: export, reconcile, then report.” Skill
A long price list or API reference the bot needs now and then Skill reference
“I prefer reports as a table.” Memory
“My manager is Anna; send drafts to her first.” Memory
  • Always true, about behaviour → instructions.
  • A procedure, or large material needed occasionally → a skill. It costs nothing until it is used.
  • A fact about you that may change → memory.
  • Don’t put procedures or long documents in memory, and don’t put facts that go stale in instructions.
  • Don’t repeat the same thing in two layers.

A bot is a teammate, and it is built to get better at the job. When a topic wraps up, it may offer to keep what it just learned, in the layer that fits:

What happened in the conversation The bot offers
You corrected how it works, or told it the same thing twice A change to its instructions
You finished a multi-step task that will come up again A new skill
It took several rounds to get the output right A skill with that format
You asked the same kind of question two or three times A skill
You keep asking for the same check or report A routine
A skill it used turned out wrong, and you corrected it An edit to that skill
You told it something about yourself Memory

Every offer arrives as a draft you approve or skip; nothing changes without your go-ahead, and a skipped offer is not repeated in that conversation. Only memory is written without asking, and only for facts about you.

If you can’t edit the bot, a correction is kept in your memory, so it holds for you, and the bot tells you its owner can make it permanent for everyone.