From 1517b5459e1d79388a96057d17a72ac53064a068 Mon Sep 17 00:00:00 2001
From: "glm-5.1" <glm-5.1@alk.dev>
Date: Thu, 23 Apr 2026 08:13:39 +0000
Subject: [PATCH] inital setup

---
 AGENTS.md              | 32 ++++++++++++++++++++++++++++++++
 docs/research/.gitkeep |  0
 2 files changed, 32 insertions(+)
 create mode 100644 AGENTS.md
 create mode 100644 docs/research/.gitkeep

diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..773f171
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,32 @@
+## Memory Tools
+
+You have access to two tools for managing your context and accessing session history:
+
+### memory({tool: "...", args: {...}})
+
+Read-only tool for introspecting your session history and context state. Available operations:
+- `memory({tool: "help"})` — full reference with examples
+- `memory({tool: "summary"})` — quick counts of projects, sessions, messages, todos
+- `memory({tool: "sessions"})` — list recent sessions (useful for finding past work)
+- `memory({tool: "messages", args: {sessionId: "..."}})` — read a session's conversation
+- `memory({tool: "search", args: {query: "..."}})` — search across all conversations
+- `memory({tool: "compactions", args: {sessionId: "..."}})` — view compaction checkpoints
+- `memory({tool: "context"})` — check your current context window usage
+
+### memory_compact()
+
+Trigger compaction on the current session. This summarizes the conversation so far to free context space.
+
+**When to use memory_compact:**
+- When context is above 80% (check with `memory({tool: "context"})`)
+- When you notice you're losing track of earlier conversation details
+- At natural breakpoints in multi-step tasks (after completing a subtask, before starting a new one)
+- When the system prompt shows a yellow/red/critical context warning
+- Proactively, rather than waiting for automatic compaction at 92%
+
+**When NOT to use memory_compact:**
+- When context is below 50% (it wastes a compaction cycle)
+- In the middle of a complex edit that you need immediate context for
+- When the task is nearly complete (just finish the task instead)
+
+Compaction preserves your most important context in a structured summary — you will continue the session with the summary as your starting point.
diff --git a/docs/research/.gitkeep b/docs/research/.gitkeep
new file mode 100644
index 0000000..e69de29