memory-init

Memory Init

Initialize the Engram memory system for the current project.

When to Use

Trigger this skill when:

• The user explicitly asks to set up, initialize, or configure Engram / persistent memory
• A memory-related skill (memory-remember, memory-recall, memory-status) is requested but .claude/memory-settings.json does not exist
• The user re-runs init to upgrade an existing configuration (e.g. to change preset, language, or search_mode)

Workflow

1. Ask Preset Choice

Ask the user which preset they want:

• personal-assistant — Daily life, preferences, habits, personal interactions
• project-assistant — Codebase, architecture, tech decisions, team workflow
• character-companion — Persona, relationship, story progression, emotional bonds
• pair-programmer — AI self-learning, mistake tracking, user preference rules, collaboration patterns

Or offer custom configuration.

2. Ask File Name Customization

Show the default file names and ask if the user wants to change them:

memory_preferences.md    (User/Project/Character preferences)
memory_conversations.md  (Conversation history)
memory_longterm.md       (Long-term memories)

3. Ask Language Preference

• en — English CLAUDE.md section (default)
• zh — Chinese CLAUDE.md section

3.5 Ask Search Mode

• strong — 回覆前預設先用 memory-recall 檢查一次記憶 / Check memories before responding by default
• weak — 判斷話題可能涉及過去時才搜尋 / Search only when a topic may involve past context (default)

4. Create Configuration

Create .claude/memory-settings.json with the chosen settings:

{
  "preset": "<chosen-preset>",
  "files": {
    "preferences": "<preferences-filename>",
    "conversations": "<conversations-filename>",
    "longterm": "<longterm-filename>"
  },
  "language": "<en|zh>",
  "search_mode": "<strong|weak>"
}

5. Copy Preset Templates

Copy the template files from the plugin's templates/presets/<preset>/ directory to the project root. The plugin root is available via ${CLAUDE_PLUGIN_ROOT} or can be found by locating the engram plugin directory.