Context
After #240, agentsMd is mounted at all preset discovery filenames (AGENTS.md, CLAUDE.md, GEMINI.md, etc.) via ConfigMap volumeMount. agentsMd defaults to "" — when empty, nothing is mounted and PVC files work as-is.
Problem
When a user explicitly sets agentsMd in their Helm values, the ConfigMap volumeMount shadows any existing file at the same path on the PVC. The PVC file is not deleted, but becomes invisible to the agent. No warning is emitted.
┌─ agentsMd = "" (default) ────────────────────────────────────────┐
│ │
│ PVC (/home/agent) │
│ ┌──────────────────────────┐ │
│ │ CLAUDE.md (user-edited) │ ◄── agent reads this ✅ │
│ └──────────────────────────┘ │
│ │
│ No ConfigMap mount. PVC files work as-is. │
└───────────────────────────────────────────────────────────────────┘
┌─ agentsMd = "custom content" (user sets this) ───────────────────┐
│ │
│ ConfigMap volumeMount │
│ ┌──────────────────────────┐ │
│ │ CLAUDE.md (from Helm) │ ◄── agent reads this ✅ │
│ └──────────────────────────┘ │
│ │ shadows │
│ ▼ │
│ PVC (/home/agent) │
│ ┌──────────────────────────┐ │
│ │ CLAUDE.md (user-edited) │ ◄── still on disk but INVISIBLE ❌ │
│ └──────────────────────────┘ │
│ │
│ Removing agentsMd restores the PVC file. │
└───────────────────────────────────────────────────────────────────┘
This is standard Kubernetes volumeMount behavior and only happens when the user explicitly opts in by setting agentsMd. Just needs a heads-up in the docs.
Fix
Ref: #240
Context
After #240,
agentsMdis mounted at all preset discovery filenames (AGENTS.md,CLAUDE.md,GEMINI.md, etc.) via ConfigMap volumeMount.agentsMddefaults to""— when empty, nothing is mounted and PVC files work as-is.Problem
When a user explicitly sets
agentsMdin their Helm values, the ConfigMap volumeMount shadows any existing file at the same path on the PVC. The PVC file is not deleted, but becomes invisible to the agent. No warning is emitted.This is standard Kubernetes volumeMount behavior and only happens when the user explicitly opts in by setting
agentsMd. Just needs a heads-up in the docs.Fix
values.yamlnext toagentsMd:# Note: when set, overrides any existing file at the same path on the PVCagentsMdtakes precedence over PVC filesRef: #240