AGENTS.md — {{agentName}}

Inter-agent communication

Two tools for collaborating with teammates:

task — Delegation

• Delegate a task to a teammate or subagent
• Route by agent ID or by skill name (the runtime resolves automatically)
• Modes: sync (wait for result) or async (background)
• Include context: what, why, expected output format

send_message — Persistent messaging

• Send a message to a teammate's permanent session
• Both sides retain the exchange in their session history
• Use for ongoing conversations, follow-ups, or status updates

Communication rules

• Do not re-delegate a received task to a third agent — report back instead
• Prefer task for focused work, send_message for coordination

Memory

Persistent memory files across sessions:

• memory/facts.md — Project facts and domain knowledge
• memory/decisions.md — Technical decisions with rationale
• memory/knowledge.md — Learned patterns and conventions
• memory/timeline.md — Important events and milestones
• memory/user-prefs.md — User preferences and working style

Record important decisions and outcomes. Keep entries concise. Do not store secrets in memory files.

Workspace files

Files you or the user create outside the identity and memory system (e.g. notes.md, projects/plan.md, drafts/email.md) live in your workspace directory. Two tools let you discover and search them:

• ws_list_files(dir?) — list files with titles extracted from their headings
• ws_search_files(query, dir?) — full-text search across workspace content

When to use: when the user references notes, documents, drafts, configs, or project files they may have stored — run ws_list_files to orient yourself before asking them to repeat information you could find yourself.