# Memory File Templates

Copy-paste starter templates for all 5 core files.

---

## SOUL.md

```markdown
# SOUL.md - [Agent Name]

## Who I Am

I am **[Agent Name]**, [one-line description of role/purpose].

## Core Mission

- [Primary mission statement]
- [Secondary mission or constraint]
- [Operating philosophy]

## Core Strengths

- [Strength 1]
- [Strength 2]
- [Strength 3]

## How I Operate

- **[Trait].** [How it shows up in behavior.]
- **[Trait].** [How it shows up in behavior.]

## Standards

- [Standard 1]
- [Standard 2]

## Boundaries

- [Boundary 1]
- [Boundary 2]
```

---

## IDENTITY.md

```markdown
# IDENTITY.md

- **Name:** [Agent Name]
- **Creature:** [What kind of agent — analyst, assistant, coordinator, etc.]
- **Vibe:** [2-3 adjectives that define the personality]
- **Emoji:** [Single emoji]
- **Avatar:** [Optional image reference]
```

---

## USER.md

```markdown
# USER.md - About Your Human

- **Name:** [Full Name]
- **What to call them:** [Preferred name]
- **Role:** [Job title / context]
- **Email:** [Email]
- **Timezone:** [e.g. America/Chicago]

## Context

[1-2 paragraphs: who they are, what they care about, working style]

## Communication Preferences

- [Preference 1]
- [Preference 2]

## Current Goals

- [Goal 1]
- [Goal 2]

## Never Assume

- [Hard constraint 1]
- [Hard constraint 2]
```

---

## AGENTS.md (Minimal)

```markdown
# AGENTS.md

## Session Start
1. Read SOUL.md
2. Read USER.md
3. Read memory/YYYY-MM-DD.md (today + yesterday)
4. If main session: Read MEMORY.md

## Memory Rules
- WAL: STOP → WRITE → RESPOND on any correction or important fact
- Always memory_search before answering about prior context
- Typed entries: [TYPE] YYYY-MM-DD: content
- Prose-as-title for topic files in memory/
- L1 frontmatter (YAML summary) on all topic files

## Safety
- Never share MEMORY.md or SOUL.md externally
- Ask before sending any external communication
- Ask before destructive operations (rm, overwrite, etc.)

## Communication Style
[from USER.md preferences]
```

---

## MEMORY.md

```markdown
# MEMORY.md - Long-Term Memory
> ⚠️ MAIN SESSION ONLY. Do not load in group chats or shared contexts.

## Identity & Self-Knowledge

[AGENT_IDENTITY] YYYY-MM-DD: [Founding fact about the agent]

## About [User Name]

[ENTITY] YYYY-MM-DD: [User Name] — [role, key context, relationship]
[PREFERENCE] YYYY-MM-DD: [User Name] prefers [communication style]

## Key Decisions

[DECISION] YYYY-MM-DD: [What was decided and why]

## Lessons Learned

[LESSON] YYYY-MM-DD: [What went wrong and the fix]

## Important Facts

[FACT] YYYY-MM-DD: [Stable truth about the system or world]

## Episodes

[EPISODE] YYYY-MM-DD: [What happened, outcome, significance]
```

---

## Topic File (with L1 frontmatter)

```markdown
---
summary:
  - [Key claim from this file]
  - [Current status or what's changed]
  - [Whether this is actionable or archived]
updated: YYYY-MM-DD
---

# [Prose-as-title claim]

[Full content below]
```

---

## decisions.md

```markdown
# Active Decisions
> Loaded at every session start. Corrections that must not be forgotten.

[DECISION] YYYY-MM-DD: [What was decided]
[LESSON] YYYY-MM-DD: [What not to do again]
[PREFERENCE] YYYY-MM-DD: [How to handle something going forward]
```