claude-mem/docs/public/CLAUDE.md

Claude-Mem Public Documentation

What This Folder Is

This docs/public/ folder contains the Mintlify documentation site - the official user-facing documentation for claude-mem. It's a structured documentation platform with a specific file format and organization.

Folder Structure

docs/
├── public/          ← You are here (Mintlify MDX files)
│   ├── *.mdx       - User-facing documentation pages
│   ├── docs.json   - Mintlify configuration and navigation
│   ├── architecture/ - Technical architecture docs
│   ├── usage/      - User guides and workflows
│   └── *.webp, *.gif - Assets (logos, screenshots)
└── context/        ← Internal documentation (DO NOT put here)
    └── *.md        - Planning docs, audits, references

File Requirements

Mintlify Documentation Files (.mdx)

All official documentation files must be:

• Written in .mdx format (Markdown with JSX support)
• Listed in docs.json navigation structure
• Follow Mintlify's schema and conventions

The documentation is organized into these sections:

• Get Started: Introduction, installation, usage guides
• Best Practices: Context engineering, progressive disclosure
• Configuration & Development: Settings, dev workflow, troubleshooting
• Architecture: System design, components, technical details

Configuration File

docs.json defines:

• Site metadata (name, description, theme)
• Navigation structure
• Branding (logos, colors)
• Footer links and social media

What Does NOT Belong Here

Planning documents, design docs, and reference materials go in /docs/context/ instead:

Files that belong in /docs/context/ (NOT here):

• Planning documents (*-plan.md, *-outline.md)
• Implementation analysis (*-audit.md, *-code-reference.md)
• Error tracking (typescript-errors.md)
• Internal design documents
• PR review responses
• Reference materials (like agent-sdk-ref.md)
• Work-in-progress documentation

How to Add Official Documentation

1. Create a new .mdx file in the appropriate subdirectory
2. Add the file path to docs.json navigation
3. Use Mintlify's frontmatter and components
4. Follow the existing documentation style
5. Test locally: npx mintlify dev

Development Workflow

For contributors working on claude-mem:

• Read /CLAUDE.md in the project root for development instructions
• Place planning/design docs in /docs/context/
• Only add user-facing documentation to /docs/public/
• Test documentation locally with Mintlify CLI before committing

Testing Documentation

# Validate docs structure
npx mintlify validate

# Check for broken links
npx mintlify broken-links

# Run local dev server
npx mintlify dev

Summary

Simple Rule:

• /docs/public/ = Official user documentation (Mintlify .mdx files) ← YOU ARE HERE
• /docs/context/ = Internal docs, plans, references, audits

# Recent Activity

Nov 18, 2025

ID	Time	T	Title	Read
#11206	3:01 PM	🔵	mem-search skill architecture and migration details retrieved in full format	~538

Nov 21, 2025

ID	Time	T	Title	Read
#13221	2:01 AM	🔴	Fixed broken markdown link to Viewer UI documentation	~316
#13220	2:00 AM	🔴	Escaped HTML less-than symbol in universal architecture timeout documentation	~316
#13216	1:54 AM	✅	Universal Architecture Added to Navigation	~330
#13215	"	🟣	Universal AI Memory Architecture Documentation Created	~732
#13213	1:50 AM	🔵	Introduction Page Content and Recent v6.0.0 Release	~495
#13212	"	🔵	Architecture Evolution Documentation Structure	~408
#13211	"	🔵	Mintlify Documentation Site Configuration	~430
#13209	1:48 AM	🔵	Public Documentation Structure and Guidelines	~383

Nov 25, 2025

ID	Time	T	Title	Read
#14994	2:22 PM	✅	Version Channel Section Added to Configuration Documentation	~301
#14993	"	✅	Beta Features Added to Documentation Navigation	~188
#14992	2:21 PM	🟣	Beta Features Documentation Page Created	~488
#14991	"	🔵	Mintlify Navigation Structure and Documentation Groups	~394
#14989	"	🔵	Installation Documentation with Quick Start and Verification Steps	~383
#14988	"	🔵	Configuration Documentation Structure and Environment Variables	~338

Nov 26, 2025

ID	Time	T	Title	Read
#16190	10:22 PM	🔵	RAGTIME Search Retrieved Five Observations About Claude-Mem vs RAG Architecture	~637

Dec 3, 2025

ID	Time	T	Title	Read
#19884	9:42 PM	🔵	Configuration system and environment variables	~701
#19878	9:40 PM	🔵	Installation process and system architecture	~486

Dec 8, 2025

ID	Time	T	Title	Read
#22335	10:26 PM	🔵	Mintlify documentation configuration analyzed	~534
#22311	9:47 PM	🔵	Comprehensive Hooks Architecture Documentation Review	~263
#22297	9:43 PM	🔵	Mintlify Documentation Framework Configuration	~446
#22294	"	🔵	Documentation Site Structure Located	~359

Dec 9, 2025

ID	Time	T	Title	Read
#23179	10:44 PM	✅	Removed explanatory reasons from tool exclusion documentation	~297

Dec 15, 2025

ID	Time	T	Title	Read
#27038	6:02 PM	🔵	95% token reduction claims found only in private experimental documents, not in main public docs	~513
#27037	"	🔵	Branch switching functionality exists in SettingsRoutes with UI switcher removal intent	~463
#26986	5:24 PM	✅	Updated Endless Mode latency warning in beta features documentation	~299

Dec 29, 2025

ID	Time	T	Title	Read
#33938	6:27 PM	🔵	Relevant CLAUDE.md Context Identified for PR #492	~435
#33750	12:25 AM	✅	Documentation Update: Removed Version Number from Architecture Evolution	~281

Jan 7, 2026

ID	Time	T	Title	Read
#38233	7:42 PM	✅	Renumbered SessionEnd Hook from 6 to 5	~315
#38229	7:41 PM	✅	Renumbered PostToolUse Hook from 4 to 3	~278
#38225	"	✅	Updated Hook Count Description in Hooks Architecture Documentation	~352