diff --git a/README.chatmodes.md b/README.chatmodes.md
index e706cfc..5dae26a 100644
--- a/README.chatmodes.md
+++ b/README.chatmodes.md
@@ -55,6 +55,7 @@ Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, e
| [Microsoft Learn Contributor](chatmodes/microsoft_learn_contributor.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fmicrosoft_learn_contributor.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fmicrosoft_learn_contributor.chatmode.md) | Microsoft Learn Contributor chatmode for editing and writing Microsoft Learn documentation following Microsoft Writing Style Guide and authoring best practices. |
| [Microsoft Study and Learn Chat Mode](chatmodes/microsoft-study-mode.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fmicrosoft-study-mode.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fmicrosoft-study-mode.chatmode.md) | Activate your personal Microsoft/Azure tutor - learn through guided discovery, not just answers. |
| [MS-SQL Database Administrator](chatmodes/ms-sql-dba.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fms-sql-dba.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fms-sql-dba.chatmode.md) | Work with Microsoft SQL Server databases using the MS SQL extension. |
+| [PHP MCP Expert](chatmodes/php-mcp-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fphp-mcp-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fphp-mcp-expert.chatmode.md) | Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery |
| [Plan Mode - Strategic Planning & Architecture Assistant](chatmodes/plan.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fplan.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fplan.chatmode.md) | Strategic planning and architecture assistant focused on thoughtful analysis before implementation. Helps developers understand codebases, clarify requirements, and develop comprehensive implementation strategies. |
| [Planning mode instructions](chatmodes/planner.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fplanner.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fplanner.chatmode.md) | Generate an implementation plan for new features or refactoring existing code. |
| [Playwright Tester](chatmodes/playwright-tester.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fplaywright-tester.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fplaywright-tester.chatmode.md) | Testing mode for Playwright tests |
diff --git a/README.collections.md b/README.collections.md
index f4cc19e..505f47d 100644
--- a/README.collections.md
+++ b/README.collections.md
@@ -26,6 +26,7 @@ Curated collections of related prompts, instructions, and chat modes organized a
| [Java Development](collections/java-development.md) | Comprehensive collection of prompts and instructions for Java development including Spring Boot, Quarkus, testing, documentation, and best practices. | 12 items | java, springboot, quarkus, jpa, junit, javadoc |
| [Java MCP Server Development](collections/java-mcp-development.md) | 'Complete toolkit for building Model Context Protocol servers in Java using the official MCP Java SDK with reactive streams and Spring Boot integration.' | 3 items | java, mcp, model-context-protocol, server-development, sdk, reactive-streams, spring-boot, reactor |
| [Kotlin MCP Server Development](collections/kotlin-mcp-development.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Kotlin using the official io.modelcontextprotocol:kotlin-sdk library. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 3 items | kotlin, mcp, model-context-protocol, kotlin-multiplatform, server-development, ktor |
+| [PHP MCP Server Development](collections/php-mcp-development.md) | 'Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance' | 3 items | php, mcp, model-context-protocol, server-development, sdk, attributes, composer |
| [Power Apps Code Apps Development](collections/power-apps-code-apps.md) | Complete toolkit for Power Apps Code Apps development including project scaffolding, development standards, and expert guidance for building code-first applications with Power Platform integration. | 3 items | power-apps, power-platform, typescript, react, code-apps, dataverse, connectors |
| [Power BI Development](collections/power-bi-development.md) | Comprehensive Power BI development resources including data modeling, DAX optimization, performance tuning, visualization design, security best practices, and DevOps/ALM guidance for building enterprise-grade Power BI solutions. | 14 items | power-bi, dax, data-modeling, performance, visualization, security, devops, business-intelligence |
| [Power Platform MCP Connector Development](collections/power-platform-mcp-connector-development.md) | Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio | 4 items | power-platform, mcp, copilot-studio, custom-connector, json-rpc |
diff --git a/README.instructions.md b/README.instructions.md
index 7678957..029ca51 100644
--- a/README.instructions.md
+++ b/README.instructions.md
@@ -79,6 +79,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for
| [Object Calisthenics Rules](instructions/object-calisthenics.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fobject-calisthenics.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fobject-calisthenics.instructions.md) | Enforces Object Calisthenics principles for business domain code to ensure clean, maintainable, and robust code |
| [Oqtane](instructions/oqtane.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Foqtane.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Foqtane.instructions.md) | Oqtane Module patterns |
| [Performance Optimization Best Practices](instructions/performance-optimization.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fperformance-optimization.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fperformance-optimization.instructions.md) | The most comprehensive, practical, and engineer-authored performance optimization instructions for all languages, frameworks, and stacks. Covers frontend, backend, and database best practices with actionable guidance, scenario-based checklists, troubleshooting, and pro tips. |
+| [PHP MCP Server Development Best Practices](instructions/php-mcp-server.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-mcp-server.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-mcp-server.instructions.md) | Best practices for building Model Context Protocol servers in PHP using the official PHP SDK with attribute-based discovery and multiple transport options |
| [Playwright Python Test Generation Instructions](instructions/playwright-python.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fplaywright-python.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fplaywright-python.instructions.md) | Playwright Python AI test generation instructions based on official documentation. |
| [Playwright Typescript](instructions/playwright-typescript.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fplaywright-typescript.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fplaywright-typescript.instructions.md) | Playwright test generation instructions |
| [Power Apps Canvas Apps YAML Structure Guide](instructions/power-apps-canvas-yaml.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-apps-canvas-yaml.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-apps-canvas-yaml.instructions.md) | Comprehensive guide for working with Power Apps Canvas Apps YAML structure based on Microsoft Power Apps YAML schema v3.0. Covers Power Fx formulas, control structures, data types, and source control best practices. |
diff --git a/README.prompts.md b/README.prompts.md
index 66bfce3..45b9abb 100644
--- a/README.prompts.md
+++ b/README.prompts.md
@@ -81,6 +81,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
| [My Pull Requests](prompts/my-pull-requests.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmy-pull-requests.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmy-pull-requests.prompt.md) | List my pull requests in the current repository |
| [Next Intl Add Language](prompts/next-intl-add-language.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fnext-intl-add-language.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fnext-intl-add-language.prompt.md) | Add new language to a Next.js + next-intl application |
| [NUnit Best Practices](prompts/csharp-nunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-nunit.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcsharp-nunit.prompt.md) | Get best practices for NUnit unit testing, including data-driven tests |
+| [PHP MCP Server Generator](prompts/php-mcp-server-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fphp-mcp-server-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fphp-mcp-server-generator.prompt.md) | Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK |
| [PostgreSQL Code Review Assistant](prompts/postgresql-code-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpostgresql-code-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpostgresql-code-review.prompt.md) | PostgreSQL-specific code review assistant focusing on PostgreSQL best practices, anti-patterns, and unique quality standards. Covers JSONB operations, array usage, custom types, schema design, function optimization, and PostgreSQL-exclusive security features like Row Level Security (RLS). |
| [PostgreSQL Development Assistant](prompts/postgresql-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpostgresql-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpostgresql-optimization.prompt.md) | PostgreSQL-specific development assistant focusing on unique PostgreSQL features, advanced data types, and PostgreSQL-exclusive capabilities. Covers JSONB operations, array types, custom types, range/geometric types, full-text search, window functions, and PostgreSQL extensions ecosystem. |
| [Power Apps Code Apps Project Scaffolding](prompts/power-apps-code-app-scaffold.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-apps-code-app-scaffold.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-apps-code-app-scaffold.prompt.md) | Scaffold a complete Power Apps Code App project with PAC CLI setup, SDK integration, and connector configuration |
@@ -96,6 +97,7 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
| [Project Workflow Documentation Generator](prompts/project-workflow-analysis-blueprint-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fproject-workflow-analysis-blueprint-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fproject-workflow-analysis-blueprint-generator.prompt.md) | Comprehensive technology-agnostic prompt generator for documenting end-to-end application workflows. Automatically detects project architecture patterns, technology stacks, and data flow patterns to generate detailed implementation blueprints covering entry points, service layers, data access, error handling, and testing approaches across multiple technologies including .NET, Java/Spring, React, and microservices architectures. |
| [README Generator Prompt](prompts/readme-blueprint-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Freadme-blueprint-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Freadme-blueprint-generator.prompt.md) | Intelligent README.md generation prompt that analyzes project documentation structure and creates comprehensive repository documentation. Scans .github/copilot directory files and copilot-instructions.md to extract project information, technology stack, architecture, development workflow, coding standards, and testing approaches while generating well-structured markdown documentation with proper formatting, cross-references, and developer-focused content. |
| [Refactoring Java Methods with Extract Method](prompts/java-refactoring-extract-method.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fjava-refactoring-extract-method.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fjava-refactoring-extract-method.prompt.md) | Refactoring using Extract Methods in Java Language |
+| [Refactoring Java Methods with Remove Parameter](prompts/java-refactoring-remove-parameter.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fjava-refactoring-remove-parameter.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fjava-refactoring-remove-parameter.prompt.md) | Refactoring using Remove Parameter in Java Language |
| [Repo Story Time](prompts/repo-story-time.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Frepo-story-time.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Frepo-story-time.prompt.md) | Generate a comprehensive repository summary and narrative story from commit history |
| [Review And Refactor](prompts/review-and-refactor.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Freview-and-refactor.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Freview-and-refactor.prompt.md) | Review and refactor code in your project according to defined instructions |
| [Ruby MCP Server Generator](prompts/ruby-mcp-server-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fruby-mcp-server-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fruby-mcp-server-generator.prompt.md) | Generate a complete Model Context Protocol server project in Ruby using the official MCP Ruby SDK gem. |
diff --git a/chatmodes/php-mcp-expert.chatmode.md b/chatmodes/php-mcp-expert.chatmode.md
new file mode 100644
index 0000000..3f10dab
--- /dev/null
+++ b/chatmodes/php-mcp-expert.chatmode.md
@@ -0,0 +1,498 @@
+---
+description: 'Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery'
+model: GPT-4.1
+---
+
+# PHP MCP Expert
+
+You are an expert PHP developer specializing in building Model Context Protocol (MCP) servers using the official PHP SDK. You help developers create production-ready, type-safe, and performant MCP servers in PHP 8.2+.
+
+## Your Expertise
+
+- **PHP SDK**: Deep knowledge of the official PHP MCP SDK maintained by The PHP Foundation
+- **Attributes**: Expertise with PHP attributes (`#[McpTool]`, `#[McpResource]`, `#[McpPrompt]`, `#[Schema]`)
+- **Discovery**: Attribute-based discovery and caching with PSR-16
+- **Transports**: Stdio and StreamableHTTP transports
+- **Type Safety**: Strict types, enums, parameter validation
+- **Testing**: PHPUnit, test-driven development
+- **Frameworks**: Laravel, Symfony integration
+- **Performance**: OPcache, caching strategies, optimization
+
+## Common Tasks
+
+### Tool Implementation
+
+Help developers implement tools with attributes:
+
+```php
+ '1.0.0',
+ 'debug' => false
+ ];
+ }
+
+ /**
+ * Provides dynamic user profiles.
+ */
+ #[McpResourceTemplate(
+ uriTemplate: 'user://{userId}/profile/{section}',
+ name: 'user_profile',
+ mimeType: 'application/json'
+ )]
+ public function getUserProfile(string $userId, string $section): array
+ {
+ // Variables must match URI template order
+ return $this->users[$userId][$section] ??
+ throw new \RuntimeException("Profile not found");
+ }
+}
+```
+
+### Prompt Implementation
+
+Assist with prompt generators:
+
+```php
+ 'assistant', 'content' => 'You are an expert code reviewer.'],
+ ['role' => 'user', 'content' => "Review this {$language} code focusing on {$focus}:\n\n```{$language}\n{$code}\n```"]
+ ];
+ }
+}
+```
+
+### Server Setup
+
+Guide server configuration with discovery and caching:
+
+```php
+setServerInfo('My MCP Server', '1.0.0')
+ ->setDiscovery(
+ basePath: __DIR__,
+ scanDirs: ['src/Tools', 'src/Resources', 'src/Prompts'],
+ excludeDirs: ['vendor', 'tests', 'cache'],
+ cache: $cache
+ )
+ ->build();
+
+// Run with stdio transport
+$transport = new StdioTransport();
+$server->run($transport);
+```
+
+### HTTP Transport
+
+Help with web-based MCP servers:
+
+```php
+createServerRequestFromGlobals();
+
+$transport = new StreamableHttpTransport(
+ $request,
+ $psr17Factory, // Response factory
+ $psr17Factory // Stream factory
+);
+
+$response = $server->run($transport);
+
+// Send PSR-7 response
+http_response_code($response->getStatusCode());
+foreach ($response->getHeaders() as $name => $values) {
+ foreach ($values as $value) {
+ header("{$name}: {$value}", false);
+ }
+}
+echo $response->getBody();
+```
+
+### Schema Validation
+
+Advise on parameter validation with Schema attributes:
+
+```php
+use Mcp\Capability\Attribute\Schema;
+
+#[McpTool]
+public function createUser(
+ #[Schema(format: 'email')]
+ string $email,
+
+ #[Schema(minimum: 18, maximum: 120)]
+ int $age,
+
+ #[Schema(
+ pattern: '^[A-Z][a-z]+$',
+ description: 'Capitalized first name'
+ )]
+ string $firstName,
+
+ #[Schema(minLength: 8, maxLength: 100)]
+ string $password
+): array {
+ return [
+ 'id' => uniqid(),
+ 'email' => $email,
+ 'age' => $age,
+ 'name' => $firstName
+ ];
+}
+```
+
+### Error Handling
+
+Guide proper exception handling:
+
+```php
+#[McpTool]
+public function divideNumbers(float $a, float $b): float
+{
+ if ($b === 0.0) {
+ throw new \InvalidArgumentException('Division by zero is not allowed');
+ }
+
+ return $a / $b;
+}
+
+#[McpTool]
+public function processFile(string $filename): string
+{
+ if (!file_exists($filename)) {
+ throw new \InvalidArgumentException("File not found: {$filename}");
+ }
+
+ if (!is_readable($filename)) {
+ throw new \RuntimeException("File not readable: {$filename}");
+ }
+
+ return file_get_contents($filename);
+}
+```
+
+### Testing
+
+Provide testing guidance with PHPUnit:
+
+```php
+calculator = new Calculator();
+ }
+
+ public function testAdd(): void
+ {
+ $result = $this->calculator->add(5, 3);
+ $this->assertSame(8, $result);
+ }
+
+ public function testDivideByZero(): void
+ {
+ $this->expectException(\InvalidArgumentException::class);
+ $this->expectExceptionMessage('Division by zero');
+
+ $this->calculator->divide(10, 0);
+ }
+}
+```
+
+### Completion Providers
+
+Help with auto-completion:
+
+```php
+use Mcp\Capability\Attribute\CompletionProvider;
+
+enum Priority: string
+{
+ case LOW = 'low';
+ case MEDIUM = 'medium';
+ case HIGH = 'high';
+}
+
+#[McpPrompt]
+public function createTask(
+ string $title,
+
+ #[CompletionProvider(enum: Priority::class)]
+ string $priority,
+
+ #[CompletionProvider(values: ['bug', 'feature', 'improvement'])]
+ string $type
+): array {
+ return [
+ ['role' => 'user', 'content' => "Create {$type} task: {$title} (Priority: {$priority})"]
+ ];
+}
+```
+
+### Framework Integration
+
+#### Laravel
+
+```php
+// app/Console/Commands/McpServerCommand.php
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Mcp\Server;
+use Mcp\Server\Transport\StdioTransport;
+
+class McpServerCommand extends Command
+{
+ protected $signature = 'mcp:serve';
+ protected $description = 'Start MCP server';
+
+ public function handle(): int
+ {
+ $server = Server::builder()
+ ->setServerInfo('Laravel MCP Server', '1.0.0')
+ ->setDiscovery(app_path(), ['Tools', 'Resources'])
+ ->build();
+
+ $transport = new StdioTransport();
+ $server->run($transport);
+
+ return 0;
+ }
+}
+```
+
+#### Symfony
+
+```php
+// Use the official Symfony MCP Bundle
+// composer require symfony/mcp-bundle
+
+// config/packages/mcp.yaml
+mcp:
+ server:
+ name: 'Symfony MCP Server'
+ version: '1.0.0'
+```
+
+### Performance Optimization
+
+1. **Enable OPcache**:
+```ini
+; php.ini
+opcache.enable=1
+opcache.memory_consumption=256
+opcache.interned_strings_buffer=16
+opcache.max_accelerated_files=10000
+opcache.validate_timestamps=0 ; Production only
+```
+
+2. **Use Discovery Caching**:
+```php
+use Symfony\Component\Cache\Adapter\RedisAdapter;
+use Symfony\Component\Cache\Psr16Cache;
+
+$redis = new \Redis();
+$redis->connect('127.0.0.1', 6379);
+
+$cache = new Psr16Cache(new RedisAdapter($redis));
+
+$server = Server::builder()
+ ->setDiscovery(__DIR__, ['src'], cache: $cache)
+ ->build();
+```
+
+3. **Optimize Composer Autoloader**:
+```bash
+composer dump-autoload --optimize --classmap-authoritative
+```
+
+## Deployment Guidance
+
+### Docker
+
+```dockerfile
+FROM php:8.2-cli
+
+RUN docker-php-ext-install pdo pdo_mysql opcache
+
+COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
+
+WORKDIR /app
+COPY . /app
+
+RUN composer install --no-dev --optimize-autoloader
+
+RUN chmod +x /app/server.php
+
+CMD ["php", "/app/server.php"]
+```
+
+### Systemd Service
+
+```ini
+[Unit]
+Description=PHP MCP Server
+After=network.target
+
+[Service]
+Type=simple
+User=www-data
+WorkingDirectory=/var/www/mcp-server
+ExecStart=/usr/bin/php /var/www/mcp-server/server.php
+Restart=always
+RestartSec=3
+
+[Install]
+WantedBy=multi-user.target
+```
+
+### Claude Desktop
+
+```json
+{
+ "mcpServers": {
+ "php-server": {
+ "command": "php",
+ "args": ["/absolute/path/to/server.php"]
+ }
+ }
+}
+```
+
+## Best Practices
+
+1. **Always use strict types**: `declare(strict_types=1);`
+2. **Use typed properties**: PHP 7.4+ typed properties for all class properties
+3. **Leverage enums**: PHP 8.1+ enums for constants and completions
+4. **Cache discovery**: Always use PSR-16 cache in production
+5. **Type all parameters**: Use type hints for all method parameters
+6. **Document with PHPDoc**: Add docblocks for better discovery
+7. **Test everything**: Write PHPUnit tests for all tools
+8. **Handle exceptions**: Use specific exception types with clear messages
+
+## Communication Style
+
+- Provide complete, working code examples
+- Explain PHP 8.2+ features (attributes, enums, match expressions)
+- Include error handling in all examples
+- Suggest performance optimizations
+- Reference official PHP SDK documentation
+- Help debug attribute discovery issues
+- Recommend testing strategies
+- Guide on framework integration
+
+You're ready to help developers build robust, performant MCP servers in PHP!
diff --git a/collections/azure-cloud-development.md b/collections/azure-cloud-development.md
index 70c1dbc..5416f64 100644
--- a/collections/azure-cloud-development.md
+++ b/collections/azure-cloud-development.md
@@ -28,4 +28,4 @@ Comprehensive Azure cloud development tools including Infrastructure as Code, se
| [Terraform Conventions](../instructions/terraform.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fterraform.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fterraform.instructions.md) | Instruction | Terraform Conventions and Guidelines |
---
-*This collection includes 18 curated items for azure & cloud development.*
\ No newline at end of file
+*This collection includes 18 curated items for **Azure & Cloud Development**.*
\ No newline at end of file
diff --git a/collections/clojure-interactive-programming.md b/collections/clojure-interactive-programming.md
index 2f37bd6..a619b4e 100644
--- a/collections/clojure-interactive-programming.md
+++ b/collections/clojure-interactive-programming.md
@@ -13,4 +13,4 @@ Tools for REPL-first Clojure workflows featuring Clojure instructions, the inter
| [Interactive Programming Nudge](../prompts/remember-interactive-programming.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fremember-interactive-programming.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fremember-interactive-programming.prompt.md) | Prompt | A micro-prompt that reminds the agent that it is an interactive programmer. Works great in Clojure when Copilot has access to the REPL (probably via Backseat Driver). Will work with any system that has a live REPL that the agent can use. Adapt the prompt with any specific reminders in your workflow and/or workspace. |
---
-*This collection includes 3 curated items for clojure interactive programming.*
\ No newline at end of file
+*This collection includes 3 curated items for **Clojure Interactive Programming**.*
\ No newline at end of file
diff --git a/collections/csharp-mcp-development.md b/collections/csharp-mcp-development.md
index 5d57b93..5f75b03 100644
--- a/collections/csharp-mcp-development.md
+++ b/collections/csharp-mcp-development.md
@@ -35,4 +35,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for c# mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **C# MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/database-data-management.md b/collections/database-data-management.md
index e7da423..b8d77ac 100644
--- a/collections/database-data-management.md
+++ b/collections/database-data-management.md
@@ -18,4 +18,4 @@ Database administration, SQL optimization, and data management tools for Postgre
| [SQL Performance Optimization Assistant](../prompts/sql-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsql-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fsql-optimization.prompt.md) | Prompt | Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance. |
---
-*This collection includes 8 curated items for database & data management.*
\ No newline at end of file
+*This collection includes 8 curated items for **Database & Data Management**.*
\ No newline at end of file
diff --git a/collections/devops-oncall.md b/collections/devops-oncall.md
index b4513e8..c09ea68 100644
--- a/collections/devops-oncall.md
+++ b/collections/devops-oncall.md
@@ -15,4 +15,4 @@ A focused set of prompts, instructions, and a chat mode to help triage incidents
| [Multi Stage Dockerfile](../prompts/multi-stage-dockerfile.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmulti-stage-dockerfile.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmulti-stage-dockerfile.prompt.md) | Prompt | Create optimized multi-stage Dockerfiles for any language or framework |
---
-*This collection includes 5 curated items for devops on-call.*
\ No newline at end of file
+*This collection includes 5 curated items for **DevOps On-Call**.*
\ No newline at end of file
diff --git a/collections/edge-ai-tasks.md b/collections/edge-ai-tasks.md
index 75559ca..b2ba42b 100644
--- a/collections/edge-ai-tasks.md
+++ b/collections/edge-ai-tasks.md
@@ -97,4 +97,4 @@ To use these generated instructions and prompts, you'll need to update your `set
---
-*This collection includes 3 curated items for tasks by microsoft/edge-ai.*
\ No newline at end of file
+*This collection includes 3 curated items for **Tasks by microsoft/edge-ai**.*
\ No newline at end of file
diff --git a/collections/frontend-web-dev.md b/collections/frontend-web-dev.md
index 74b83b5..88b63a9 100644
--- a/collections/frontend-web-dev.md
+++ b/collections/frontend-web-dev.md
@@ -21,4 +21,4 @@ Essential prompts, instructions, and chat modes for modern frontend web developm
| [Website Exploration for Testing](../prompts/playwright-explore-website.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fplaywright-explore-website.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fplaywright-explore-website.prompt.md) | Prompt | Website exploration for testing using Playwright MCP |
---
-*This collection includes 11 curated items for frontend web development.*
\ No newline at end of file
+*This collection includes 11 curated items for **Frontend Web Development**.*
\ No newline at end of file
diff --git a/collections/go-mcp-development.md b/collections/go-mcp-development.md
index 9358234..02b150e 100644
--- a/collections/go-mcp-development.md
+++ b/collections/go-mcp-development.md
@@ -38,4 +38,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for go mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Go MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/java-mcp-development.md b/collections/java-mcp-development.md
index 4a400de..ccfc63b 100644
--- a/collections/java-mcp-development.md
+++ b/collections/java-mcp-development.md
@@ -38,4 +38,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for java mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Java MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/kotlin-mcp-development.md b/collections/kotlin-mcp-development.md
index 2949337..e39b366 100644
--- a/collections/kotlin-mcp-development.md
+++ b/collections/kotlin-mcp-development.md
@@ -38,4 +38,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for kotlin mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Kotlin MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/php-mcp-development.collection.yml b/collections/php-mcp-development.collection.yml
new file mode 100644
index 0000000..63f585b
--- /dev/null
+++ b/collections/php-mcp-development.collection.yml
@@ -0,0 +1,21 @@
+id: php-mcp-development
+name: PHP MCP Server Development
+description: 'Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance'
+tags:
+ - php
+ - mcp
+ - model-context-protocol
+ - server-development
+ - sdk
+ - attributes
+ - composer
+items:
+ - path: instructions/php-mcp-server.instructions.md
+ kind: instruction
+ - path: prompts/php-mcp-server-generator.prompt.md
+ kind: prompt
+ - path: chatmodes/php-mcp-expert.chatmode.md
+ kind: chat-mode
+display:
+ ordering: manual
+ show_badge: true
diff --git a/collections/php-mcp-development.md b/collections/php-mcp-development.md
new file mode 100644
index 0000000..5294f02
--- /dev/null
+++ b/collections/php-mcp-development.md
@@ -0,0 +1,16 @@
+# PHP MCP Server Development
+
+'Comprehensive resources for building Model Context Protocol servers using the official PHP SDK with attribute-based discovery, including best practices, project generation, and expert assistance'
+
+**Tags:** php, mcp, model-context-protocol, server-development, sdk, attributes, composer
+
+## Items in this Collection
+
+| Title | Type | Description |
+| ----- | ---- | ----------- |
+| [PHP MCP Server Development Best Practices](../instructions/php-mcp-server.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-mcp-server.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fphp-mcp-server.instructions.md) | Instruction | Best practices for building Model Context Protocol servers in PHP using the official PHP SDK with attribute-based discovery and multiple transport options |
+| [PHP MCP Server Generator](../prompts/php-mcp-server-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fphp-mcp-server-generator.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fphp-mcp-server-generator.prompt.md) | Prompt | Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK |
+| [PHP MCP Expert](../chatmodes/php-mcp-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fphp-mcp-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fphp-mcp-expert.chatmode.md) | Chat Mode | Expert assistant for PHP MCP server development using the official PHP SDK with attribute-based discovery |
+
+---
+*This collection includes 3 curated items for **PHP MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/power-apps-code-apps.md b/collections/power-apps-code-apps.md
index 90ec470..ab587a7 100644
--- a/collections/power-apps-code-apps.md
+++ b/collections/power-apps-code-apps.md
@@ -13,4 +13,4 @@ Complete toolkit for Power Apps Code Apps development including project scaffold
| [Power Platform Expert](../chatmodes/power-platform-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-platform-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-platform-expert.chatmode.md) | Chat Mode | Power Platform expert providing guidance on Code Apps, canvas apps, Dataverse, connectors, and Power Platform best practices |
---
-*This collection includes 3 curated items for power apps code apps development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Power Apps Code Apps Development**.*
\ No newline at end of file
diff --git a/collections/power-bi-development.md b/collections/power-bi-development.md
index 36f71a8..3bdd4f9 100644
--- a/collections/power-bi-development.md
+++ b/collections/power-bi-development.md
@@ -8,20 +8,20 @@ Comprehensive Power BI development resources including data modeling, DAX optimi
| Title | Type | Description |
| ----- | ---- | ----------- |
-| [Power BI Custom Visuals Development](../instructions/power-bi-custom-visuals-development.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-custom-visuals-development.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-custom-visuals-development.instructions.md) | Instruction | Guidelines for developing custom visuals for Power BI using TypeScript, D3.js, and the Power BI Visuals SDK |
-| [Power BI Data Modeling Best Practices](../instructions/power-bi-data-modeling-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-data-modeling-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-data-modeling-best-practices.instructions.md) | Instruction | Best practices for designing efficient and scalable data models in Power BI |
-| [Power BI Data Modeling Expert](../chatmodes/power-bi-data-modeling-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-data-modeling-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-data-modeling-expert.chatmode.md) | Chat Mode | Expert guidance for Power BI data modeling, including star schema design, relationships, and optimization techniques |
-| [Power BI DAX Best Practices](../instructions/power-bi-dax-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-dax-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-dax-best-practices.instructions.md) | Instruction | Best practices for writing efficient and maintainable DAX code in Power BI |
-| [Power BI DAX Expert](../chatmodes/power-bi-dax-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-dax-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-dax-expert.chatmode.md) | Chat Mode | Expert guidance for writing, optimizing, and troubleshooting DAX formulas in Power BI |
-| [Power BI DAX Optimization](../prompts/power-bi-dax-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-dax-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-dax-optimization.prompt.md) | Prompt | Analyze and optimize DAX formulas for better performance in Power BI reports |
-| [Power BI DevOps & ALM Best Practices](../instructions/power-bi-devops-alm-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-devops-alm-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-devops-alm-best-practices.instructions.md) | Instruction | DevOps and Application Lifecycle Management practices for Power BI development |
-| [Power BI Model Design Review](../prompts/power-bi-model-design-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-model-design-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-model-design-review.prompt.md) | Prompt | Comprehensive review of Power BI data models for optimization and best practices |
-| [Power BI Performance Expert](../chatmodes/power-bi-performance-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-performance-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-performance-expert.chatmode.md) | Chat Mode | Expert guidance for optimizing Power BI report and data model performance |
-| [Power BI Performance Troubleshooting](../prompts/power-bi-performance-troubleshooting.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-performance-troubleshooting.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-performance-troubleshooting.prompt.md) | Prompt | Diagnose and resolve performance issues in Power BI reports and data models |
-| [Power BI Report Design Best Practices](../instructions/power-bi-report-design-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-report-design-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-report-design-best-practices.instructions.md) | Instruction | Best practices for designing effective and user-friendly Power BI reports |
-| [Power BI Report Design Consultation](../prompts/power-bi-report-design-consultation.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-report-design-consultation.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-report-design-consultation.prompt.md) | Prompt | Get expert consultation on Power BI report design, layout, and user experience |
-| [Power BI Security & RLS Best Practices](../instructions/power-bi-security-rls-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-security-rls-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-security-rls-best-practices.instructions.md) | Instruction | Security best practices and Row-Level Security (RLS) implementation in Power BI |
-| [Power BI Visualization Expert](../chatmodes/power-bi-visualization-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-visualization-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Ftroystaylor%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-visualization-expert.chatmode.md) | Chat Mode | Expert guidance for creating effective and engaging visualizations in Power BI |
+| [Power BI Data Modeling Expert Mode](../chatmodes/power-bi-data-modeling-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-data-modeling-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-data-modeling-expert.chatmode.md) | Chat Mode | Expert Power BI data modeling guidance using star schema principles, relationship design, and Microsoft best practices for optimal model performance and usability. |
+| [Power BI DAX Expert Mode](../chatmodes/power-bi-dax-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-dax-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-dax-expert.chatmode.md) | Chat Mode | Expert Power BI DAX guidance using Microsoft best practices for performance, readability, and maintainability of DAX formulas and calculations. |
+| [Power BI Performance Expert Mode](../chatmodes/power-bi-performance-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-performance-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-performance-expert.chatmode.md) | Chat Mode | Expert Power BI performance optimization guidance for troubleshooting, monitoring, and improving the performance of Power BI models, reports, and queries. |
+| [Power BI Visualization Expert Mode](../chatmodes/power-bi-visualization-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-visualization-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-bi-visualization-expert.chatmode.md) | Chat Mode | Expert Power BI report design and visualization guidance using Microsoft best practices for creating effective, performant, and user-friendly reports and dashboards. |
+| [Power BI Custom Visuals Development Best Practices](../instructions/power-bi-custom-visuals-development.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-custom-visuals-development.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-custom-visuals-development.instructions.md) | Instruction | Comprehensive Power BI custom visuals development guide covering React, D3.js integration, TypeScript patterns, testing frameworks, and advanced visualization techniques. |
+| [Power BI Data Modeling Best Practices](../instructions/power-bi-data-modeling-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-data-modeling-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-data-modeling-best-practices.instructions.md) | Instruction | Comprehensive Power BI data modeling best practices based on Microsoft guidance for creating efficient, scalable, and maintainable semantic models using star schema principles. |
+| [Power BI DAX Best Practices](../instructions/power-bi-dax-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-dax-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-dax-best-practices.instructions.md) | Instruction | Comprehensive Power BI DAX best practices and patterns based on Microsoft guidance for creating efficient, maintainable, and performant DAX formulas. |
+| [Power BI DevOps and Application Lifecycle Management Best Practices](../instructions/power-bi-devops-alm-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-devops-alm-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-devops-alm-best-practices.instructions.md) | Instruction | Comprehensive guide for Power BI DevOps, Application Lifecycle Management (ALM), CI/CD pipelines, deployment automation, and version control best practices. |
+| [Power BI Report Design and Visualization Best Practices](../instructions/power-bi-report-design-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-report-design-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-report-design-best-practices.instructions.md) | Instruction | Comprehensive Power BI report design and visualization best practices based on Microsoft guidance for creating effective, accessible, and performant reports and dashboards. |
+| [Power BI Security and Row-Level Security Best Practices](../instructions/power-bi-security-rls-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-security-rls-best-practices.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpower-bi-security-rls-best-practices.instructions.md) | Instruction | Comprehensive Power BI Row-Level Security (RLS) and advanced security patterns implementation guide with dynamic security, best practices, and governance strategies. |
+| [Power BI DAX Formula Optimizer](../prompts/power-bi-dax-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-dax-optimization.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-dax-optimization.prompt.md) | Prompt | Comprehensive Power BI DAX formula optimization prompt for improving performance, readability, and maintainability of DAX calculations. |
+| [Power BI Data Model Design Review](../prompts/power-bi-model-design-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-model-design-review.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-model-design-review.prompt.md) | Prompt | Comprehensive Power BI data model design review prompt for evaluating model architecture, relationships, and optimization opportunities. |
+| [Power BI Performance Troubleshooting Guide](../prompts/power-bi-performance-troubleshooting.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-performance-troubleshooting.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-performance-troubleshooting.prompt.md) | Prompt | Systematic Power BI performance troubleshooting prompt for identifying, diagnosing, and resolving performance issues in Power BI models, reports, and queries. |
+| [Power BI Report Visualization Designer](../prompts/power-bi-report-design-consultation.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-report-design-consultation.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fpower-bi-report-design-consultation.prompt.md) | Prompt | Power BI report visualization design prompt for creating effective, user-friendly, and accessible reports with optimal chart selection and layout design. |
---
-*This collection includes 14 curated items for Power BI development.*
+*This collection includes 14 curated items for **Power BI Development**.*
\ No newline at end of file
diff --git a/collections/power-platform-mcp-connector-development.md b/collections/power-platform-mcp-connector-development.md
index 8449b04..8d9494d 100644
--- a/collections/power-platform-mcp-connector-development.md
+++ b/collections/power-platform-mcp-connector-development.md
@@ -14,4 +14,4 @@ Complete toolkit for developing Power Platform custom connectors with Model Cont
| [Power Platform MCP Integration Expert](../chatmodes/power-platform-mcp-integration-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-platform-mcp-integration-expert.chatmode.md)
[](https://aka.ms/awesome-copilot/install/chatmode?url=vscode-insiders%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpower-platform-mcp-integration-expert.chatmode.md) | Chat Mode | Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns |
---
-*This collection includes 4 curated items for power platform mcp connector development.*
\ No newline at end of file
+*This collection includes 4 curated items for **Power Platform MCP Connector Development**.*
\ No newline at end of file
diff --git a/collections/project-planning.md b/collections/project-planning.md
index 5e0a05d..420c392 100644
--- a/collections/project-planning.md
+++ b/collections/project-planning.md
@@ -27,4 +27,4 @@ Tools and guidance for software project planning, feature breakdown, epic manage
| [Update Implementation Plan](../prompts/update-implementation-plan.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fupdate-implementation-plan.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fupdate-implementation-plan.prompt.md) | Prompt | Update an existing implementation plan file with new or update requirements to provide new features, refactoring existing code or upgrading packages, design, architecture or infrastructure. |
---
-*This collection includes 17 curated items for project planning & management.*
\ No newline at end of file
+*This collection includes 17 curated items for **Project Planning & Management**.*
\ No newline at end of file
diff --git a/collections/python-mcp-development.md b/collections/python-mcp-development.md
index f285b77..bf24521 100644
--- a/collections/python-mcp-development.md
+++ b/collections/python-mcp-development.md
@@ -38,4 +38,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for python mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Python MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/ruby-mcp-development.md b/collections/ruby-mcp-development.md
index 4fcaa07..f483f42 100644
--- a/collections/ruby-mcp-development.md
+++ b/collections/ruby-mcp-development.md
@@ -38,4 +38,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for ruby mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Ruby MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/rust-mcp-development.md b/collections/rust-mcp-development.md
index b036a12..7085158 100644
--- a/collections/rust-mcp-development.md
+++ b/collections/rust-mcp-development.md
@@ -39,4 +39,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for rust mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Rust MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/security-best-practices.md b/collections/security-best-practices.md
index 5a88cdb..72b9dd5 100644
--- a/collections/security-best-practices.md
+++ b/collections/security-best-practices.md
@@ -16,4 +16,4 @@ Security frameworks, accessibility guidelines, performance optimization, and cod
| [Self-explanatory Code Commenting Instructions](../instructions/self-explanatory-code-commenting.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fself-explanatory-code-commenting.instructions.md)
[](https://aka.ms/awesome-copilot/install/instructions?url=vscode-insiders%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fself-explanatory-code-commenting.instructions.md) | Instruction | Guidelines for GitHub Copilot to write comments to achieve self-explanatory code with less comments. Examples are in JavaScript but it should work on any language that has comments. |
---
-*This collection includes 6 curated items for security & code quality.*
\ No newline at end of file
+*This collection includes 6 curated items for **Security & Code Quality**.*
\ No newline at end of file
diff --git a/collections/swift-mcp-development.md b/collections/swift-mcp-development.md
index 3cabb90..66c08c9 100644
--- a/collections/swift-mcp-development.md
+++ b/collections/swift-mcp-development.md
@@ -38,4 +38,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for swift mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **Swift MCP Server Development**.*
\ No newline at end of file
diff --git a/collections/technical-spike.md b/collections/technical-spike.md
index e3beb93..88d6f89 100644
--- a/collections/technical-spike.md
+++ b/collections/technical-spike.md
@@ -12,4 +12,4 @@ Tools for creation, management and research of technical spikes to reduce unknow
| [Create Technical Spike Document](../prompts/create-technical-spike.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcreate-technical-spike.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fcreate-technical-spike.prompt.md) | Prompt | Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation. |
---
-*This collection includes 2 curated items for technical spike.*
\ No newline at end of file
+*This collection includes 2 curated items for **Technical Spike**.*
\ No newline at end of file
diff --git a/collections/testing-automation.md b/collections/testing-automation.md
index 5aac417..1c4d00f 100644
--- a/collections/testing-automation.md
+++ b/collections/testing-automation.md
@@ -21,4 +21,4 @@ Comprehensive collection for writing tests, test automation, and test-driven dev
| [Website Exploration for Testing](../prompts/playwright-explore-website.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fplaywright-explore-website.prompt.md)
[](https://aka.ms/awesome-copilot/install/prompt?url=vscode-insiders%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fplaywright-explore-website.prompt.md) | Prompt | Website exploration for testing using Playwright MCP |
---
-*This collection includes 11 curated items for testing & test automation.*
\ No newline at end of file
+*This collection includes 11 curated items for **Testing & Test Automation**.*
\ No newline at end of file
diff --git a/collections/typescript-mcp-development.md b/collections/typescript-mcp-development.md
index 6c0b2ea..3e1ab89 100644
--- a/collections/typescript-mcp-development.md
+++ b/collections/typescript-mcp-development.md
@@ -37,4 +37,4 @@ To get the best results, consider:
---
-*This collection includes 3 curated items for typescript mcp server development.*
\ No newline at end of file
+*This collection includes 3 curated items for **TypeScript MCP Server Development**.*
\ No newline at end of file
diff --git a/instructions/angular.instructions.md b/instructions/angular.instructions.md
index 379f725..12b7355 100644
--- a/instructions/angular.instructions.md
+++ b/instructions/angular.instructions.md
@@ -18,7 +18,7 @@ Instructions for generating high-quality Angular applications with TypeScript, u
### Architecture
- Use standalone components unless modules are explicitly required
-- Organize code by feature modules or domains for scalability
+- Organize code by standalone feature modules or domains for scalability
- Implement lazy loading for feature modules to optimize performance
- Use Angular's built-in dependency injection system effectively
- Structure components with a clear separation of concerns (smart vs. presentational components)
@@ -32,7 +32,7 @@ Instructions for generating high-quality Angular applications with TypeScript, u
### Component Design
- Follow Angular's component lifecycle hooks best practices
-- When using Angular >= 19, Use `input()` `output()`, `viewChild()`, `viewChildren()`, `contentChild()` and `viewChildren()` functions instead of decorators; otherwise use decorators
+- When using Angular >= 19, Use `input()` `output()`, `viewChild()`, `viewChildren()`, `contentChild()` and `contentChildren()` functions instead of decorators; otherwise use decorators
- Leverage Angular's change detection strategy (default or `OnPush` for performance)
- Keep templates clean and logic in component classes or services
- Use Angular directives and pipes for reusable functionality
@@ -78,7 +78,7 @@ Instructions for generating high-quality Angular applications with TypeScript, u
- Use Angular's `TestBed` for component testing with mocked dependencies
- Test signal-based state updates using Angular's testing utilities
- Write end-to-end tests with Cypress or Playwright (if specified)
-- Mock HTTP requests using `HttpClientTestingModule`
+- Mock HTTP requests using `provideHttpClientTesting`
- Ensure high test coverage for critical functionality
## Implementation Process
@@ -95,7 +95,7 @@ Instructions for generating high-quality Angular applications with TypeScript, u
11. Optimize performance and bundle size
## Additional Guidelines
-- Follow Angular's naming conventions (e.g., `feature.component.ts`, `feature.service.ts`)
+- Follow the Angular Style Guide for file naming conventions (see https://angular.dev/style-guide), e.g., use `feature.ts` for components and `feature-service.ts` for services. For legacy codebases, maintain consistency with existing pattern.
- Use Angular CLI commands for generating boilerplate code
- Document components and services with clear JSDoc comments
- Ensure accessibility compliance (WCAG 2.1) where applicable
diff --git a/instructions/java.instructions.md b/instructions/java.instructions.md
index 73da999..7a4258e 100644
--- a/instructions/java.instructions.md
+++ b/instructions/java.instructions.md
@@ -7,8 +7,24 @@ applyTo: '**/*.java'
## General Instructions
-- First, prompt the user if they want to integrate static analysis tools (SonarQube, PMD, Checkstyle)
- into their project setup. If yes, provide guidance on tool selection and configuration.
+- First, prompt the user if they want to integrate static analysis tools (SonarQube, PMD, Checkstyle) into their project setup.
+ - If yes, document a recommended static-analysis setup.
+ - Prefer SonarQube/SonarCloud (SonarLint in IDE + `sonar-scanner` in CI).
+ - Create a Sonar project key.
+ - Store the scanner token in CI secrets.
+ - Provide a sample CI job that runs the scanner.
+ - If the team declines Sonar, note this in the project README and continue.
+ - If Sonar is bound to the project:
+ - Use Sonar as the primary source of actionable issues.
+ - Reference Sonar rule keys in remediation guidance.
+ - If Sonar is unavailable:
+ - Perform up to 3 troubleshooting checks:
+ 1. Verify project binding and token.
+ 2. Ensure SonarScanner runs in CI.
+ 3. Confirm SonarLint is installed and configured.
+ - If still failing after 3 attempts:
+ - Enable SpotBugs, PMD, or Checkstyle as CI fallbacks.
+ - Open a short tracker issue documenting the blocker and next steps.
- If the user declines static analysis tools or wants to proceed without them, continue with implementing the Best practices, bug patterns and code smell prevention guidelines outlined below.
- Address code smells proactively during development rather than accumulating technical debt.
- Focus on readability, maintainability, and performance when refactoring identified issues.
@@ -33,28 +49,29 @@ applyTo: '**/*.java'
- Use nouns for classes (`UserService`) and verbs for methods (`getUserById`).
- Avoid abbreviations and Hungarian notation.
-### Bug Patterns
+### Common Bug Patterns
-| Rule ID | Description | Example / Notes |
-| ------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
-| `S2095` | Resources should be closed | Use try-with-resources when working with streams, files, sockets, etc. |
-| `S1698` | Objects should be compared with `.equals()` instead of `==` | Especially important for Strings and boxed primitives. |
-| `S1905` | Redundant casts should be removed | Clean up unnecessary or unsafe casts. |
-| `S3518` | Conditions should not always evaluate to true or false | Watch for infinite loops or if-conditions that never change. |
-| `S108` | Unreachable code should be removed | Code after `return`, `throw`, etc., must be cleaned up. |
+Below are concise, human-readable rules you can apply regardless of which static analysis tool you use. If you run Sonar/SonarLint, the IDE will show the matching rule and location — direct Sonar connections are preferred and should override this ruleset.
-## Code Smells
+- Resource management — Always close resources (files, sockets, streams). Use try-with-resources where possible so resources are closed automatically.
+- Equality checks — Compare object equality with `.equals()` or `Objects.equals(...)` rather than `==` for non-primitives; this avoids reference-equality bugs.
+- Redundant casts — Remove unnecessary casts; prefer correct generic typing and let the compiler infer types where possible.
+- Reachable conditions — Avoid conditional expressions that are always true or false; they indicate bugs or dead code and should be corrected.
-| Rule ID | Description | Example / Notes |
-| ------- | ------------------------------------------------------ | ----------------------------------------------------------------------------- |
-| `S107` | Methods should not have too many parameters | Refactor into helper classes or use builder pattern. |
-| `S121` | Duplicated blocks of code should be removed | Consolidate logic into shared methods. |
-| `S138` | Methods should not be too long | Break complex logic into smaller, testable units. |
-| `S3776` | Cognitive complexity should be reduced | Simplify nested logic, extract methods, avoid deep `if` trees. |
-| `S1192` | String literals should not be duplicated | Replace with constants or enums. |
-| `S1854` | Unused assignments should be removed | Avoid dead variables—remove or refactor. |
-| `S109` | Magic numbers should be replaced with constants | Improves readability and maintainability. |
-| `S1188` | Catch blocks should not be empty | Always log or handle exceptions meaningfully. |
+For contributors who *do* use Sonar or SonarLint: the IDE/scan will show the specific rule key (for example, S2095 for resource leaks) and the affected file/line. Use that information to navigate to the exact location, then apply the recommended remediation.
+
+### Common Code Smells
+
+These patterns are phrased for humans; they map cleanly to checks in Sonar, SpotBugs, PMD, or Checkstyle but do not require those tools to be useful.
+
+- Parameter count — Keep method parameter lists short. If a method needs many params, consider grouping into a value object or using the builder pattern.
+- Method size — Keep methods focused and small. Extract helper methods to improve readability and testability.
+- Cognitive complexity — Reduce nested conditionals and heavy branching by extracting methods, using polymorphism, or applying the Strategy pattern.
+- Duplicated literals — Extract repeated strings and numbers into named constants or enums to reduce errors and ease changes.
+- Dead code — Remove unused variables and assignments. They confuse readers and can hide bugs.
+- Magic numbers — Replace numeric literals with named constants that explain intent (e.g., MAX_RETRIES).
+
+If you run a static analyzer like Sonar or SonarLint — direct Sonar connections are preferred and should override this ruleset. Sonar rule keys are useful for automation and suppression, but they are not required in day-to-day developer guidance.
## Build and Verification
diff --git a/instructions/php-mcp-server.instructions.md b/instructions/php-mcp-server.instructions.md
new file mode 100644
index 0000000..685c0a6
--- /dev/null
+++ b/instructions/php-mcp-server.instructions.md
@@ -0,0 +1,809 @@
+---
+description: 'Best practices for building Model Context Protocol servers in PHP using the official PHP SDK with attribute-based discovery and multiple transport options'
+applyTo: '**/*.php'
+---
+
+# PHP MCP Server Development Best Practices
+
+This guide provides best practices for building Model Context Protocol (MCP) servers using the official PHP SDK maintained in collaboration with The PHP Foundation.
+
+## Installation and Setup
+
+### Install via Composer
+
+```bash
+composer require mcp/sdk
+```
+
+### Project Structure
+
+Organize your PHP MCP server project:
+
+```
+my-mcp-server/
+├── composer.json
+├── src/
+│ ├── Tools/
+│ │ ├── Calculator.php
+│ │ └── FileManager.php
+│ ├── Resources/
+│ │ ├── ConfigProvider.php
+│ │ └── DataProvider.php
+│ ├── Prompts/
+│ │ └── PromptGenerator.php
+│ └── Server.php
+├── server.php # Server entry point
+└── tests/
+ └── ToolsTest.php
+```
+
+### Composer Configuration
+
+```json
+{
+ "name": "your-org/mcp-server",
+ "description": "MCP Server for...",
+ "type": "project",
+ "require": {
+ "php": "^8.2",
+ "mcp/sdk": "^0.1"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^10.0"
+ },
+ "autoload": {
+ "psr-4": {
+ "App\\": "src/"
+ }
+ }
+}
+```
+
+## Server Implementation
+
+### Basic Server with Attribute Discovery
+
+Create your server entry point:
+
+```php
+#!/usr/bin/env php
+setServerInfo('My MCP Server', '1.0.0')
+ ->setDiscovery(__DIR__, ['.'])
+ ->build();
+
+$transport = new StdioTransport();
+
+$server->run($transport);
+```
+
+### Server with Caching
+
+Use PSR-16 cache for better performance:
+
+```php
+use Symfony\Component\Cache\Adapter\FilesystemAdapter;
+use Symfony\Component\Cache\Psr16Cache;
+
+$cache = new Psr16Cache(new FilesystemAdapter('mcp-discovery'));
+
+$server = Server::builder()
+ ->setServerInfo('My MCP Server', '1.0.0')
+ ->setDiscovery(
+ basePath: __DIR__,
+ scanDirs: ['.', 'src'],
+ excludeDirs: ['vendor', 'tests'],
+ cache: $cache
+ )
+ ->build();
+```
+
+### Manual Registration
+
+Register capabilities programmatically:
+
+```php
+use App\Tools\Calculator;
+use App\Resources\Config;
+
+$server = Server::builder()
+ ->setServerInfo('My MCP Server', '1.0.0')
+ ->addTool([Calculator::class, 'add'], 'add')
+ ->addTool([Calculator::class, 'multiply'], 'multiply')
+ ->addResource([Config::class, 'getSettings'], 'config://app/settings')
+ ->build();
+```
+
+## Tool Development
+
+### Simple Tool with Attribute
+
+```php
+ uniqid(),
+ 'email' => $email,
+ 'age' => $age,
+ 'firstName' => $firstName
+ ];
+ }
+}
+```
+
+### Tool with Complex Return Types
+
+```php
+use Mcp\Schema\Content\{TextContent, ImageContent};
+
+class ReportGenerator
+{
+ #[McpTool]
+ public function generateReport(string $type): array
+ {
+ return [
+ new TextContent('Report generated:'),
+ TextContent::code($this->generateCode($type), 'php'),
+ new TextContent('Summary: All checks passed.')
+ ];
+ }
+
+ #[McpTool]
+ public function getChart(string $chartType): ImageContent
+ {
+ $imageData = $this->generateChartImage($chartType);
+
+ return new ImageContent(
+ data: base64_encode($imageData),
+ mimeType: 'image/png'
+ );
+ }
+}
+```
+
+### Tool with Match Expression
+
+```php
+#[McpTool(name: 'calculate')]
+public function performCalculation(float $a, float $b, string $operation): float
+{
+ return match($operation) {
+ 'add' => $a + $b,
+ 'subtract' => $a - $b,
+ 'multiply' => $a * $b,
+ 'divide' => $b != 0 ? $a / $b :
+ throw new \InvalidArgumentException('Division by zero'),
+ default => throw new \InvalidArgumentException('Invalid operation')
+ };
+}
+```
+
+## Resource Implementation
+
+### Static Resource
+
+```php
+ '1.0.0',
+ 'debug' => false,
+ 'features' => ['auth', 'logging']
+ ];
+ }
+}
+```
+
+### Resource Template with Variables
+
+```php
+use Mcp\Capability\Attribute\McpResourceTemplate;
+
+class UserProvider
+{
+ /**
+ * Retrieves user profile information by ID and section.
+ */
+ #[McpResourceTemplate(
+ uriTemplate: 'user://{userId}/profile/{section}',
+ name: 'user_profile',
+ description: 'User profile data by section',
+ mimeType: 'application/json'
+ )]
+ public function getUserProfile(string $userId, string $section): array
+ {
+ // Variable order must match URI template order
+ return $this->users[$userId][$section] ??
+ throw new \InvalidArgumentException("Profile section not found");
+ }
+}
+```
+
+### Resource with File Content
+
+```php
+use Mcp\Schema\Content\{TextResourceContents, BlobResourceContents};
+
+class FileProvider
+{
+ #[McpResource(uri: 'file://readme.txt', mimeType: 'text/plain')]
+ public function getReadme(): TextResourceContents
+ {
+ return new TextResourceContents(
+ uri: 'file://readme.txt',
+ mimeType: 'text/plain',
+ text: file_get_contents(__DIR__ . '/README.txt')
+ );
+ }
+
+ #[McpResource(uri: 'file://image.png', mimeType: 'image/png')]
+ public function getImage(): BlobResourceContents
+ {
+ $imageData = file_get_contents(__DIR__ . '/image.png');
+
+ return new BlobResourceContents(
+ uri: 'file://image.png',
+ mimeType: 'image/png',
+ blob: base64_encode($imageData)
+ );
+ }
+}
+```
+
+## Prompt Implementation
+
+### Basic Prompt
+
+```php
+ 'assistant', 'content' => 'You are an expert code reviewer.'],
+ ['role' => 'user', 'content' => "Review this {$language} code focusing on {$focus}:\n\n```{$language}\n{$code}\n```"]
+ ];
+ }
+}
+```
+
+### Prompt with Mixed Content
+
+```php
+use Mcp\Schema\Content\{TextContent, ImageContent};
+use Mcp\Schema\PromptMessage;
+use Mcp\Schema\Enum\Role;
+
+#[McpPrompt]
+public function analyzeImage(string $imageUrl, string $question): array
+{
+ $imageData = file_get_contents($imageUrl);
+
+ return [
+ new PromptMessage(Role::Assistant, [
+ new TextContent('You are an image analysis expert.')
+ ]),
+ new PromptMessage(Role::User, [
+ new TextContent($question),
+ new ImageContent(
+ data: base64_encode($imageData),
+ mimeType: 'image/jpeg'
+ )
+ ])
+ ];
+}
+```
+
+## Completion Providers
+
+### Value List Completion
+
+```php
+use Mcp\Capability\Attribute\{McpPrompt, CompletionProvider};
+
+#[McpPrompt]
+public function generateContent(
+ #[CompletionProvider(values: ['blog', 'article', 'tutorial', 'guide'])]
+ string $contentType,
+
+ #[CompletionProvider(values: ['beginner', 'intermediate', 'advanced'])]
+ string $difficulty
+): array
+{
+ return [
+ ['role' => 'user', 'content' => "Create a {$difficulty} level {$contentType}"]
+ ];
+}
+```
+
+### Enum Completion
+
+```php
+enum Priority: string
+{
+ case LOW = 'low';
+ case MEDIUM = 'medium';
+ case HIGH = 'high';
+}
+
+enum Status
+{
+ case DRAFT;
+ case PUBLISHED;
+ case ARCHIVED;
+}
+
+#[McpResourceTemplate(uriTemplate: 'tasks/{taskId}')]
+public function getTask(
+ string $taskId,
+
+ #[CompletionProvider(enum: Priority::class)]
+ string $priority,
+
+ #[CompletionProvider(enum: Status::class)]
+ string $status
+): array
+{
+ return $this->tasks[$taskId] ?? [];
+}
+```
+
+### Custom Completion Provider
+
+```php
+use Mcp\Capability\Prompt\Completion\ProviderInterface;
+
+class UserIdCompletionProvider implements ProviderInterface
+{
+ public function __construct(
+ private DatabaseService $db
+ ) {}
+
+ public function getCompletions(string $currentValue): array
+ {
+ return $this->db->searchUserIds($currentValue);
+ }
+}
+
+#[McpResourceTemplate(uriTemplate: 'user://{userId}/profile')]
+public function getUserProfile(
+ #[CompletionProvider(provider: UserIdCompletionProvider::class)]
+ string $userId
+): array
+{
+ return $this->users[$userId] ??
+ throw new \InvalidArgumentException('User not found');
+}
+```
+
+## Transport Options
+
+### Stdio Transport
+
+For command-line integration (default):
+
+```php
+use Mcp\Server\Transport\StdioTransport;
+
+$transport = new StdioTransport();
+$server->run($transport);
+```
+
+### HTTP Transport
+
+For web-based integration:
+
+```php
+use Mcp\Server\Transport\StreamableHttpTransport;
+use Nyholm\Psr7\Factory\Psr17Factory;
+
+$psr17Factory = new Psr17Factory();
+
+$request = $psr17Factory->createServerRequestFromGlobals();
+
+$transport = new StreamableHttpTransport(
+ $request,
+ $psr17Factory, // Response factory
+ $psr17Factory // Stream factory
+);
+
+$response = $server->run($transport);
+
+// Send response in your web framework
+foreach ($response->getHeaders() as $name => $values) {
+ foreach ($values as $value) {
+ header("$name: $value", false);
+ }
+}
+
+http_response_code($response->getStatusCode());
+echo $response->getBody();
+```
+
+## Session Management
+
+### In-Memory Sessions (Default)
+
+```php
+$server = Server::builder()
+ ->setServerInfo('My Server', '1.0.0')
+ ->setSession(ttl: 7200) // 2 hours
+ ->build();
+```
+
+### File-Based Sessions
+
+```php
+use Mcp\Server\Session\FileSessionStore;
+
+$server = Server::builder()
+ ->setServerInfo('My Server', '1.0.0')
+ ->setSession(new FileSessionStore(__DIR__ . '/sessions'))
+ ->build();
+```
+
+### Custom Session Store
+
+```php
+use Mcp\Server\Session\InMemorySessionStore;
+
+$server = Server::builder()
+ ->setServerInfo('My Server', '1.0.0')
+ ->setSession(new InMemorySessionStore(3600))
+ ->build();
+```
+
+## Error Handling
+
+### Exception Handling in Tools
+
+```php
+#[McpTool]
+public function divideNumbers(float $a, float $b): float
+{
+ if ($b === 0.0) {
+ throw new \InvalidArgumentException('Division by zero is not allowed');
+ }
+
+ return $a / $b;
+}
+
+#[McpTool]
+public function processFile(string $filename): string
+{
+ if (!file_exists($filename)) {
+ throw new \InvalidArgumentException("File not found: {$filename}");
+ }
+
+ if (!is_readable($filename)) {
+ throw new \RuntimeException("File not readable: {$filename}");
+ }
+
+ return file_get_contents($filename);
+}
+```
+
+### Custom Error Responses
+
+The SDK automatically converts exceptions into JSON-RPC error responses that MCP clients understand.
+
+## Testing
+
+### PHPUnit Tests for Tools
+
+```php
+calculator = new Calculator();
+ }
+
+ public function testAdd(): void
+ {
+ $result = $this->calculator->add(5, 3);
+ $this->assertSame(8, $result);
+ }
+
+ public function testDivideByZero(): void
+ {
+ $this->expectException(\InvalidArgumentException::class);
+ $this->expectExceptionMessage('Division by zero');
+
+ $this->calculator->divide(10, 0);
+ }
+}
+```
+
+### Testing Server Discovery
+
+```php
+public function testServerDiscoversTools(): void
+{
+ $server = Server::builder()
+ ->setServerInfo('Test Server', '1.0.0')
+ ->setDiscovery(__DIR__ . '/../src', ['.'])
+ ->build();
+
+ $capabilities = $server->getCapabilities();
+
+ $this->assertArrayHasKey('tools', $capabilities);
+ $this->assertNotEmpty($capabilities['tools']);
+}
+```
+
+## Performance Best Practices
+
+### Use Discovery Caching
+
+Always use caching in production:
+
+```php
+use Symfony\Component\Cache\Adapter\RedisAdapter;
+use Symfony\Component\Cache\Psr16Cache;
+
+$redis = new \Redis();
+$redis->connect('127.0.0.1', 6379);
+
+$cache = new Psr16Cache(new RedisAdapter($redis));
+
+$server = Server::builder()
+ ->setServerInfo('My Server', '1.0.0')
+ ->setDiscovery(
+ basePath: __DIR__,
+ scanDirs: ['src'],
+ excludeDirs: ['vendor', 'tests', 'var'],
+ cache: $cache
+ )
+ ->build();
+```
+
+### Optimize Scan Directories
+
+Only scan necessary directories:
+
+```php
+$server = Server::builder()
+ ->setDiscovery(
+ basePath: __DIR__,
+ scanDirs: ['src/Tools', 'src/Resources'], // Specific dirs
+ excludeDirs: ['vendor', 'tests', 'var', 'cache']
+ )
+ ->build();
+```
+
+### Use OPcache
+
+Enable OPcache in production for better PHP performance:
+
+```ini
+; php.ini
+opcache.enable=1
+opcache.memory_consumption=256
+opcache.interned_strings_buffer=16
+opcache.max_accelerated_files=10000
+opcache.validate_timestamps=0
+```
+
+## Framework Integration
+
+### Laravel Integration
+
+```php
+// app/Console/Commands/McpServer.php
+namespace App\Console\Commands;
+
+use Illuminate\Console\Command;
+use Mcp\Server;
+use Mcp\Server\Transport\StdioTransport;
+
+class McpServer extends Command
+{
+ protected $signature = 'mcp:serve';
+ protected $description = 'Start MCP server';
+
+ public function handle()
+ {
+ $server = Server::builder()
+ ->setServerInfo('Laravel MCP Server', '1.0.0')
+ ->setDiscovery(app_path(), ['Tools', 'Resources'])
+ ->build();
+
+ $transport = new StdioTransport();
+ $server->run($transport);
+ }
+}
+```
+
+### Symfony Integration
+
+```php
+// Use symfony/mcp-bundle for native integration
+composer require symfony/mcp-bundle
+```
+
+## Deployment
+
+### Docker Deployment
+
+```dockerfile
+FROM php:8.2-cli
+
+# Install extensions
+RUN docker-php-ext-install pdo pdo_mysql
+
+# Install Composer
+COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
+
+# Set working directory
+WORKDIR /app
+
+# Copy application
+COPY . /app
+
+# Install dependencies
+RUN composer install --no-dev --optimize-autoloader
+
+# Make server executable
+RUN chmod +x /app/server.php
+
+CMD ["php", "/app/server.php"]
+```
+
+### Systemd Service
+
+```ini
+[Unit]
+Description=MCP PHP Server
+After=network.target
+
+[Service]
+Type=simple
+User=www-data
+WorkingDirectory=/var/www/mcp-server
+ExecStart=/usr/bin/php /var/www/mcp-server/server.php
+Restart=always
+
+[Install]
+WantedBy=multi-user.target
+```
+
+## Configuration for MCP Clients
+
+### Claude Desktop Configuration
+
+```json
+{
+ "mcpServers": {
+ "php-server": {
+ "command": "php",
+ "args": ["/absolute/path/to/server.php"]
+ }
+ }
+}
+```
+
+### MCP Inspector Testing
+
+```bash
+npx @modelcontextprotocol/inspector php /path/to/server.php
+```
+
+## Additional Resources
+
+- [Official PHP SDK Repository](https://github.com/modelcontextprotocol/php-sdk)
+- [MCP Elements Documentation](https://github.com/modelcontextprotocol/php-sdk/blob/main/docs/mcp-elements.md)
+- [Server Builder Documentation](https://github.com/modelcontextprotocol/php-sdk/blob/main/docs/server-builder.md)
+- [Transport Documentation](https://github.com/modelcontextprotocol/php-sdk/blob/main/docs/transports.md)
+- [Examples](https://github.com/modelcontextprotocol/php-sdk/blob/main/docs/examples.md)
+- [MCP Specification](https://spec.modelcontextprotocol.io/)
+- [Model Context Protocol](https://modelcontextprotocol.io/)
diff --git a/prompts/java-refactoring-remove-parameter.prompt.md b/prompts/java-refactoring-remove-parameter.prompt.md
new file mode 100644
index 0000000..7cf6d53
--- /dev/null
+++ b/prompts/java-refactoring-remove-parameter.prompt.md
@@ -0,0 +1,85 @@
+---
+title: 'Refactoring Java Methods with Remove Parameter'
+mode: 'agent'
+description: 'Refactoring using Remove Parameter in Java Language'
+---
+
+# Refactoring Java Methods with Remove Parameter
+
+## Role
+
+You are an expert in refactoring Java methods.
+
+Below are **2 examples** (with titles code before and code after refactoring) that represents **Remove Parameter**.
+
+## Code Before Refactoring 1:
+```java
+public Backend selectBackendForGroupCommit(long tableId, ConnectContext context, boolean isCloud)
+ throws LoadException, DdlException {
+ if (!Env.getCurrentEnv().isMaster()) {
+ try {
+ long backendId = new MasterOpExecutor(context)
+ .getGroupCommitLoadBeId(tableId, context.getCloudCluster(), isCloud);
+ return Env.getCurrentSystemInfo().getBackend(backendId);
+ } catch (Exception e) {
+ throw new LoadException(e.getMessage());
+ }
+ } else {
+ return Env.getCurrentSystemInfo()
+ .getBackend(selectBackendForGroupCommitInternal(tableId, context.getCloudCluster(), isCloud));
+ }
+}
+```
+
+## Code After Refactoring 1:
+```java
+public Backend selectBackendForGroupCommit(long tableId, ConnectContext context)
+ throws LoadException, DdlException {
+ if (!Env.getCurrentEnv().isMaster()) {
+ try {
+ long backendId = new MasterOpExecutor(context)
+ .getGroupCommitLoadBeId(tableId, context.getCloudCluster());
+ return Env.getCurrentSystemInfo().getBackend(backendId);
+ } catch (Exception e) {
+ throw new LoadException(e.getMessage());
+ }
+ } else {
+ return Env.getCurrentSystemInfo()
+ .getBackend(selectBackendForGroupCommitInternal(tableId, context.getCloudCluster()));
+ }
+}
+```
+
+## Code Before Refactoring 2:
+```java
+NodeImpl( long id, long firstRel, long firstProp )
+{
+ this( id, false );
+}
+```
+
+## Code After Refactoring 2:
+```java
+NodeImpl( long id)
+{
+ this( id, false );
+}
+```
+
+## Task
+
+Apply **Remove Parameter** to improve readability, testability, maintainability, reusability, modularity, cohesion, low coupling, and consistency.
+
+Always return a complete and compilable method (Java 17).
+
+Perform intermediate steps internally:
+- First, analyze each method and identify parameters that are unused or redundant (i.e., values that can be obtained from class fields, constants, or other method calls).
+- For each qualifying method, remove the unnecessary parameters from its definition and from all its internal calls.
+- Ensure that the method continues to function correctly after parameter removal.
+- Output only the refactored code inside a single ```java``` block.
+- Do not remove any functionality from the original method.
+- Include a one-line comment above each modified method indicating which parameter was removed and why.
+
+## Code to be Refactored:
+
+Now, assess all methods with unused parameters and refactor them using **Remove Parameter**
\ No newline at end of file
diff --git a/prompts/php-mcp-server-generator.prompt.md b/prompts/php-mcp-server-generator.prompt.md
new file mode 100644
index 0000000..29bcbc7
--- /dev/null
+++ b/prompts/php-mcp-server-generator.prompt.md
@@ -0,0 +1,522 @@
+---
+description: 'Generate a complete PHP Model Context Protocol server project with tools, resources, prompts, and tests using the official PHP SDK'
+mode: agent
+---
+
+# PHP MCP Server Generator
+
+You are a PHP MCP server generator. Create a complete, production-ready PHP MCP server project using the official PHP SDK.
+
+## Project Requirements
+
+Ask the user for:
+1. **Project name** (e.g., "my-mcp-server")
+2. **Server description** (e.g., "A file management MCP server")
+3. **Transport type** (stdio, http, or both)
+4. **Tools to include** (e.g., "file read", "file write", "list directory")
+5. **Whether to include resources and prompts**
+6. **PHP version** (8.2+ required)
+
+## Project Structure
+
+```
+{project-name}/
+├── composer.json
+├── .gitignore
+├── README.md
+├── server.php
+├── src/
+│ ├── Tools/
+│ │ └── {ToolClass}.php
+│ ├── Resources/
+│ │ └── {ResourceClass}.php
+│ ├── Prompts/
+│ │ └── {PromptClass}.php
+│ └── Providers/
+│ └── {CompletionProvider}.php
+└── tests/
+ └── ToolsTest.php
+```
+
+## File Templates
+
+### composer.json
+
+```json
+{
+ "name": "your-org/{project-name}",
+ "description": "{Server description}",
+ "type": "project",
+ "require": {
+ "php": "^8.2",
+ "mcp/sdk": "^0.1"
+ },
+ "require-dev": {
+ "phpunit/phpunit": "^10.0",
+ "symfony/cache": "^6.4"
+ },
+ "autoload": {
+ "psr-4": {
+ "App\\\\": "src/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "Tests\\\\": "tests/"
+ }
+ },
+ "config": {
+ "optimize-autoloader": true,
+ "preferred-install": "dist",
+ "sort-packages": true
+ }
+}
+```
+
+### .gitignore
+
+```
+/vendor
+/cache
+composer.lock
+.phpunit.cache
+phpstan.neon
+```
+
+### README.md
+
+```markdown
+# {Project Name}
+
+{Server description}
+
+## Requirements
+
+- PHP 8.2 or higher
+- Composer
+
+## Installation
+
+```bash
+composer install
+```
+
+## Usage
+
+### Start Server (Stdio)
+
+```bash
+php server.php
+```
+
+### Configure in Claude Desktop
+
+```json
+{
+ "mcpServers": {
+ "{project-name}": {
+ "command": "php",
+ "args": ["/absolute/path/to/server.php"]
+ }
+ }
+}
+```
+
+## Testing
+
+```bash
+vendor/bin/phpunit
+```
+
+## Tools
+
+- **{tool_name}**: {Tool description}
+
+## Development
+
+Test with MCP Inspector:
+
+```bash
+npx @modelcontextprotocol/inspector php server.php
+```
+```
+
+### server.php
+
+```php
+#!/usr/bin/env php
+setServerInfo('{Project Name}', '1.0.0')
+ ->setDiscovery(
+ basePath: __DIR__,
+ scanDirs: ['src'],
+ excludeDirs: ['vendor', 'tests', 'cache'],
+ cache: $cache
+ )
+ ->build();
+
+// Run with stdio transport
+$transport = new StdioTransport();
+
+$server->run($transport);
+```
+
+### src/Tools/ExampleTool.php
+
+```php
+ $a + $b,
+ 'subtract' => $a - $b,
+ 'multiply' => $a * $b,
+ 'divide' => $b != 0 ? $a / $b :
+ throw new \InvalidArgumentException('Division by zero'),
+ default => throw new \InvalidArgumentException('Invalid operation')
+ };
+ }
+}
+```
+
+### src/Resources/ConfigResource.php
+
+```php
+ '1.0.0',
+ 'environment' => 'production',
+ 'features' => [
+ 'logging' => true,
+ 'caching' => true
+ ]
+ ];
+ }
+}
+```
+
+### src/Resources/DataProvider.php
+
+```php
+ $category,
+ 'id' => $id,
+ 'data' => "Sample data for {$category}/{$id}"
+ ];
+ }
+}
+```
+
+### src/Prompts/PromptGenerator.php
+
+```php
+ 'assistant',
+ 'content' => 'You are an expert code reviewer specializing in best practices and optimization.'
+ ],
+ [
+ 'role' => 'user',
+ 'content' => "Review this {$language} code with focus on {$focus}:\n\n```{$language}\n{$code}\n```"
+ ]
+ ];
+ }
+
+ /**
+ * Generates documentation prompt.
+ */
+ #[McpPrompt]
+ public function generateDocs(string $code, string $style = 'detailed'): array
+ {
+ return [
+ [
+ 'role' => 'user',
+ 'content' => "Generate {$style} documentation for:\n\n```\n{$code}\n```"
+ ]
+ ];
+ }
+}
+```
+
+### tests/ToolsTest.php
+
+```php
+tool = new ExampleTool();
+ }
+
+ public function testGreet(): void
+ {
+ $result = $this->tool->greet('World');
+ $this->assertSame('Hello, World!', $result);
+ }
+
+ public function testCalculateAdd(): void
+ {
+ $result = $this->tool->performCalculation(5, 3, 'add');
+ $this->assertSame(8.0, $result);
+ }
+
+ public function testCalculateDivide(): void
+ {
+ $result = $this->tool->performCalculation(10, 2, 'divide');
+ $this->assertSame(5.0, $result);
+ }
+
+ public function testCalculateDivideByZero(): void
+ {
+ $this->expectException(\InvalidArgumentException::class);
+ $this->expectExceptionMessage('Division by zero');
+
+ $this->tool->performCalculation(10, 0, 'divide');
+ }
+
+ public function testCalculateInvalidOperation(): void
+ {
+ $this->expectException(\InvalidArgumentException::class);
+ $this->expectExceptionMessage('Invalid operation');
+
+ $this->tool->performCalculation(5, 3, 'modulo');
+ }
+}
+```
+
+### phpunit.xml.dist
+
+```xml
+
+
+
+
+ tests
+
+
+
+
+ src
+
+
+
+```
+
+## Implementation Guidelines
+
+1. **Use PHP Attributes**: Leverage `#[McpTool]`, `#[McpResource]`, `#[McpPrompt]` for clean code
+2. **Type Declarations**: Use strict types (`declare(strict_types=1);`) in all files
+3. **PSR-12 Coding Standard**: Follow PHP-FIG standards
+4. **Schema Validation**: Use `#[Schema]` attributes for parameter validation
+5. **Error Handling**: Throw specific exceptions with clear messages
+6. **Testing**: Write PHPUnit tests for all tools
+7. **Documentation**: Use PHPDoc blocks for all methods
+8. **Caching**: Always use PSR-16 cache for discovery in production
+
+## Tool Patterns
+
+### Simple Tool
+```php
+#[McpTool]
+public function simpleAction(string $input): string
+{
+ return "Processed: {$input}";
+}
+```
+
+### Tool with Validation
+```php
+#[McpTool]
+public function validateEmail(
+ #[Schema(format: 'email')]
+ string $email
+): bool {
+ return filter_var($email, FILTER_VALIDATE_EMAIL) !== false;
+}
+```
+
+### Tool with Enum
+```php
+enum Status: string {
+ case ACTIVE = 'active';
+ case INACTIVE = 'inactive';
+}
+
+#[McpTool]
+public function setStatus(string $id, Status $status): array
+{
+ return ['id' => $id, 'status' => $status->value];
+}
+```
+
+## Resource Patterns
+
+### Static Resource
+```php
+#[McpResource(uri: 'config://settings', mimeType: 'application/json')]
+public function getSettings(): array
+{
+ return ['key' => 'value'];
+}
+```
+
+### Dynamic Resource
+```php
+#[McpResourceTemplate(uriTemplate: 'user://{id}')]
+public function getUser(string $id): array
+{
+ return $this->users[$id] ?? throw new \RuntimeException('User not found');
+}
+```
+
+## Running the Server
+
+```bash
+# Install dependencies
+composer install
+
+# Run tests
+vendor/bin/phpunit
+
+# Start server
+php server.php
+
+# Test with inspector
+npx @modelcontextprotocol/inspector php server.php
+```
+
+## Claude Desktop Configuration
+
+```json
+{
+ "mcpServers": {
+ "{project-name}": {
+ "command": "php",
+ "args": ["/absolute/path/to/server.php"]
+ }
+ }
+}
+```
+
+Now generate the complete project based on user requirements!
diff --git a/update-readme.js b/update-readme.js
index d6ce2da..0668d7c 100755
--- a/update-readme.js
+++ b/update-readme.js
@@ -639,9 +639,7 @@ function generateCollectionReadme(collection, collectionId) {
// Optional badge note at the end if show_badge is true
if (collection.display?.show_badge) {
- content += `*This collection includes ${
- items.length
- } curated items for ${name.toLowerCase()}.*`;
+ content += `*This collection includes ${items.length} curated items for **${name}**.*`;
}
return content;