Skip to content

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

Open
lacolaco wants to merge 1 commit into
angular:mainfrom
lacolaco:fix/claude-code-agents-md
Open

fix(@schematics/angular): generate CLAUDE.md for Claude Code instead of AGENTS.md#33818
lacolaco wants to merge 1 commit into
angular:mainfrom
lacolaco:fix/claude-code-agents-md

Conversation

@lacolaco

@lacolaco lacolaco commented Aug 8, 2026

Copy link
Copy Markdown
Contributor

PR Checklist

Please check to confirm your PR fulfills the following requirements:

PR Type

What kind of change does this PR introduce?

  • Bugfix
  • Feature
  • Code style update (formatting, local variables)
  • Refactoring (no functional changes, no api changes)
  • Build related changes
  • CI related changes
  • Documentation content changes
  • Other... Please describe:

What is the current behavior?

When using ng new or ng generate ai-config and selecting Claude Code, it incorrectly generates AGENTS.md for Claude Code.

Issue Number: #33817

What is the new behavior?

Generates CLAUDE.md instead of AGENTS.md when Claude Code is selected, aligning with Anthropic's official Claude Code documentation for project instructions.

Does this PR introduce a breaking change?

  • Yes
  • No

Other information

This fixes a regression introduced in 22.1.0 where generating AI configuration for Claude Code (claude-code) incorrectly grouped it with other tools that generate AGENTS.md. According to Anthropic's official Claude Code documentation, the tool explicitly looks for a CLAUDE.md file in the project directory at the start of every session to serve as its system ruleset and permanent memory.

Additionally, this generation strategy creates a .mcp.json file. According to the official Claude Code MCP documentation:

"Project-scoped servers enable team collaboration by storing configurations in a .mcp.json file at your project’s root directory. When you add a project-scoped server, Claude Code automatically creates or updates this file with the appropriate configuration structure. Check .mcp.json into version control so everyone on your team gets the same MCP tools and services."

…of AGENTS.md

Fixes angular#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.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the Angular AI configuration schematic to generate CLAUDE.md instead of AGENTS.md for the claude-code tool. This change is reflected in the tool configuration, schema descriptions, and associated unit tests. I have no feedback to provide as there are no review comments.

@alan-agius4 alan-agius4 left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thanks for this.

For context: https://code.claude.com/docs/en/memory#agents-md

@alan-agius4 alan-agius4 linked an issue Aug 8, 2026 that may be closed by this pull request
1 task
@alan-agius4 alan-agius4 added target: patch This PR is targeted for the next patch release action: merge The PR is ready for merge by the caretaker labels Aug 8, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action: merge The PR is ready for merge by the caretaker area: @schematics/angular target: patch This PR is targeted for the next patch release

Projects

None yet

Development

Successfully merging this pull request may close these issues.

bug: Angular CLI doesn't generate CLAUDE.md for Claude Code

2 participants