User General Facts
Learn and recall general facts about the user — preferences, background, goals, and other persistent information that helps personalize interactions.
File Structure
Organize facts into topic-specific files named [TOPIC].md. Create a new file when a new category of facts is discovered; update the existing file when new facts are found for that topic.
File Format: [TOPIC].md
# [Topic Name] - [third-person fact about the user, e.g. "The user prefers TypeScript"] - [third-person fact about the user, e.g. "The user's name is Gus"]
Example Topics
coding-preferences.md— preferred languages, frameworks, code style conventionstech-stack.md— tools, services, and infrastructure the user works withcommunication-style.md— how the user prefers to interact (concise vs. detailed, etc.)work-context.md— role, team, projects, company detailsgoals.md— current objectives, priorities, long-term goals
Guidelines
- One topic per file — do not mix unrelated facts in the same file
- Use lowercase kebab-case for file names (e.g.,
coding-preferences.md) - Choose clear, broad topic names
- Update existing facts when corrections are provided — do not keep stale information
- Keep facts concise, objective, and actionable
- Only record facts explicitly stated or clearly demonstrated by the user — do not speculate
- Always use third-person pronouns when referring to the user. Write "The user prefers X" or "The user's name is Y", never "I prefer X" or "My name is Y". These files are read by agents who would mistake first-person "I" as referring to themselves.
