engram-memory-protocol

name	engram-memory-protocol
description	Persistent memory discipline for Engram contributors. Trigger: Decisions, bugfixes, discoveries, preferences, or session closure.
license	Apache-2.0
metadata	{"author":"gentleman-programming","version":"1.0"}

When to Use

Use this skill when:

• Making architecture or implementation decisions
• Fixing bugs with non-obvious root causes
• Discovering patterns, gotchas, or user preferences
• Closing a session or after compaction

---

Save Rules

Call mem_save immediately after:

• decision
• bugfix
• pattern/discovery
• config/preference changes

Use structured content:

• What
• Why
• Where
• Learned

Use stable topic_key for evolving topics.

---

Search Rules

• On recall requests: mem_context first, then mem_search.
• Before similar work: run proactive mem_search.
• On first message: if user references the project, a feature, or a problem, call mem_search with their keywords before responding.

---

Session Close Rules

Before saying done/listo:

1. Call mem_session_summary.
2. Include goal, discoveries, accomplished, next steps, relevant files.

After compaction:

1. Save summary first.
2. Recover context.
3. Continue work.