engram-memory-protocol

SkillDocs & knowledge

Gives your agent a routine for saving decisions and lessons to a persistent memory and recalling them later.

Then ask your AI: use the engram-memory-protocol skill

Details

Instructions available. Your AI can read the instructions. Execution depends on the setup they require.

Add it as a step in a pipeline you build on Ahel, or connect Ahel to Claude, ChatGPT, Cursor, Claude Code or Codex and ask your AI to use it.

About this skill

Persistent memory discipline for Engram contributors. Trigger: Decisions, bugfixes, discoveries, preferences, or session closure.

What this skill tells your AI

The instructions your AI receives, as published by gentleman-programming/engram in skills/memory-protocol/SKILL.md and read by Ahel’s review.

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.

Delivery Guarantee

Memory operations are internal bookkeeping, never the user-facing answer. Complete required memory work before composing the completed-task reply; send the complete answer as the final message of the turn with no later tool calls. If memory work fails or needs follow-up, still send the answer.

Signals

GitHub stars
7k
Forks
733
Last commit
Oct 2026
Advanced
Item type
skill
Key
engram-memory-protocol
Source
github.com/gentleman-programming/engram