self-customize

1# Self-Customization
2 
3You can modify your own environment. Different kinds of changes have different workflows.
4 
5## Decision Tree
6 
7**What needs to change?**
8 
9- **Memory or standing instructions** → Edit `memory/` or `instructions.prepend.md` directly, no approval needed. The workspace is persisted on the host. The composed provider document (`CLAUDE.md` or `AGENTS.md`) is regenerated every spawn and must not be edited.
10- **System package (apt) or global npm package** → `install_packages`. Requires admin approval. On approval, image rebuild + container restart happen automatically.
11- **MCP server** → `add_mcp_server`. Requires admin approval. On approval, container restarts with the new server wired up (no rebuild — bun runs TS directly).
12- **Your source code or Dockerfile** → Delegate to a builder agent via `create_agent` (see below).
13- **A new specialist capability** → `create_agent` to spin up a dedicated agent for it.
14 
15## Workflow: Code Changes via Builder Agent
16 
17For anything that requires editing source files (your own code, Dockerfile, etc.), **do not edit directly** — delegate to a builder agent. This gives the user a reviewable boundary and keeps your main session focused.
18 
191. Describe what you need changed in concrete terms (files, behavior, acceptance criteria)
202. Call `create_agent({ name: "Builder", instructions: "<builder prompt>" })` — the returned agent group ID is your builder
21…