From 6494adf2825b72631aa28e1e7273ccef087c642a Mon Sep 17 00:00:00 2001 From: Jaidev Singh Chadha Date: Mon, 16 Mar 2026 16:05:45 -0700 Subject: [PATCH 1/7] Add instructions for prompt file in gemini cli install guide --- content/install-guides/gemini.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/content/install-guides/gemini.md b/content/install-guides/gemini.md index 6757831b8f..c67a207bc8 100644 --- a/content/install-guides/gemini.md +++ b/content/install-guides/gemini.md @@ -407,6 +407,18 @@ Configured MCP servers: - sysreport_instructions ``` +### Use Arm prompt files with the MCP Server + +The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent understand how to use the MCP Server tools effectively for common Arm development tasks. + +#### Get the prompt files + +Browse the [agent integrations directory](https://github.com/arm/mcp/tree/main/agent-integrations/gemini) to find prompt files for specific use cases: + +- **Arm migration** ([arm-migration.toml](https://github.com/arm/mcp/blob/main/agent-integrations/gemini/arm-migration.toml)): Guides the agent through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. + +Each prompt file is a TOML configuration that you can reference in your Gemini CLI sessions to activate task-specific assistance. + If you're facing issues or have questions, reach out to mcpserver@arm.com. You're now ready to use Gemini CLI with the Arm MCP server for Arm-specific development assistance. \ No newline at end of file From 9c7067c88b7d675b8c973b8d201f96c5982a1579 Mon Sep 17 00:00:00 2001 From: Jaidev Singh Chadha Date: Tue, 17 Mar 2026 14:27:05 -0700 Subject: [PATCH 2/7] Add prompt-first guidance to Kiro, Copilot, and Codex guides --- content/install-guides/codex-cli.md | 14 +++++++++++++- content/install-guides/github-copilot.md | 16 +++++++++++++++- content/install-guides/kiro-cli.md | 16 ++++++++++++++-- 3 files changed, 42 insertions(+), 4 deletions(-) diff --git a/content/install-guides/codex-cli.md b/content/install-guides/codex-cli.md index 52eec06472..9329659ff6 100644 --- a/content/install-guides/codex-cli.md +++ b/content/install-guides/codex-cli.md @@ -233,6 +233,18 @@ The Arm MCP server is listed in the output. If the arm-mcp server indicates it's You can also verify the tools are available by asking Codex to list the available Arm MCP tools. +### Use Arm prompt files with the MCP Server + +The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent use MCP tools effectively for common Arm development tasks. + +#### Get the prompt files + +Browse the [agent integrations directory for Codex](https://github.com/arm/mcp/tree/main/agent-integrations/codex) to find prompt files for specific use cases: + +- **Arm migration** ([arm-migration.md](https://github.com/arm/mcp/blob/main/agent-integrations/codex/arm-migration.md)): Guides the agent through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. + +Each prompt file is a Markdown configuration that you can reference in your Codex CLI sessions to activate task-specific assistance. + If you're facing issues or have questions, reach out to mcpserver@arm.com. -You're now ready to use Codex CLI with Arm-specific development assistance. +You're now ready to use Codex CLI with the Arm MCP server for Arm-specific development assistance. diff --git a/content/install-guides/github-copilot.md b/content/install-guides/github-copilot.md index 299ca09f2a..24d245ec7c 100644 --- a/content/install-guides/github-copilot.md +++ b/content/install-guides/github-copilot.md @@ -335,6 +335,20 @@ Example prompts that use the Arm MCP Server: - `Search the Arm knowledge base for Neon intrinsics examples` - `Find learning resources about migrating from x86 to Arm` +## Use Arm prompt files with the MCP Server + +The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent use MCP tools effectively for common Arm development tasks. + +### Get the prompt files + +Browse the [agent integrations directory for Visual Studio Code](https://github.com/arm/mcp/tree/main/agent-integrations/vs-code) to find prompt files for specific use cases: + +- **Arm migration** ([arm-migration.prompt.md](https://github.com/arm/mcp/blob/main/agent-integrations/vs-code/arm-migration.prompt.md)): Guides GitHub Copilot Agent mode through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. + +Each prompt file is a Markdown configuration that you can reference in your GitHub Copilot sessions to activate task-specific assistance. + +If you're facing issues or have questions, reach out to mcpserver@arm.com. + ## Troubleshooting MCP Server connections This section helps you resolve common issues when installing and using GitHub Copilot with the Arm MCP Server on Arm systems. If you encounter problems not covered here, contact [mcpserver@arm.com](mailto:mcpserver@arm.com) for support. @@ -349,4 +363,4 @@ If the Arm MCP Server doesn't connect: -You're now ready to use GitHub Copilot with the Arm MCP Server to enhance your Arm development workflow! +You're now ready to use GitHub Copilot with the Arm MCP server for Arm-specific development assistance. diff --git a/content/install-guides/kiro-cli.md b/content/install-guides/kiro-cli.md index 99d8b1a7ba..fbc3816ab6 100644 --- a/content/install-guides/kiro-cli.md +++ b/content/install-guides/kiro-cli.md @@ -262,6 +262,18 @@ Use the `/tools` command to list the available tools: You should see the Arm MCP server tools listed in the output. If the arm-mcp server says it's still loading, wait a moment and run `/tools` again. -If you are facing issues or have questions, reach out to mcpserver@arm.com. +### Use Arm prompt files with the MCP Server -You're ready to use Kiro CLI. +The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent use MCP tools effectively for common Arm development tasks. + +#### Get the prompt files + +Browse the [agent integrations directory for Kiro](https://github.com/arm/mcp/tree/main/agent-integrations/kiro) to find prompt files for specific use cases: + +- **Arm migration** ([arm-migration.md](https://github.com/arm/mcp/blob/main/agent-integrations/kiro/arm-migration.md)): Guides the agent through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. + +Each prompt file is a Markdown configuration that you can reference in your Kiro CLI sessions to activate task-specific assistance. + +If you're facing issues or have questions, reach out to mcpserver@arm.com. + +You're now ready to use Kiro CLI with the Arm MCP server for Arm-specific development assistance. From 7d93f12a8273abe83e148b46c81dd71b72ffbffe Mon Sep 17 00:00:00 2001 From: pareenaverma Date: Wed, 18 Mar 2026 08:46:09 -0400 Subject: [PATCH 3/7] Update codex-cli.md --- content/install-guides/codex-cli.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/install-guides/codex-cli.md b/content/install-guides/codex-cli.md index 9329659ff6..f38a5f901e 100644 --- a/content/install-guides/codex-cli.md +++ b/content/install-guides/codex-cli.md @@ -235,7 +235,7 @@ You can also verify the tools are available by asking Codex to list the availabl ### Use Arm prompt files with the MCP Server -The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent use MCP tools effectively for common Arm development tasks. +The Arm MCP Server provides tools and a rich knowledge base, but you’ll get the most value when it’s used alongside Arm-specific prompt files. These prompt files capture task-focused context, best practices, and workflows, guiding the agent to apply MCP tools more effectively across common Arm development scenarios. #### Get the prompt files From 0612a4e0b420bd5e65ea6bebec77fb00d386105d Mon Sep 17 00:00:00 2001 From: pareenaverma Date: Wed, 18 Mar 2026 08:50:15 -0400 Subject: [PATCH 4/7] Refine language for clarity in codex-cli.md --- content/install-guides/codex-cli.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/install-guides/codex-cli.md b/content/install-guides/codex-cli.md index f38a5f901e..014e3337c4 100644 --- a/content/install-guides/codex-cli.md +++ b/content/install-guides/codex-cli.md @@ -235,15 +235,15 @@ You can also verify the tools are available by asking Codex to list the availabl ### Use Arm prompt files with the MCP Server -The Arm MCP Server provides tools and a rich knowledge base, but you’ll get the most value when it’s used alongside Arm-specific prompt files. These prompt files capture task-focused context, best practices, and workflows, guiding the agent to apply MCP tools more effectively across common Arm development scenarios. +The Arm MCP Server provides a rich set of tools and knowledge base, but to make the best use of it, you should pair it with Arm-specific prompt files. These prompt files supply task-oriented context, best practices, and structured workflows that guide the agent in using MCP tools more effectively across common Arm development tasks. #### Get the prompt files Browse the [agent integrations directory for Codex](https://github.com/arm/mcp/tree/main/agent-integrations/codex) to find prompt files for specific use cases: -- **Arm migration** ([arm-migration.md](https://github.com/arm/mcp/blob/main/agent-integrations/codex/arm-migration.md)): Guides the agent through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. +- **Arm migration** ([arm-migration.md](https://github.com/arm/mcp/blob/main/agent-integrations/codex/arm-migration.md)): Helps the agent systematically migrate applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. -Each prompt file is a Markdown configuration that you can reference in your Codex CLI sessions to activate task-specific assistance. +Each prompt file is a Markdown configuration that you can reference in your Codex CLI sessions to enable more targeted, task-specific assistance. If you're facing issues or have questions, reach out to mcpserver@arm.com. From 7a3716f23da321c1839342ea93ceb2074ac18332 Mon Sep 17 00:00:00 2001 From: pareenaverma Date: Wed, 18 Mar 2026 08:51:48 -0400 Subject: [PATCH 5/7] Clarify usage of Arm MCP Server with prompt files Updated the description of the Arm MCP Server and its prompt files for clarity and improved guidance. --- content/install-guides/gemini.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/content/install-guides/gemini.md b/content/install-guides/gemini.md index c67a207bc8..094c259530 100644 --- a/content/install-guides/gemini.md +++ b/content/install-guides/gemini.md @@ -409,16 +409,16 @@ Configured MCP servers: ### Use Arm prompt files with the MCP Server -The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent understand how to use the MCP Server tools effectively for common Arm development tasks. +The Arm MCP Server provides a rich set of tools and knowledge base, but to make the best use of it, you should pair it with Arm-specific prompt files. These prompt files supply task-oriented context, best practices, and structured workflows that guide the agent in using MCP tools more effectively across common Arm development tasks. #### Get the prompt files Browse the [agent integrations directory](https://github.com/arm/mcp/tree/main/agent-integrations/gemini) to find prompt files for specific use cases: -- **Arm migration** ([arm-migration.toml](https://github.com/arm/mcp/blob/main/agent-integrations/gemini/arm-migration.toml)): Guides the agent through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. +- **Arm migration** ([arm-migration.toml](https://github.com/arm/mcp/blob/main/agent-integrations/gemini/arm-migration.toml)): Helps the agent systematically migrate applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. -Each prompt file is a TOML configuration that you can reference in your Gemini CLI sessions to activate task-specific assistance. +Each prompt file is a TOML configuration that you can reference in your Gemini CLI sessions to enable more targeted, task-specific assistance. If you're facing issues or have questions, reach out to mcpserver@arm.com. -You're now ready to use Gemini CLI with the Arm MCP server for Arm-specific development assistance. \ No newline at end of file +You're now ready to use Gemini CLI with the Arm MCP server for Arm-specific development assistance. From 9ae6ce275b50a3a5fba96a158f8cc837bcf93fa0 Mon Sep 17 00:00:00 2001 From: pareenaverma Date: Wed, 18 Mar 2026 08:53:29 -0400 Subject: [PATCH 6/7] Improve clarity of Arm MCP Server documentation Reworded sections to enhance clarity and improve the description of the Arm MCP Server and prompt files. --- content/install-guides/github-copilot.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/install-guides/github-copilot.md b/content/install-guides/github-copilot.md index 24d245ec7c..682f293966 100644 --- a/content/install-guides/github-copilot.md +++ b/content/install-guides/github-copilot.md @@ -337,15 +337,15 @@ Example prompts that use the Arm MCP Server: ## Use Arm prompt files with the MCP Server -The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent use MCP tools effectively for common Arm development tasks. +The Arm MCP Server provides a rich set of tools and knowledge base, but to make the best use of it, you should pair it with Arm-specific prompt files. These prompt files supply task-oriented context, best practices, and structured workflows that guide the agent in using MCP tools more effectively across common Arm development tasks. ### Get the prompt files Browse the [agent integrations directory for Visual Studio Code](https://github.com/arm/mcp/tree/main/agent-integrations/vs-code) to find prompt files for specific use cases: -- **Arm migration** ([arm-migration.prompt.md](https://github.com/arm/mcp/blob/main/agent-integrations/vs-code/arm-migration.prompt.md)): Guides GitHub Copilot Agent mode through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. +- **Arm migration** ([arm-migration.prompt.md](https://github.com/arm/mcp/blob/main/agent-integrations/vs-code/arm-migration.prompt.md)): Helps the agent systematically migrate applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. -Each prompt file is a Markdown configuration that you can reference in your GitHub Copilot sessions to activate task-specific assistance. +Each prompt file is a Markdown configuration that you can reference in your GitHub Copilot sessions to enable more targeted, task-specific assistance. If you're facing issues or have questions, reach out to mcpserver@arm.com. From d60ba7252f6dcadbeb6444cada50e7d770eea4c3 Mon Sep 17 00:00:00 2001 From: pareenaverma Date: Wed, 18 Mar 2026 08:54:26 -0400 Subject: [PATCH 7/7] Improve clarity of Arm MCP Server usage instructions Reworded sections to enhance clarity and precision regarding the use of Arm MCP Server and prompt files. --- content/install-guides/kiro-cli.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/content/install-guides/kiro-cli.md b/content/install-guides/kiro-cli.md index fbc3816ab6..9cc8ca8429 100644 --- a/content/install-guides/kiro-cli.md +++ b/content/install-guides/kiro-cli.md @@ -264,15 +264,15 @@ You should see the Arm MCP server tools listed in the output. If the arm-mcp ser ### Use Arm prompt files with the MCP Server -The Arm MCP Server alone provides tools, but for optimal results, you should use it together with Arm-specific prompt files. Prompt files encode task-specific context, guidelines, and workflows that help the agent use MCP tools effectively for common Arm development tasks. +The Arm MCP Server provides a rich set of tools and knowledge base, but to make the best use of it, you should pair it with Arm-specific prompt files. These prompt files supply task-oriented context, best practices, and structured workflows that guide the agent in using MCP tools more effectively across common Arm development tasks. #### Get the prompt files Browse the [agent integrations directory for Kiro](https://github.com/arm/mcp/tree/main/agent-integrations/kiro) to find prompt files for specific use cases: -- **Arm migration** ([arm-migration.md](https://github.com/arm/mcp/blob/main/agent-integrations/kiro/arm-migration.md)): Guides the agent through migrating applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. +- **Arm migration** ([arm-migration.md](https://github.com/arm/mcp/blob/main/agent-integrations/kiro/arm-migration.md)): Helps the agent systematically migrate applications from x86 to Arm, including dependency analysis, compatibility checks, and optimization recommendations. -Each prompt file is a Markdown configuration that you can reference in your Kiro CLI sessions to activate task-specific assistance. +Each prompt file is a Markdown configuration that you can reference in your Kiro CLI sessions to enable more targeted, task-specific assistance. If you're facing issues or have questions, reach out to mcpserver@arm.com.