Skip to content

Conversation

clydin
Copy link
Member

@clydin clydin commented Sep 2, 2025

This commit refactors the top-level instructions for the MCP server to provide clearer, more structured, and actionable guidance for an AI assistant.

Following the best practices for LLM-centric documentation, the new instructions:

  • Use a structured tag-based format (<General Purpose>, <Core Workflows>, etc.) to improve parsability.
  • Establish a mandatory "first step" workflow, instructing the AI to always use the list_projects tool to gather context before taking other actions.
  • Provide a high-level guide to the available tools, mapping them to common user intents (e.g., answering questions, writing code).
  • Define key domain concepts like "Workspace" vs. "Project" to improve the AI's operational model in a monorepo.

This change helps the AI behave more reliably and effectively by providing a strategic framework for how to use the server's tools as a cohesive system.

…ctions

This commit refactors the top-level `instructions` for the MCP server to provide clearer, more structured, and actionable guidance for an AI assistant.

Following the best practices for LLM-centric documentation, the new instructions:
- Use a structured tag-based format (`<General Purpose>`, `<Core Workflows>`, etc.) to improve parsability.
- Establish a mandatory "first step" workflow, instructing the AI to always use the `list_projects` tool to gather context before taking other actions.
- Provide a high-level guide to the available tools, mapping them to common user intents (e.g., answering questions, writing code).
- Define key domain concepts like "Workspace" vs. "Project" to improve the AI's operational model in a monorepo.

This change helps the AI behave more reliably and effectively by providing a strategic framework for how to use the server's tools as a cohesive system.
@clydin clydin added the target: major This PR is targeted for the next major release label Sep 2, 2025
@clydin clydin added the action: review The PR is still awaiting reviews from at least one requested reviewer label Sep 2, 2025
@clydin clydin requested a review from alan-agius4 September 3, 2025 12:51
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: major This PR is targeted for the next major release
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant