Platform Adapters

MemoryCustodian separates the memory protocol from platform-specific entry points.

MemoryCustodian Core Protocol
  -> Generic Skill Instructions
  -> Platform Adapter
  -> Codex / Claude Code / Cursor / Gemini / Others

Codex#

Codex projects should keep AGENTS.md short and point to docs/memory/.

Recommended behavior:

Read docs/memory/manifest.md before substantial work.
Read docs/memory/brief.md.
Read task-specific files only when the manifest says they are relevant.
Do not load inbox.md or archive/ unless asked or maintaining memory.
After meaningful decisions, repeated corrections, or rejected approaches, update the appropriate memory file or propose an update.

Use adapters/codex/AGENTS.snippet.md.

Claude Code#

Claude Code projects should keep CLAUDE.md short and point to docs/memory/.

Recommended behavior:

Read manifest.md and brief.md before substantial work.
Load other files only when the manifest says they are relevant.
Keep memory usage minimal.
Use commands for status, compact, and forget where available.

Use adapters/claude-code/CLAUDE.snippet.md and optional command files under adapters/claude-code/commands/.

Gemini#

Gemini-style agents should keep GEMINI.md short and point to docs/memory/.

Recommended behavior:

Read manifest.md and brief.md before substantial work.
Load other files only when the manifest says they are relevant.
Do not import docs/memory/ files from GEMINI.md; Gemini context imports are loaded into prompt context.
Install or link skills/memory-custodian/ as a Gemini Agent Skill when available.

Use adapters/gemini/GEMINI.snippet.md.

Generic Agents#

Generic agents should follow docs/memory/manifest.md when the memory directory exists. If no memory directory exists, continue normally. If the directory exists but manifest.md is missing, report an incomplete or corrupted setup and do not infer routes from the remaining files.

Use adapters/generic/agent-instructions.md.

Adapter Rule#

Adapters should be entry points, not memory stores. Do not copy full project memory into AGENTS.md, CLAUDE.md, GEMINI.md, or equivalent instruction files.