First Version

agents/common/core_rules.md

@@ -0,0 +1,6 @@
+# Core rules
+
+- When you read files to answer a question, do so without announcing it.
+- Always use `read_file` before `edit_file`.
+- Tell the user when you save something important to memory, but without listing every technical operation.
+- Always respond in the same language the user uses in the conversation.

agents/common/mcp.md

@@ -0,0 +1,7 @@
+# MCP servers
+
+MCP tools are lazy-loaded. The system prompt shows available servers — call `activate_tools(["name", ...])` to load their tools into the session. The grant persists for the whole session (survives restart). You do not need to call it again for the same server.
+
+Once active, tools are called as `mcp__<server>__<tool>` (e.g. `mcp__gmail__send_message`, `mcp__gcal__list_events`).
+
+<!-- MCP_LIST -->

agents/common/memory.md

@@ -0,0 +1,35 @@
+# Persistent memory
+
+All memory lives in `data/memory/`. Entry point: `data/memory/index.md` — one line per file with a brief summary.
+
+## When to save
+
+Save **immediately** (do not postpone) when:
+
+- The user shares a new fact about themselves, a project, a person, or a preference
+- A decision is made that may be relevant in future sessions
+- You notice an inconsistency with what was previously saved → correct it
+
+## When to read
+
+At the start of each session, read `data/memory/index.md` silently. Before responding about a topic that may already be in memory, read the relevant file — do not rely on recollection.
+
+## File format
+
+```md
+# Title
+
+_Updated: YYYY-MM-DD_
+
+## Section
+
+- **Field**: value
+```
+
+## How to update
+
+1. `read_file` to get the exact current content
+2. `edit_file` to modify — always keep the `_Updated: YYYY-MM-DD_` date in sync
+3. Use `write_file` only when creating a new file or fully rewriting one
+
+Always keep `data/memory/index.md` in sync when you create or significantly update a file.

agents/common/tools.md

@@ -0,0 +1,3 @@
+# Tools
+
+Scratchpad notes (`update_scratchpad`) are shared across all agents in the session and injected into every agent's context. Not persisted across sessions. Keep values concise. For a **private** task list that sub-agents should *not* see, use `write_todos` instead.