TrulyMEM-TrueHumanMEM/docs/en/prompts.md

Prompt Manager Documentation

This document describes the prompt management module.

Overview

The prompt management module (core/prompts/) is responsible for loading and managing system prompts that tell the AI how to use memory tools.

Core Components

Component	Description
PromptManager	Prompt manager, singleton pattern
system_prompt.md	Main system prompt template

Usage

from core.prompts import PromptManager

# Get singleton instance
prompt_manager = PromptManager()

# Get system prompt
system_prompt = prompt_manager.get_system_prompt()

System Prompt Content

The system prompt contains:

1. Core Identity

• Name: TrulyMEM (TrueHumanMEM)
• Capability: Long-term memory based on graph database
• Philosophy: Make AI's memory more human-like

2. Core Capabilities

1. Long-term Memory - Graph database stores entity relationships
2. Persona Management - Role-playing and character settings
3. Task Tracking - Working memory chain

3. Memory Principles

• Must write: User-explicit preferences, shared information, plans
• Must not write: AI-inferred content (unless marked [speculation])
• Annotation: Inferred content must be marked [speculation]

4. Mandatory Execution Flow (Per Turn)

Step 1: Query persona graph (highest priority)
Step 2: Query working memory chain
Step 3: Process conversation
Step 4: memory_commit (write key info) → Persist user-explicit important information to the graph database
Step 5: Update working memory chain

5. Tool System

Memory Tools

Tool	Function
memory_recall	Retrieve memory
memory_commit	Write memory
memory_purge	Delete memory
memory_introspect	View status
memory_archive	Archive memory
memory_cleanup	Clean data
context_rewrite	Compress single-turn tool call context

Persona Tools

Tool	Function
persona_update	Update persona
persona_clear	Clear persona

Task Tools

Tool	Function
task_create	Create task
task_set_state	Set state
task_delete	Delete task
task_link_info	Link information

6. Autonomy Principles

The AI can autonomously decide:

• Whether to query other memories
• Whether to write other memories
• How to use tools (outside mandatory requirements)

7. Conversation Style

• Natural and smooth
• Avoid mechanical tool calls
• Prioritize understanding user intent
• Use memory to enhance experience when appropriate

File Structure

core/prompts/
├── __init__.py           # Export PromptManager
├── prompt_manager.py      # PromptManager class
└── templates/
    └── system_prompt.md # Main system prompt

Customization

Customizing System Prompt

Modify core/prompts/templates/system_prompt.md to customize the AI's behavior.

Adding Custom Prompts

1. Add prompt template file to core/prompts/templates/
2. Modify PromptManager to support multiple prompts
3. Use set_prompt() to switch prompts

Caching

• System prompts are cached in memory after first load
• get_system_prompt() returns cached content
• Cache is per-process, not persisted