Skip to content

refactor(@angular/cli): optimize MCP tool descriptions for LLM ergonomics and token usage#33211

Open
clydin wants to merge 1 commit into
angular:mainfrom
clydin:refactor/mcp-tool-descriptions
Open

refactor(@angular/cli): optimize MCP tool descriptions for LLM ergonomics and token usage#33211
clydin wants to merge 1 commit into
angular:mainfrom
clydin:refactor/mcp-tool-descriptions

Conversation

@clydin
Copy link
Copy Markdown
Member

@clydin clydin commented May 18, 2026

Refactor the descriptions of get_best_practices, search_documentation, and onpush_zoneless_migration tools to improve semantic clarity and reduce system prompt token footprints. Remove redundant operational boilerplate, eliminate internal server logic leakage related to version clamping, and consolidate overlapping iterative process instructions.

@clydin clydin added the target: rc This PR is targeted for the next release-candidate label May 18, 2026
Copy link
Copy Markdown

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

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 refactors and condenses the tool descriptions for the Best Practices, Documentation Search, and Zoneless Migration tools within the Angular CLI MCP implementation. The updates simplify the purpose, use cases, and operational notes for each tool to be more concise. Review feedback identifies several instances where a comma was used immediately after the abbreviation 'e.g.' in user-facing messages, recommending their removal to align with general stylistic conventions.

Comment thread packages/angular/cli/src/commands/mcp/tools/doc-search.ts
Comment thread packages/angular/cli/src/commands/mcp/tools/doc-search.ts
Comment thread packages/angular/cli/src/commands/mcp/tools/doc-search.ts
@clydin clydin force-pushed the refactor/mcp-tool-descriptions branch 3 times, most recently from 9639a79 to b8eee8f Compare May 18, 2026 15:49
…mics and token usage

Refactor the descriptions of get_best_practices, search_documentation, and onpush_zoneless_migration tools to improve semantic clarity and reduce system prompt token footprints. Remove redundant operational boilerplate, eliminate internal server logic leakage related to version clamping, and consolidate overlapping iterative process instructions.
@clydin clydin force-pushed the refactor/mcp-tool-descriptions branch from b8eee8f to 2ceb4b8 Compare May 18, 2026 15:58
@clydin clydin added the action: review The PR is still awaiting reviews from at least one requested reviewer label May 18, 2026
@clydin clydin requested a review from alan-agius4 May 18, 2026 16:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

action: review The PR is still awaiting reviews from at least one requested reviewer area: @angular/cli target: rc This PR is targeted for the next release-candidate

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant