Skip to content

Commit 87168bd

Browse files
dvdksnclaude
andcommitted
docs: rename the memory kit field to agentContext
Rename the spec.yaml memory: field to agentContext: across the spec reference, overview, and tutorial, and update the section heading, anchor, and cross-links. The memory file artifact and kits-memory/ directory keep their names. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
1 parent 393c838 commit 87168bd

3 files changed

Lines changed: 22 additions & 22 deletions

File tree

content/manuals/ai/sandboxes/customize/build-an-agent.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ agent:
8585
```
8686
8787
- `aiFilename: AGENTS.md` tells the sandbox to create `AGENTS.md` at launch
88-
and append the [`memory`](#prime-amp-with-memory) block to it. Amp reads
88+
and append the [`agentContext`](#prime-amp-with-memory) block to it. Amp reads
8989
this file for instructions.
9090
- `entrypoint.run` runs `amp` in "YOLO-mode" when the sandbox starts. Adjust if
9191
you want to pass different args on startup.
@@ -153,12 +153,12 @@ pick any name.
153153

154154
## Prime Amp with memory
155155

156-
The `memory` field appends markdown to `AGENTS.md` at sandbox creation.
156+
The `agentContext` field appends markdown to `AGENTS.md` at sandbox creation.
157157
Use it to tell Amp about the sandbox environment so it knows the
158158
conventions when it starts.
159159

160160
```yaml
161-
memory: |
161+
agentContext: |
162162
## Sandbox environment
163163
164164
You are running inside a Docker sandbox. The workspace is mounted at
@@ -204,7 +204,7 @@ commands:
204204
user: "1000"
205205
description: Install Amp
206206

207-
memory: |
207+
agentContext: |
208208
## Sandbox environment
209209
210210
You are running inside a Docker sandbox. The workspace is mounted at
@@ -282,7 +282,7 @@ Two loops help:
282282
- Edit the spec and re-run `sbx run --kit ./amp/ amp` to pick up changes.
283283
Remove the sandbox first (`sbx rm <name>`) for a clean start.
284284

285-
Flesh out the `memory` block as you refine how Amp should behave in the
285+
Flesh out the `agentContext` block as you refine how Amp should behave in the
286286
sandbox.
287287

288288
## Publish
@@ -311,7 +311,7 @@ the same decisions for your agent:
311311
placeholder. If it accepts the env var as-is, declare
312312
`environment.proxyManaged` in the kit and skip the user-side step.
313313

314-
The rest — memory block, network-policy iteration, packaging — is the
314+
The rest — agent-context block, network-policy iteration, packaging — is the
315315
same regardless of agent.
316316

317317
## Remove the stored secret

content/manuals/ai/sandboxes/customize/kit-reference.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Kit spec reference
33
linkTitle: Spec reference
4-
description: Field-by-field reference for a kit's spec.yaml — credentials, network rules, environment, commands, files, memory, and the agent block.
4+
description: Field-by-field reference for a kit's spec.yaml — credentials, network rules, environment, commands, files, agent context, and the agent block.
55
keywords: sandboxes, sbx, kits, spec.yaml, reference, schema, fields
66
weight: 22
77
---
@@ -264,10 +264,10 @@ Parent directories are created automatically. Existing files are
264264
overwritten. Absolute paths and path-traversal sequences (`../../`) are
265265
rejected.
266266

267-
## Memory
267+
## Agent context
268268

269269
```yaml
270-
memory: |
270+
agentContext: |
271271
<markdown>
272272
```
273273

@@ -283,10 +283,10 @@ sandbox, not to the workspace itself. For a workspace mounted at
283283
`/Users/you/AGENTS.md` (or whatever `aiFilename` is set to). It exists
284284
only inside the sandbox. Nothing is written to the host.
285285

286-
When several loaded kits declare `memory:` blocks, the content is split
286+
When several loaded kits declare `agentContext:` blocks, the content is split
287287
across files instead of being concatenated into the main one:
288288

289-
- Each kit's memory is written to `<kit-name>.md` in a sibling
289+
- Each kit's agent context is written to `<kit-name>.md` in a sibling
290290
`kits-memory/` directory next to the main memory file.
291291
- The main memory file gets a `## Kits` section listing every kit with
292292
a pointer to its file. The section is delimited by
@@ -306,12 +306,12 @@ agent:
306306
args: [<arg>, ...]
307307
```
308308

309-
| Field | Required | Description |
310-
| ----------------------- | -------- | ---------------------------------------------------------------------------------------------- |
311-
| `agent.image` | Yes | Docker image reference. See [Base image requirements](#base-image-requirements). |
312-
| `agent.aiFilename` | No | Memory filename (for example, `AGENTS.md`). Appends top-level [`memory`](#memory) at creation. |
313-
| `agent.entrypoint.run` | No | Command and args as a string array. Replaces the image's entrypoint. |
314-
| `agent.entrypoint.args` | No | Args appended to the image's existing entrypoint. |
309+
| Field | Required | Description |
310+
| ----------------------- | -------- | ----------------------------------------------------------------------------------------------------------- |
311+
| `agent.image` | Yes | Docker image reference. See [Base image requirements](#base-image-requirements). |
312+
| `agent.aiFilename` | No | Memory filename (for example, `AGENTS.md`). Appends top-level [`agentContext`](#agent-context) at creation. |
313+
| `agent.entrypoint.run` | No | Command and args as a string array. Replaces the image's entrypoint. |
314+
| `agent.entrypoint.args` | No | Args appended to the image's existing entrypoint. |
315315

316316
### Base image requirements
317317

content/manuals/ai/sandboxes/customize/kits.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -203,16 +203,16 @@ the agent project conventions, usage tips for a tool the kit installs,
203203
or other guidance that should be in scope when the sandbox runs.
204204

205205
```yaml
206-
memory: |
206+
agentContext: |
207207
Ruff is installed. Run `ruff check` before committing.
208208
Shared config lives at `/workspace/ruff.toml`.
209209
```
210210

211-
Both mixin and agent kits can declare `memory:`. The content is written
211+
Both mixin and agent kits can declare `agentContext:`. The content is written
212212
only when the active agent kit sets [`agent.aiFilename`](kit-reference.md#agent-block),
213213
which determines the memory file's name.
214214

215-
When more than one loaded kit declares a `memory:` block, each kit's
215+
When more than one loaded kit declares an `agentContext:` block, each kit's
216216
content is written to its own `<kit-name>.md` file under a sibling
217217
`kits-memory/` directory. The main memory file gets a `## Kits` section
218218
that points to each kit file:
@@ -227,7 +227,7 @@ that points to each kit file:
227227
└── git-ssh-sign.md
228228
```
229229

230-
See [`memory`](kit-reference.md#memory) in the spec reference for the full field schema.
230+
See [`agentContext`](kit-reference.md#agent-context) in the spec reference for the full field schema.
231231

232232
### Define an agent
233233

@@ -460,7 +460,7 @@ Docker credential store, so pushing to a private registry requires a prior
460460

461461
For a field-by-field reference of every `spec.yaml` block — top-level
462462
fields, credentials, network, environment, commands, static files,
463-
memory, and the agent block — see [Kit spec reference](kit-reference.md).
463+
agent context, and the agent block — see [Kit spec reference](kit-reference.md).
464464

465465
## Debugging
466466

0 commit comments

Comments
 (0)