From 25b8a8a8e51e643eb91fe2704e561f31b55ca881 Mon Sep 17 00:00:00 2001
From: Masaki Yatsu <yatsu@yatsu.info>
Date: Thu, 18 Sep 2025 23:29:28 +0900
Subject: [PATCH] chore: update CLAUDE.md

---
 CLAUDE.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 308a2b2..a0e2775 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -180,6 +180,23 @@ When adding new services:
 4. Create Keycloak client if authentication required
 5. Import module in main justfile
 
+### Helm Chart Installation Guidelines
+
+1. **Helm Values Modification**:
+   - ALWAYS check official documentation and values.yaml definitions before modifying Helm values
+   - Understand the chart's structure and available configuration options
+   - Test changes in a safe environment when possible
+
+2. **Resource Creation Consistency**:
+   - When creating Secret/ExternalSecret/ConfigMap resources, follow patterns from existing modules
+   - Maintain consistent naming conventions and label structures
+   - Use the same YAML formatting and organization as other modules
+
+3. **Core Component Protection**:
+   - Keycloak, PostgreSQL, and Vault are core components
+   - NEVER restart or reinstall these components without explicit user approval
+   - These services are critical to the entire stack's operation
+
 ## Code Style
 
 - Indent lines with 4 spaces