Add docs tool to MCP server that returns instructions.md sources

[Copilot]

This PR adds a new "docs" tool to the GitHub Agentic Workflows MCP server that provides direct access to the embedded instructions.md template content.

Problem

AI assistants and MCP clients working with GitHub Agentic Workflows needed easy access to the complete documentation and instructions. Previously, there was no programmatic way to retrieve the comprehensive workflow documentation through the MCP interface.

Solution

Added a new docs tool to the MCP server that returns the full instructions.md template content (~34KB of documentation covering workflow syntax, tools, examples, and best practices).

Implementation Details

New GetInstructionsTemplate() function

Added a clean accessor function in pkg/cli/commands.go that provides access to the embedded instructions template, following the same pattern as GetVersion().

Docs tool in MCP server

The new tool in pkg/cli/mcp_server.go:

• Returns the complete GitHub Agentic Workflows documentation
• Supports verbose logging consistent with other tools
• Uses minimal arguments (optional verbose flag only)
• Follows the established MCP tool implementation pattern

Updated help and tooling

• Added docs tool to gh aw mcp serve --help output
• Updated --allowed-tools flag description to include the new tool
• Maintained consistent formatting with existing tool descriptions

Usage

# Start MCP server with all tools (including docs)
gh aw mcp serve

# Start with only the docs tool
gh aw mcp serve --allowed-tools docs

# Use with other tools
gh aw mcp serve --allowed-tools compile,docs

The tool returns the complete 969-line instructions template, enabling AI assistants to reference workflow syntax, tool configurations, security considerations, and usage examples directly through the MCP interface.

Testing

• Added unit tests for the new GetInstructionsTemplate() function
• Updated integration tests to account for the additional tool (10 instead of 9)
• Verified manual functionality with various tool filtering combinations
• All existing tests continue to pass

Original prompt

Add a "documentation" tool in the MCP server that returns the instructions.md sources.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot rename documentation to docs

[Copilot]

Renamed "documentation" to "docs" throughout the codebase. Changes include tool name, argument struct, help text, tests, and allowed-tools flag description. (commit 82a6ed4)