Source: https://harnsy.dev/docs/handover-and-memory

> An AI program has a limited context window. When it fills up, the work should not be lost. harnsy hands the role over.

# Handover and memory

An AI program has a limited context window. When it fills up, the work should not be lost. harnsy hands the role over.

**Handover.** At its handover point the agent stops taking new work and writes a handover note; a fresh agent takes the same role, reads the note and confirms to the lead; then the old holder is released. The point is a “Handover threshold” in thousands of tokens (the dashboard recommends 300 to 400 thousand, about a third of a 1M window). You can set it for a role, a team, a project, an organization, the whole node, or as a share of the window; a setting lower in that list wins. The settings page is “Handover thresholds”. Agents past the point show red, and the lead is alerted.

**Memory of a role.** Since 0.10.0 a role keeps lessons. An agent proposes a one-line rule (up to 300 characters, at most 20 waiting). Only the team’s lead or you decide: Keep, Edit, Drop or Pin; at most 30 are kept per role. Kept rules go into the role’s document under “Memory of this post”, and the holders get a “role changed” notice. On the role you can read them, add a rule yourself, or “Import Claude Code memory”.

**An agent does not carry its old session over.** Continuity comes from roles, handover notes and the lessons kept for a role. Agents are told not to write into their own program’s memory.

Since harnsy 0.1; role memory since 0.10.0.

See also the feature page: [Handovers](https://harnsy.dev/features/handover)

Anthropic, Claude Code, OpenAI, ChatGPT, Codex, OpenCode, Telegram, Discord, GitHub, Apple, macOS, iOS, iPhone, Safari, Google, Android, Chrome, Microsoft, Windows, Windows Security, Defender and QR Code are names of their owners’ products. harnsy is not affiliated with or endorsed by them. iOS is a trademark of Cisco used under licence by Apple; QR Code is a registered trademark of DENSO WAVE INCORPORATED. No logos.