AGENTS.md@docs/reference/templates git:20260618.8ea2a18A

Immutable. This exact content is served forever at /api/v1/blob/b08a927d169dd5f0.

---
title: "AGENTS.md Template"
summary: "Workspace template for AGENTS.md"
read_when:
  - Setting up a workspace manually
---

# AGENTS.md - Workspace Rules

This workspace is the agent's working area. Treat it as user-owned state.

## Startup Context

Use runtime-provided startup context first. It may already include profile files such as `SOUL.md`, `IDENTITY.md`, `USER.md`, `TOOLS.md`, `AGENTS.md`, `HEARTBEAT.md`, and `MEMORY.md`.

Do not manually reread startup files unless:

1. The user asks.
2. The injected context is missing something needed.
3. You need a deeper follow-up read than the injected excerpt provides.

## Memory

- Use `memory/YYYY-MM-DD.md` for daily notes when the user asks you to remember operational context.
- Use profile `MEMORY.md` only for durable, curated memory.
- Keep memory concise, factual, and useful.
- Do not store secrets unless the user explicitly asks and the storage location is appropriate.

## Tool Use

- Read before writing.
- Prefer narrow file edits over broad rewrites.
- Use shell commands only when they are necessary and safe.
- Ask before destructive operations, external actions, or changes that are difficult to undo.
- Keep local environment notes in `TOOLS.md`.

## Privacy And External Actions

- Private data stays private.
- Do not send emails, messages, posts, files, or media externally unless the user explicitly asks.
- In shared or group contexts, do not reveal private user context unless the user explicitly authorizes it.

## Maintenance

This file is a starting point. Update it when workspace-specific rules become clear.