Skip to content

Az SDK Tools MCP: Guidelines for CLI command grouping#12071

Merged
praveenkuttappan merged 9 commits into
Azure:mainfrom
praveenkuttappan:azsdk_mcp_cli_grouping
Oct 13, 2025
Merged

Az SDK Tools MCP: Guidelines for CLI command grouping#12071
praveenkuttappan merged 9 commits into
Azure:mainfrom
praveenkuttappan:azsdk_mcp_cli_grouping

Conversation

@praveenkuttappan
Copy link
Copy Markdown
Member

Initial draft for CLI command grouping and guidelines for any new CLI.

@praveenkuttappan praveenkuttappan self-assigned this Sep 15, 2025
Copilot AI review requested due to automatic review settings September 15, 2025 16:01
@praveenkuttappan praveenkuttappan added the AzSDK Tools Agent Issue related to the AzSDK Tools Agent. label Sep 15, 2025
@praveenkuttappan praveenkuttappan review requested due to automatic review settings September 15, 2025 16:01
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
@benbp benbp added the azsdk-cli Issues related to Azure/azure-sdk-tools::tools/azsdk-cli label Sep 15, 2025
Copilot AI review requested due to automatic review settings September 16, 2025 00:16
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR introduces comprehensive CLI command guidelines for the Azure SDK Tools project, establishing a standardized command hierarchy and implementation patterns for both CLI and MCP (Model Context Protocol) server functionality.

  • Adds structured guidelines for organizing CLI commands into six main categories (engsys, package, github, release-plan, typespec, tspclient)
  • Provides detailed implementation requirements, coding patterns, and examples for creating new CLI tools
  • Establishes namespace organization and command structure conventions

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File Description
tools/azsdk-cli/docs/new-tool.md Adds reference to CLI command hierarchy guidelines in the table of contents
tools/azsdk-cli/docs/cli-commands-guidelines.md New comprehensive documentation defining command hierarchy, implementation patterns, and coding examples

Comment thread tools/azsdk-cli/docs/new-tool.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Co-authored-by: Mariana Rios Flores <mariari@microsoft.com>
@praveenkuttappan praveenkuttappan requested a review from a team as a code owner September 24, 2025 15:42
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/new-tool.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Co-authored-by: Mariana Rios Flores <mariari@microsoft.com>
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md Outdated
Comment thread tools/azsdk-cli/docs/cli-commands-guidelines.md
@praveenkuttappan praveenkuttappan merged commit ae54486 into Azure:main Oct 13, 2025
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

AzSDK Tools Agent Issue related to the AzSDK Tools Agent. azsdk-cli Issues related to Azure/azure-sdk-tools::tools/azsdk-cli

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants