Fix: Strip internal metadata header when syncing prompts

Adds _strip_metadata_header to BasePromptHandler to remove internal metadata (Prompt, ID, Status, etc.) before syncing prompt content to tool-specific files. This ensures that the synced files only contain the actual prompt content and not the manager's internal tracking data. Also includes a new test suite verifying this behavior.

Author: zhujian0805

code_assistant_manager/prompts/base.py

@@ -89,6 +89,59 @@ def get_prompt_file_path(
             return project_dir / filename
         return None
 
+    def _strip_metadata_header(self, content: str) -> str:
+        """
+        Strip internal metadata header if present.
+
+        The metadata header typically looks like:
+        Prompt: ...
+        Description: ...
+        Status: ...
+        ID: ...
+
+        Content:
+
+        Args:
+            content: The prompt content
+
+        Returns:
+            Content with metadata header removed
+        """
+        lines = content.splitlines()
+
+        # Find the "Content:" line
+        content_line_idx = -1
+        for i, line in enumerate(lines[:30]):  # Check first 30 lines
+            if line.strip() == "Content:":
+                content_line_idx = i
+                break
+
+        if content_line_idx != -1:
+            # Check if preceding lines look like metadata
+            # At least one line should start with known metadata keys
+            header_slice = lines[:content_line_idx]
+            has_metadata = False
+            for line in header_slice:
+                if line.startswith(
+                    ("Prompt:", "ID:", "Description:", "Status:", "Imported from")
+                ):
+                    has_metadata = True
+                    break
+
+            if has_metadata:
+                # Return content starting after "Content:" line
+                # Skip "Content:" line
+                start_idx = content_line_idx + 1
+
+                # Skip subsequent empty lines
+                while start_idx < len(lines) and not lines[start_idx].strip():
+                    start_idx += 1
+
+                if start_idx < len(lines):
+                    return "\n".join(lines[start_idx:])
+
+        return content
+
     def _normalize_header(self, content: str) -> str:
         """
         Normalize the first line header to match this tool's name.
@@ -154,6 +207,9 @@ def sync_prompt(
                 f"Tool '{self.tool_name}' does not support level '{level}'"
             )
 
+        # Strip metadata header if present
+        content = self._strip_metadata_header(content)
+
         # Normalize header to match this tool's name
         content = self._normalize_header(content)
 

tests/test_prompt_header_stripping.py

@@ -0,0 +1,80 @@
+from pathlib import Path
+
+import pytest
+
+from code_assistant_manager.prompts.claude import ClaudePromptHandler
+from code_assistant_manager.prompts.gemini import GeminiPromptHandler
+
+
+class TestPromptHeaderStripping:
+
+    @pytest.fixture
+    def temp_dir(self, tmp_path):
+        return tmp_path
+
+    def test_strip_metadata_header(self, temp_dir):
+        handler = GeminiPromptHandler(user_path_override=temp_dir / "GEMINI.md")
+
+        content_with_header = """Prompt: Imported from User Gemini (2025-11-27 00:04)
+Description: Imported from /home/jzhu/.gemini/GEMINI.md
+Status: not default
+ID: gemini-user-f50022f5
+
+Content:
+
+# Gemini Code Assistant Instructions
+
+## Role
+You are an expert.
+"""
+
+        # Sync the prompt
+        synced_path = handler.sync_prompt(content_with_header, level="user")
+
+        # Read the file
+        synced_content = synced_path.read_text()
+
+        # Verify header is gone
+        assert "Prompt: Imported from User" not in synced_content
+        assert "Status: not default" not in synced_content
+        assert "Content:" not in synced_content
+
+        # Verify content starts with the markdown header
+        assert synced_content.startswith("# Gemini Code Assistant Instructions")
+        assert "## Role" in synced_content
+
+    def test_normalize_header_after_stripping(self, temp_dir):
+        # Use Claude handler to verify header renaming
+        handler = ClaudePromptHandler(user_path_override=temp_dir / "CLAUDE.md")
+
+        content_with_header = """Prompt: Some Prompt
+ID: 123
+
+Content:
+
+# Gemini Code Assistant Instructions
+
+Some content.
+"""
+
+        synced_path = handler.sync_prompt(content_with_header, level="user")
+        synced_content = synced_path.read_text()
+
+        # Verify header is stripped
+        assert "Prompt: Some Prompt" not in synced_content
+
+        # Verify header is renamed to Claude
+        assert synced_content.startswith("# Claude Code Assistant Instructions")
+
+    def test_no_header_strip_if_no_content_delimiter(self, temp_dir):
+        handler = GeminiPromptHandler(user_path_override=temp_dir / "GEMINI.md")
+
+        content_simple = """# Just a normal prompt
+
+With some content.
+"""
+
+        synced_path = handler.sync_prompt(content_simple, level="user")
+        synced_content = synced_path.read_text()
+
+        assert synced_content == content_simple