fix(@schematics/angular): generate CLAUDE.md for Claude Code instead of AGENTS.md

Fixes #33817

Claude Code explicitly looks for a `CLAUDE.md` file in the project directory at the start of every session. In a previous update, this was unintentionally changed to generate `AGENTS.md`, which is a different community standard. This commit restores the generation of `CLAUDE.md` for Claude Code.

Author: lacolaco

packages/schematics/angular/ai-config/index.ts

@@ -19,7 +19,11 @@ const AGENTS_MD_CFG: ContextFileInfo = {
 
 const AI_TOOLS: { [key in Exclude<Tool, Tool.None>]: ContextFileInfo[] } = {
   ['claude-code']: [
-    AGENTS_MD_CFG,
+    {
+      type: ContextFileType.BestPracticesMd,
+      name: 'CLAUDE.md',
+      directory: '.',
+    },
     {
       type: ContextFileType.McpConfig,
       name: '.mcp.json',

packages/schematics/angular/ai-config/index_spec.ts

@@ -32,9 +32,9 @@ describe('AI Config Schematic', () => {
     workspaceTree = await schematicRunner.runSchematic('workspace', workspaceOptions);
   });
 
-  it('should create Angular MCP server config and AGENTS.md for Claude Code', async () => {
+  it('should create Angular MCP server config and CLAUDE.md for Claude Code', async () => {
     const tree = await runAiConfigSchematic([ConfigTool.ClaudeCode]);
-    expect(tree.exists('AGENTS.md')).toBeTruthy();
+    expect(tree.exists('CLAUDE.md')).toBeTruthy();
     expect(tree.exists('.mcp.json')).toBeTruthy();
   });
 
@@ -89,17 +89,17 @@ describe('AI Config Schematic', () => {
 
   it('should omit best practices creation, if the file already exists', async () => {
     const customContent = 'custom user content';
-    workspaceTree.create('AGENTS.md', customContent);
+    workspaceTree.create('CLAUDE.md', customContent);
 
     const messages: string[] = [];
     const loggerSubscription = schematicRunner.logger.subscribe((x) => messages.push(x.message));
 
     try {
       const tree = await runAiConfigSchematic([ConfigTool.ClaudeCode]);
 
-      expect(tree.readContent('AGENTS.md')).toBe(customContent);
+      expect(tree.readContent('CLAUDE.md')).toBe(customContent);
       expect(messages).toContain(
-        `Skipping configuration file for 'ClaudeCode' at './AGENTS.md' because it already exists.\n` +
+        `Skipping configuration file for 'ClaudeCode' at './CLAUDE.md' because it already exists.\n` +
           'This is to prevent overwriting a potentially customized file. ' +
           'If you want to regenerate it with Angular recommended defaults, please delete the existing file and re-run the command.\n' +
           'You can review the latest recommendations at https://angular.dev/ai/develop-with-ai.\n',

packages/schematics/angular/ai-config/schema.json

@@ -4,7 +4,7 @@
   "title": "Angular AI Config File Options Schema",
   "type": "object",
   "additionalProperties": false,
-  "description": "Generates AI configuration files for Angular projects. This schematic creates AGENTS.md file and Angular MCP server configuration, improving the quality of AI-generated code and suggestions.",
+  "description": "Generates AI configuration files for Angular projects. This schematic creates instruction files (e.g. AGENTS.md, CLAUDE.md) and Angular MCP server configuration, improving the quality of AI-generated code and suggestions.",
   "properties": {
     "tool": {
       "type": "array",
@@ -20,7 +20,7 @@
           },
           {
             "value": "claude-code",
-            "label": "Claude Code   [ `AGENTS.md` + Angular MCP server config ]"
+            "label": "Claude Code   [ `CLAUDE.md` + Angular MCP server config ]"
           },
           {
             "value": "cursor",
@@ -40,7 +40,7 @@
           }
         ]
       },
-      "description": "Specifies which AI tools to generate configuration files (AGENTS.md, MCP server config) for.",
+      "description": "Specifies which AI tools to generate configuration files (AGENTS.md, CLAUDE.md, MCP server config) for.",
       "items": {
         "type": "string",
         "enum": ["none", "claude-code", "cursor", "gemini-cli", "open-ai-codex", "vscode"]

packages/schematics/angular/ng-new/index_spec.ts

@@ -109,7 +109,7 @@ describe('Ng New Schematic', () => {
 
     const tree = await schematicRunner.runSchematic('ng-new', options);
     const files = tree.files;
-    expect(files).toContain('/bar/AGENTS.md');
+    expect(files).toContain('/bar/CLAUDE.md');
     expect(files).toContain('/bar/.mcp.json');
     expect(files).toContain('/bar/.gemini/GEMINI.md');
     expect(files).toContain('/bar/.gemini/settings.json');