feat: Normalize header when syncing prompt to different app

When syncing a prompt to a different app than its original, the first
line header (e.g., '# Gemini Code Assistant Instructions') is now
automatically updated to match the target app (e.g., '# Claude Code
Assistant Instructions').

This ensures the synced file content is consistent with its target app.

Author: jzhu

code_assistant_manager/cli/prompts_commands.py

@@ -20,6 +20,7 @@
     PROMPT_FILE_PATHS,
     Prompt,
     PromptManager,
+    get_handler,
     get_prompt_file_path,
 )
 
@@ -330,8 +331,9 @@ def sync_prompts(
                 )
             else:
                 # Just sync the file without changing enabled state
-                file_path.parent.mkdir(parents=True, exist_ok=True)
-                file_path.write_text(prompt.content, encoding="utf-8")
+                # Use the handler's sync_prompt method to ensure proper normalization
+                handler = get_handler(target_app)
+                handler.sync_prompt(prompt.content, level, level_project_dir)
                 typer.echo(
                     f"{Colors.GREEN}✓ Synced '{prompt_id}' to {target_app} ({level}){Colors.RESET}"
                 )

code_assistant_manager/prompts/base.py

@@ -89,6 +89,45 @@ def get_prompt_file_path(
             return project_dir / filename
         return None
 
+    def _normalize_header(self, content: str) -> str:
+        """
+        Normalize the first line header to match this tool's name.
+
+        If the content starts with a markdown header like '# Gemini Code Assistant',
+        it will be updated to match this tool (e.g., '# Claude Code Assistant').
+
+        Args:
+            content: The prompt content
+
+        Returns:
+            Content with normalized header
+        """
+        import re
+
+        lines = content.split("\n", 1)
+        if not lines:
+            return content
+
+        first_line = lines[0]
+        # Match markdown headers like "# Gemini Code Assistant Instructions"
+        # or "# Claude Code Assistant" etc.
+        header_pattern = r"^#\s+(Claude|Codex|Gemini|Copilot|GitHub Copilot)(\s+.*)?"
+        match = re.match(header_pattern, first_line, re.IGNORECASE)
+
+        if match:
+            # Get the tool name with proper capitalization
+            tool_display_name = self.tool_name.capitalize()
+            if self.tool_name == "copilot":
+                tool_display_name = "GitHub Copilot"
+
+            suffix = match.group(2) or ""
+            new_header = f"# {tool_display_name}{suffix}"
+            if len(lines) > 1:
+                return new_header + "\n" + lines[1]
+            return new_header
+
+        return content
+
     def sync_prompt(
         self,
         content: str,
@@ -115,6 +154,9 @@ def sync_prompt(
                 f"Tool '{self.tool_name}' does not support level '{level}'"
             )
 
+        # Normalize header to match this tool's name
+        content = self._normalize_header(content)
+
         # Ensure parent directory exists
         file_path.parent.mkdir(parents=True, exist_ok=True)