Folder CLAUDE.md files should not be created when there are zero observations for a directory

[github-actions[bot]]

Originally posted as issue #1117 by @LordyPandaz
#1117

Problem

When CLAUDE_MEM_FOLDER_CLAUDEMD_ENABLED is set to true, claude-mem creates CLAUDE.md files in every directory it touches — even when there are zero observations for that directory. These files contain only:

<claude-mem-context>
# Recent Activity
<!-- This section is auto-generated by claude-mem. Edit content outside the tags. -->
*No recent activity*
</claude-mem-context>

This is different from issues requesting the ability to disable the feature entirely (#609, #767, #941). The feature itself is valuable — directory-scoped observation history helps Claude understand landmines in specific areas of the codebase. The problem is that it creates files with no useful content.

In my project, 84 CLAUDE.md files were generated, and the majority were empty. Each one gets loaded into Claude Code's context window when working in that directory, burning tokens for zero informational value. This is especially costly for subagent (explore agent) spawns, where context space is already tight.

Suggested Fix

In src/utils/claude-md-utils.ts, add a guard before writeClaudeMdToFolder(): if the observation query returns zero rows for a directory, skip file creation entirely. If an existing file has only the empty template (no observation rows), delete it.

Pseudocode:

const observations = getObservationsForFolder(folderPath, project);
if (observations.length === 0) {
  // If an empty file already exists, clean it up
  if (existsSync(claudeMdPath) && hasOnlyEmptyTemplate(claudeMdPath)) {
    unlinkSync(claudeMdPath);
  }
  return; // Don't create a new empty file
}
// Proceed with normal file generation
writeClaudeMdToFolder(folderPath, observations, ...);

This preserves the feature for directories with real activity while eliminating the empty file spam.

Related Issues

• Claude-mem creates empty CLAUDE.md files in all folders #758 — Empty CLAUDE.md files with "No recent activity"
• why does this leave CLAUDE.md files literally all over? #609 — CLAUDE.md files scattered everywhere
• Bug: CLAUDE.md files created inside .git directory causing git pull failures #734 — Files created inside .git/
• claude-mem creates CLAUDE.md files in arbitrary working directories #941 — Files in arbitrary working directories
• Feature request: Add setting to disable folder CLAUDE.md auto-generation #767 — Feature request to disable, identified root cause in writeClaudeMdToFolder()

Environment

• claude-mem: latest
• Platform: Fedora 43 (Linux)
• Claude Code: latest