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.
Examples
Section titled “Examples”| 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 |
Rules of thumb
Section titled “Rules of thumb”- 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.
The bot helps you teach it
Section titled “The bot helps you teach it”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.