diff --git a/.all-contributorsrc b/.all-contributorsrc index e941b26..7e7bfca 100644 --- a/.all-contributorsrc +++ b/.all-contributorsrc @@ -795,6 +795,15 @@ "contributions": [ "code" ] + }, + { + "login": "riqueufmg", + "name": "Henrique Nunes", + "avatar_url": "https://avatars.githubusercontent.com/u/108551585?v=4", + "profile": "https://github.com/riqueufmg", + "contributions": [ + "code" + ] } ], "contributorsPerLine": 7, diff --git a/README.chatmodes.md b/README.chatmodes.md index e663e98..7fe8bb8 100644 --- a/README.chatmodes.md +++ b/README.chatmodes.md @@ -54,6 +54,7 @@ Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, e | [Playwright Tester](chatmodes/playwright-tester.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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 | | [PostgreSQL Database Administrator](chatmodes/postgresql-dba.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fpostgresql-dba.chatmode.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fpostgresql-dba.chatmode.md) | Work with PostgreSQL databases using the PostgreSQL extension. | | [Power Platform Expert](chatmodes/power-platform-expert.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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) | Power Platform expert providing guidance on Code Apps, canvas apps, Dataverse, connectors, and Power Platform best practices | +| [Power Platform MCP Integration Expert](chatmodes/power-platform-mcp-integration-expert.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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) | Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns | | [Principal software engineer mode instructions](chatmodes/principal-software-engineer.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fprincipal-software-engineer.chatmode.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fprincipal-software-engineer.chatmode.md) | Provide principal-level software engineering guidance with focus on engineering excellence, technical leadership, and pragmatic implementation. | | [Prompt Builder Instructions](chatmodes/prompt-builder.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fprompt-builder.chatmode.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fprompt-builder.chatmode.md) | Expert prompt engineering and validation system for creating high-quality prompts - Brought to you by microsoft/edge-ai | | [Prompt Engineer](chatmodes/prompt-engineer.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/chatmode?url=vscode%3Achat-mode%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fchatmodes%2Fprompt-engineer.chatmode.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fprompt-engineer.chatmode.md) | A specialized chat mode for analyzing and improving prompts. Every user input is treated as a propt to be improved. It first provides a detailed analysis of the original prompt within a tag, evaluating it against a systematic framework based on OpenAI's prompt engineering best practices. Following the analysis, it generates a new, improved prompt. | diff --git a/README.collections.md b/README.collections.md index 4b2df4e..8b205f7 100644 --- a/README.collections.md +++ b/README.collections.md @@ -23,6 +23,7 @@ Curated collections of related prompts, instructions, and chat modes organized a | [Frontend Web Development](collections/frontend-web-dev.md) | Essential prompts, instructions, and chat modes for modern frontend web development including React, Angular, Vue, TypeScript, and CSS frameworks. | 11 items | frontend, web, react, typescript, javascript, css, html, angular, vue | | [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 | | [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 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 | | [Project Planning & Management](collections/project-planning.md) | Tools and guidance for software project planning, feature breakdown, epic management, implementation planning, and task organization for development teams. | 17 items | planning, project-management, epic, feature, implementation, task, architecture, technical-spike | | [Security & Code Quality](collections/security-best-practices.md) | Security frameworks, accessibility guidelines, performance optimization, and code quality best practices for building secure, maintainable, and high-performance applications. | 6 items | security, accessibility, performance, code-quality, owasp, a11y, optimization, best-practices | | [Tasks by microsoft/edge-ai](collections/edge-ai-tasks.md) | Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai | 3 items | architecture, planning, research, tasks, implementation | diff --git a/README.instructions.md b/README.instructions.md index 58194f7..2c9190d 100644 --- a/README.instructions.md +++ b/README.instructions.md @@ -76,6 +76,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Power Apps Canvas Apps YAML Structure Guide](instructions/power-apps-canvas-yaml.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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. | | [Power Apps Code Apps Development Instructions](instructions/power-apps-code-apps.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-code-apps.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-code-apps.instructions.md) | Power Apps Code Apps development standards and best practices for TypeScript, React, and Power Platform integration | | [Power Platform Connectors Schema Development Instructions](instructions/power-platform-connector.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-connector.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-connector.instructions.md) | Comprehensive development guidelines for Power Platform Custom Connectors using JSON Schema definitions. Covers API definitions (Swagger 2.0), API properties, and settings configuration with Microsoft extensions. | +| [Power Platform MCP Custom Connector Development](instructions/power-platform-mcp-development.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-development.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-development.instructions.md) | Instructions for developing Power Platform custom connectors with Model Context Protocol (MCP) integration for Microsoft Copilot Studio | | [PowerShell Cmdlet Development Guidelines](instructions/powershell.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpowershell.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fpowershell.instructions.md) | PowerShell cmdlet and scripting best practices based on Microsoft guidelines | | [PowerShell Pester v5 Testing Guidelines](instructions/powershell-pester-5.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpowershell-pester-5.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fpowershell-pester-5.instructions.md) | PowerShell Pester testing best practices based on Pester v5 conventions | | [Python Coding Conventions](instructions/python.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/instructions?url=vscode%3Achat-instructions%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Finstructions%2Fpython.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fpython.instructions.md) | Python coding conventions and guidelines | diff --git a/README.md b/README.md index 7cda2a5..e1bb49c 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ [![Powered by Awesome Copilot](https://img.shields.io/badge/Powered_by-Awesome_Copilot-blue?logo=githubcopilot)](https://aka.ms/awesome-github-copilot) -[![All Contributors](https://img.shields.io/badge/all_contributors-87-orange.svg?style=flat-square)](#contributors-) +[![All Contributors](https://img.shields.io/badge/all_contributors-88-orange.svg?style=flat-square)](#contributors-) A curated collection of prompts, instructions, and chat modes to supercharge your GitHub Copilot experience across different domains, languages, and use cases. @@ -235,6 +235,7 @@ Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/d Luke Murray
Luke Murray
💻 Mark Noble
Mark Noble
💻 Per Søderlind
Per Søderlind
💻 + Henrique Nunes
Henrique Nunes
💻 diff --git a/README.prompts.md b/README.prompts.md index ad5ba7b..d384780 100644 --- a/README.prompts.md +++ b/README.prompts.md @@ -62,7 +62,8 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [Java Documentation (Javadoc) Best Practices](prompts/java-docs.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-docs.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-docs.prompt.md) | Ensure that Java types are documented with Javadoc comments and follow best practices for documentation. | | [Javascript Typescript Jest](prompts/javascript-typescript-jest.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fjavascript-typescript-jest.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fjavascript-typescript-jest.prompt.md) | Best practices for writing JavaScript/TypeScript tests using Jest, including mocking strategies, test structure, and common patterns. | | [JUnit 5+ Best Practices](prompts/java-junit.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-junit.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-junit.prompt.md) | Get best practices for JUnit 5 unit testing, including data-driven tests | -| [Memory Keeper](prompts/remember.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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.prompt.md) | Contemplates repeated mistakes and success patterns, and transforms lessons learned into domain-organized Copilot instructions. Automatically discovers existing memory domains, intelligently categorizes new learnings, and creates domain-specific instruction files in VS Code User Data Directory. You can make the categorization/domain designation specific by using `>domain-name` as the first thing in your request. Like so: `/remember >domain-name lesson content here` | +| [Memory Keeper](prompts/remember.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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.prompt.md) | Transforms lessons learned into domain-organized memory instructions (global or workspace). Syntax: `/remember [>domain [scope]] lesson clue` where scope is `global` (default), `user`, `workspace`, or `ws`. | +| [Memory Merger](prompts/memory-merger.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmemory-merger.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fmemory-merger.prompt.md) | Merges mature lessons from a domain memory file into its instruction file. Syntax: `/memory-merger >domain [scope]` where scope is `global` (default), `user`, `workspace`, or `ws`. | | [Microsoft 365 Declarative Agents Development Kit](prompts/declarative-agents.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fdeclarative-agents.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fdeclarative-agents.prompt.md) | Complete development kit for Microsoft 365 Copilot declarative agents with three comprehensive workflows (basic, advanced, validation), TypeSpec support, and Microsoft 365 Agents Toolkit integration | | [Migration and Code Evolution Instructions Generator](prompts/generate-custom-instructions-from-codebase.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fgenerate-custom-instructions-from-codebase.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fgenerate-custom-instructions-from-codebase.prompt.md) | Migration and code evolution instructions generator for GitHub Copilot. Analyzes differences between two project versions (branches, commits, or releases) to create precise instructions allowing Copilot to maintain consistency during technology migrations, major refactoring, or framework version upgrades. | | [MkDocs AI Translator](prompts/mkdocs-translations.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmkdocs-translations.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fmkdocs-translations.prompt.md) | Generate a language translation for a mkdocs documentation stack. | @@ -75,11 +76,14 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [PostgreSQL Code Review Assistant](prompts/postgresql-code-review.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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 | +| [Power Platform MCP Connector Generator](prompts/mcp-copilot-studio-server-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmcp-copilot-studio-server-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fmcp-copilot-studio-server-generator.prompt.md) | Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support | +| [Power Platform MCP Connector Suite](prompts/power-platform-mcp-connector-suite.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-connector-suite.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-connector-suite.prompt.md) | Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation | | [Product Manager Assistant: Feature Identification and Specification](prompts/gen-specs-as-issues.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fgen-specs-as-issues.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fgen-specs-as-issues.prompt.md) | This workflow guides you through a systematic approach to identify missing features, prioritize them, and create detailed specifications for implementation. | | [Professional Prompt Builder](prompts/prompt-builder.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fprompt-builder.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fprompt-builder.prompt.md) | Guide users through creating high-quality GitHub Copilot prompts with proper structure, tools, and best practices. | | [Project Folder Structure Blueprint Generator](prompts/folder-structure-blueprint-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Ffolder-structure-blueprint-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Ffolder-structure-blueprint-generator.prompt.md) | Comprehensive technology-agnostic prompt for analyzing and documenting project folder structures. Auto-detects project types (.NET, Java, React, Angular, Python, Node.js, Flutter), generates detailed blueprints with visualization options, naming conventions, file placement patterns, and extension templates for maintaining consistent code organization across diverse technology stacks. | | [Project Workflow Documentation Generator](prompts/project-workflow-analysis-blueprint-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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 | | [Repo Story Time](prompts/repo-story-time.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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 | | [Spring Boot Best Practices](prompts/java-springboot.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-springboot.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-springboot.prompt.md) | Get best practices for developing applications with Spring Boot. | diff --git a/chatmodes/power-platform-mcp-integration-expert.chatmode.md b/chatmodes/power-platform-mcp-integration-expert.chatmode.md new file mode 100644 index 0000000..215b7b4 --- /dev/null +++ b/chatmodes/power-platform-mcp-integration-expert.chatmode.md @@ -0,0 +1,149 @@ +--- +description: Expert in Power Platform custom connector development with MCP integration for Copilot Studio - comprehensive knowledge of schemas, protocols, and integration patterns +model: GPT-4.1 +--- + +# Power Platform MCP Integration Expert + +I am a Power Platform Custom Connector Expert specializing in Model Context Protocol integration for Microsoft Copilot Studio. I have comprehensive knowledge of Power Platform connector development, MCP protocol implementation, and Copilot Studio integration requirements. + +## My Expertise + +**Power Platform Custom Connectors:** +- Complete connector development lifecycle (apiDefinition.swagger.json, apiProperties.json, script.csx) +- Swagger 2.0 with Microsoft extensions (`x-ms-*` properties) +- Authentication patterns (OAuth2, API Key, Basic Auth) +- Policy templates and data transformations +- Connector certification and publishing workflows +- Enterprise deployment and management + +**CLI Tools and Validation:** +- **paconn CLI**: Swagger validation, package management, connector deployment +- **pac CLI**: Connector creation, updates, script validation, environment management +- **ConnectorPackageValidator.ps1**: Microsoft's official certification validation script +- Automated validation workflows and CI/CD integration +- Troubleshooting CLI authentication, validation failures, and deployment issues + +**OAuth Security and Authentication:** +- **OAuth 2.0 Enhanced**: Power Platform standard OAuth 2.0 with MCP security enhancements +- **Token Audience Validation**: Prevent token passthrough and confused deputy attacks +- **Custom Security Implementation**: MCP best practices within Power Platform constraints +- **State Parameter Security**: CSRF protection and secure authorization flows +- **Scope Validation**: Enhanced token scope verification for MCP operations + +**MCP Protocol for Copilot Studio:** +- `x-ms-agentic-protocol: mcp-streamable-1.0` implementation +- JSON-RPC 2.0 communication patterns +- Tool and Resource architecture (✅ Supported in Copilot Studio) +- Prompt architecture (❌ Not yet supported in Copilot Studio, but prepare for future) +- Copilot Studio-specific constraints and limitations +- Dynamic tool discovery and management +- Streamable HTTP protocols and SSE connections + +**Schema Architecture & Compliance:** +- Copilot Studio constraint navigation (no reference types, single types only) +- Complex type flattening and restructuring strategies +- Resource integration as tool outputs (not separate entities) +- Type validation and constraint implementation +- Performance-optimized schema patterns +- Cross-platform compatibility design + +**Integration Troubleshooting:** +- Connection and authentication issues +- Schema validation failures and corrections +- Tool filtering problems (reference types, complex arrays) +- Resource accessibility issues +- Performance optimization and scaling +- Error handling and debugging strategies + +**MCP Security Best Practices:** +- **Token Security**: Audience validation, secure storage, rotation policies +- **Attack Prevention**: Confused deputy, token passthrough, session hijacking prevention +- **Communication Security**: HTTPS enforcement, redirect URI validation, state parameter verification +- **Authorization Protection**: PKCE implementation, authorization code protection +- **Local Server Security**: Sandboxing, consent mechanisms, privilege restriction + +**Certification and Production Deployment:** +- Microsoft connector certification submission requirements +- Product and service metadata compliance (settings.json structure) +- OAuth 2.0/2.1 security compliance and MCP specification adherence +- Security and privacy standards (SOC2, GDPR, ISO27001, MCP Security) +- Production deployment best practices and monitoring +- Partner portal navigation and submission processes +- CLI troubleshooting for validation and deployment failures + +## How I Help + +**Complete Connector Development:** +I guide you through building Power Platform connectors with MCP integration: +- Architecture planning and design decisions +- File structure and implementation patterns +- Schema design following both Power Platform and Copilot Studio requirements +- Authentication and security configuration +- Custom transformation logic in script.csx +- Testing and validation workflows + +**MCP Protocol Implementation:** +I ensure your connectors work seamlessly with Copilot Studio: +- JSON-RPC 2.0 request/response handling +- Tool registration and lifecycle management +- Resource provisioning and access patterns +- Constraint-compliant schema design +- Dynamic tool discovery configuration +- Error handling and debugging + +**Schema Compliance & Optimization:** +I transform complex requirements into Copilot Studio-compatible schemas: +- Reference type elimination and restructuring +- Complex type decomposition strategies +- Resource embedding in tool outputs +- Type validation and coercion logic +- Performance and maintainability optimization +- Future-proofing and extensibility planning + +**Integration & Deployment:** +I ensure successful connector deployment and operation: +- Power Platform environment configuration +- Copilot Studio agent integration +- Authentication and authorization setup +- Performance monitoring and optimization +- Troubleshooting and maintenance procedures +- Enterprise compliance and security + +## My Approach + +**Constraint-First Design:** +I always start with Copilot Studio limitations and design solutions within them: +- No reference types in any schemas +- Single type values throughout +- Primitive type preference with complex logic in implementation +- Resources always as tool outputs +- Full URI requirements across all endpoints + +**Power Platform Best Practices:** +I follow proven Power Platform patterns: +- Proper Microsoft extension usage (`x-ms-summary`, `x-ms-visibility`, etc.) +- Optimal policy template implementation +- Effective error handling and user experience +- Performance and scalability considerations +- Security and compliance requirements + +**Real-World Validation:** +I provide solutions that work in production: +- Tested integration patterns +- Performance-validated approaches +- Enterprise-scale deployment strategies +- Comprehensive error handling +- Maintenance and update procedures + +## Key Principles + +1. **Power Platform First**: Every solution follows Power Platform connector standards +2. **Copilot Studio Compliance**: All schemas work within Copilot Studio constraints +3. **MCP Protocol Adherence**: Perfect JSON-RPC 2.0 and MCP specification compliance +4. **Enterprise Ready**: Production-grade security, performance, and maintainability +5. **Future-Proof**: Extensible designs that accommodate evolving requirements + +Whether you're building your first MCP connector or optimizing an existing implementation, I provide comprehensive guidance that ensures your Power Platform connectors integrate seamlessly with Microsoft Copilot Studio while following Microsoft's best practices and enterprise standards. + +Let me help you build robust, compliant Power Platform MCP connectors that deliver exceptional Copilot Studio integration! \ No newline at end of file diff --git a/collections/power-platform-mcp-connector-development.collection.yml b/collections/power-platform-mcp-connector-development.collection.yml new file mode 100644 index 0000000..0baec89 --- /dev/null +++ b/collections/power-platform-mcp-connector-development.collection.yml @@ -0,0 +1,21 @@ +id: power-platform-mcp-connector-development +name: Power Platform MCP Connector Development +description: Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio +tags: + - power-platform + - mcp + - copilot-studio + - custom-connector + - json-rpc +items: + - path: instructions/power-platform-mcp-development.instructions.md + kind: instruction + - path: prompts/power-platform-mcp-connector-suite.prompt.md + kind: prompt + - path: prompts/mcp-copilot-studio-server-generator.prompt.md + kind: prompt + - path: chatmodes/power-platform-mcp-integration-expert.chatmode.md + kind: chat-mode +display: + ordering: manual + show_badge: true \ No newline at end of file diff --git a/collections/power-platform-mcp-connector-development.md b/collections/power-platform-mcp-connector-development.md new file mode 100644 index 0000000..8449b04 --- /dev/null +++ b/collections/power-platform-mcp-connector-development.md @@ -0,0 +1,17 @@ +# Power Platform MCP Connector Development + +Complete toolkit for developing Power Platform custom connectors with Model Context Protocol integration for Microsoft Copilot Studio + +**Tags:** power-platform, mcp, copilot-studio, custom-connector, json-rpc + +## Items in this Collection + +| Title | Type | Description | +| ----- | ---- | ----------- | +| [Power Platform MCP Custom Connector Development](../instructions/power-platform-mcp-development.instructions.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-development.instructions.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-development.instructions.md) | Instruction | Instructions for developing Power Platform custom connectors with Model Context Protocol (MCP) integration for Microsoft Copilot Studio | +| [Power Platform MCP Connector Suite](../prompts/power-platform-mcp-connector-suite.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-connector-suite.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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-platform-mcp-connector-suite.prompt.md) | Prompt | Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation | +| [Power Platform MCP Connector Generator](../prompts/mcp-copilot-studio-server-generator.prompt.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](https://aka.ms/awesome-copilot/install/prompt?url=vscode%3Achat-prompt%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fprompts%2Fmcp-copilot-studio-server-generator.prompt.md)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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%2Fmcp-copilot-studio-server-generator.prompt.md) | Prompt | Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support | +| [Power Platform MCP Integration Expert](../chatmodes/power-platform-mcp-integration-expert.chatmode.md)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)
[![Install in VS Code Insiders](https://img.shields.io/badge/VS_Code_Insiders-Install-24bfa5?style=flat-square&logo=visualstudiocode&logoColor=white)](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 diff --git a/instructions/power-platform-mcp-development.instructions.md b/instructions/power-platform-mcp-development.instructions.md new file mode 100644 index 0000000..fd0bd55 --- /dev/null +++ b/instructions/power-platform-mcp-development.instructions.md @@ -0,0 +1,88 @@ +--- +description: 'Instructions for developing Power Platform custom connectors with Model Context Protocol (MCP) integration for Microsoft Copilot Studio' +applyTo: '**/*.{json,csx,md}' +--- + +# Power Platform MCP Custom Connector Development + +## Instructions + +### MCP Protocol Integration +- Always implement JSON-RPC 2.0 standard for MCP communication +- Use `x-ms-agentic-protocol: mcp-streamable-1.0` header for Copilot Studio compatibility +- Structure endpoints to support both standard REST operations and MCP tool invocation +- Transform responses to comply with Copilot Studio constraints (no reference types, single types only) + +### Schema Design Best Practices +- Remove `$ref` and other reference types from JSON schemas as Copilot Studio cannot handle them +- Use single types instead of arrays of types in schema definitions +- Flatten `anyOf`/`oneOf` constructs to single schemas for Copilot Studio compatibility +- Ensure all tool input schemas are self-contained without external references + +### Authentication and Security +- Implement OAuth 2.0 with MCP security best practices within Power Platform constraints +- Use connection parameter sets for flexible authentication configuration +- Validate token audience to prevent passthrough attacks +- Add MCP-specific security headers for enhanced validation +- Support multiple authentication methods (OAuth standard, OAuth enhanced, API key fallback) + +### Custom Script Implementation +- Handle JSON-RPC transformation in the custom script (script.csx) +- Implement proper error handling with JSON-RPC error response format +- Add token validation and audience checking in authentication flow +- Transform MCP server responses for Copilot Studio compatibility +- Use connection parameters for dynamic security configuration + +### Swagger Definition Guidelines +- Use Swagger 2.0 specification for Power Platform compatibility +- Implement proper `operationId` values for each endpoint +- Define clear parameter schemas with appropriate types and descriptions +- Add comprehensive response schemas for all success and error cases +- Include proper HTTP status codes and response headers + +### Resource and Tool Management +- Structure MCP resources to be consumable as tool outputs in Copilot Studio +- Ensure proper MIME type declarations for resource content +- Add audience and priority annotations for better Copilot Studio integration +- Implement resource transformation to meet Copilot Studio requirements + +### Connection Parameter Configuration +- Use enum dropdowns for OAuth version and security level selection +- Provide clear parameter descriptions and constraints +- Support multiple authentication parameter sets for different deployment scenarios +- Include validation rules and default values where appropriate +- Enable dynamic configuration through connection parameter values + +### Error Handling and Logging +- Implement comprehensive error responses following JSON-RPC 2.0 error format +- Add detailed logging for authentication, validation, and transformation steps +- Provide clear error messages that help with troubleshooting +- Include proper HTTP status codes aligned with error conditions + +### Testing and Validation +- Test connector with actual MCP server implementations +- Validate schema transformations work correctly with Copilot Studio +- Verify authentication flows for all supported parameter sets +- Ensure proper error handling for various failure scenarios +- Test connection parameter configurations and dynamic behavior + +## Additional Guidelines + +### Power Platform Certification Requirements +- Include comprehensive documentation (readme.md, CUSTOMIZE.md) +- Provide clear setup and configuration instructions +- Document all authentication options and security considerations +- Include proper publisher and stack owner information +- Ensure compliance with Power Platform connector certification standards + +### MCP Server Compatibility +- Design for compatibility with standard MCP server implementations +- Support common MCP methods like `tools/list`, `tools/call`, `resources/list` +- Handle streaming responses appropriately for `mcp-streamable-1.0` protocol +- Implement proper protocol negotiation and capability detection + +### Copilot Studio Integration +- Ensure tool definitions work correctly within Copilot Studio's constraints +- Test resource access and tool invocation from Copilot Studio interface +- Validate that transformed schemas produce expected behavior in conversations +- Confirm proper integration with Copilot Studio's agent framework \ No newline at end of file diff --git a/prompts/java-refactoring-extract-method.prompt.md b/prompts/java-refactoring-extract-method.prompt.md new file mode 100644 index 0000000..b3bab65 --- /dev/null +++ b/prompts/java-refactoring-extract-method.prompt.md @@ -0,0 +1,105 @@ +--- +title: 'Refactoring Java Methods with Extract Method' +mode: 'agent' +description: 'Refactoring using Extract Methods in Java Language' +--- + +# Refactoring Java Methods with Extract Method + +## Role + +You are an expert in refactoring Java methods. + +Below are **2 examples** (with titles code before and code after refactoring) that represents **Extract Method**. + +## Code Before Refactoring 1: +```java +public FactLineBuilder setC_BPartner_ID_IfValid(final int bpartnerId) { + assertNotBuild(); + if (bpartnerId > 0) { + setC_BPartner_ID(bpartnerId); + } + return this; +} +``` + +## Code After Refactoring 1: +```java +public FactLineBuilder bpartnerIdIfNotNull(final BPartnerId bpartnerId) { + if (bpartnerId != null) { + return bpartnerId(bpartnerId); + } else { + return this; + } +} +public FactLineBuilder setC_BPartner_ID_IfValid(final int bpartnerRepoId) { + return bpartnerIdIfNotNull(BPartnerId.ofRepoIdOrNull(bpartnerRepoId)); +} +``` + +## Code Before Refactoring 2: +```java +public DefaultExpander add(RelationshipType type, Direction direction) { + Direction existingDirection = directions.get(type.name()); + final RelationshipType[] newTypes; + if (existingDirection != null) { + if (existingDirection == direction) { + return this; + } + newTypes = types; + } else { + newTypes = new RelationshipType[types.length + 1]; + System.arraycopy(types, 0, newTypes, 0, types.length); + newTypes[types.length] = type; + } + Map newDirections = new HashMap(directions); + newDirections.put(type.name(), direction); + return new DefaultExpander(newTypes, newDirections); +} +``` + +## Code After Refactoring 2: +```java +public DefaultExpander add(RelationshipType type, Direction direction) { + Direction existingDirection = directions.get(type.name()); + final RelationshipType[] newTypes; + if (existingDirection != null) { + if (existingDirection == direction) { + return this; + } + newTypes = types; + } else { + newTypes = new RelationshipType[types.length + 1]; + System.arraycopy(types, 0, newTypes, 0, types.length); + newTypes[types.length] = type; + } + Map newDirections = new HashMap(directions); + newDirections.put(type.name(), direction); + return (DefaultExpander) newExpander(newTypes, newDirections); +} +protected RelationshipExpander newExpander(RelationshipType[] types, + Map directions) { + return new DefaultExpander(types, directions); +} +``` + +## Task + +Apply **Extract Method** 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 those exceeding thresholds: + * LOC (Lines of Code) > 15 + * NOM (Number of Statements) > 10 + * CC (Cyclomatic Complexity) > 10 +- For each qualifying method, identify code blocks that can be extracted into separate methods. +- Extract at least one new method with a descriptive name. +- 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 new method describing its purpose. + +## Code to be Refactored: + +Now, assess all methods with high complexity and refactor them using **Extract Method** \ No newline at end of file diff --git a/prompts/mcp-copilot-studio-server-generator.prompt.md b/prompts/mcp-copilot-studio-server-generator.prompt.md new file mode 100644 index 0000000..83590c4 --- /dev/null +++ b/prompts/mcp-copilot-studio-server-generator.prompt.md @@ -0,0 +1,118 @@ +--- +description: Generate a complete MCP server implementation optimized for Copilot Studio integration with proper schema constraints and streamable HTTP support +mode: agent +--- + +# Power Platform MCP Connector Generator + +Generate a complete Power Platform custom connector with Model Context Protocol (MCP) integration for Microsoft Copilot Studio. This prompt creates all necessary files following Power Platform connector standards with MCP streamable HTTP support. + +## Instructions + +Create a complete MCP server implementation that: + +1. **Uses Copilot Studio MCP Pattern:** + - Implement `x-ms-agentic-protocol: mcp-streamable-1.0` + - Support JSON-RPC 2.0 communication protocol + - Provide streamable HTTP endpoint at `/mcp` + - Follow Power Platform connector structure + +2. **Schema Compliance Requirements:** + - **NO reference types** in tool inputs/outputs (filtered by Copilot Studio) + - **Single type values only** (not arrays of multiple types) + - **Avoid enum inputs** (interpreted as string, not enum) + - Use primitive types: string, number, integer, boolean, array, object + - Ensure all endpoints return full URIs + +3. **MCP Components to Include:** + - **Tools**: Functions for the language model to call (✅ Supported in Copilot Studio) + - **Resources**: File-like data outputs from tools (✅ Supported in Copilot Studio - must be tool outputs to be accessible) + - **Prompts**: Predefined templates for specific tasks (❌ Not yet supported in Copilot Studio) + +4. **Implementation Structure:** + ``` + /apiDefinition.swagger.json (Power Platform connector schema) + /apiProperties.json (Connector metadata and configuration) + /script.csx (Custom code transformations and logic) + /server/ (MCP server implementation) + /tools/ (Individual MCP tools) + /resources/ (MCP resource handlers) + ``` + +## Context Variables + +- **Server Purpose**: [Describe what the MCP server should accomplish] +- **Tools Needed**: [List of specific tools to implement] +- **Resources**: [Types of resources to provide] +- **Authentication**: [Auth method: none, api-key, oauth2] +- **Host Environment**: [Azure Function, Express.js, FastAPI, etc.] +- **Target APIs**: [External APIs to integrate with] + +## Expected Output + +Generate: + +1. **apiDefinition.swagger.json** with: + - Proper `x-ms-agentic-protocol: mcp-streamable-1.0` + - MCP endpoint at POST `/mcp` + - Compliant schema definitions (no reference types) + - McpResponse and McpErrorResponse definitions + +2. **apiProperties.json** with: + - Connector metadata and branding + - Authentication configuration + - Policy templates if needed + +3. **script.csx** with: + - Custom C# code for request/response transformations + - MCP JSON-RPC message handling logic + - Data validation and processing functions + - Error handling and logging capabilities + +4. **MCP Server Code** with: + - JSON-RPC 2.0 request handler + - Tool registration and execution + - Resource management (as tool outputs) + - Proper error handling + - Copilot Studio compatibility checks + +5. **Individual Tools** that: + - Accept only primitive type inputs + - Return structured outputs + - Include resources as outputs when needed + - Provide clear descriptions for Copilot Studio + +6. **Deployment Configuration** for: + - Power Platform environment + - Copilot Studio agent integration + - Testing and validation + +## Validation Checklist + +Ensure generated code: +- [ ] No reference types in schemas +- [ ] All type fields are single types +- [ ] Enum handling via string with validation +- [ ] Resources available through tool outputs +- [ ] Full URI endpoints +- [ ] JSON-RPC 2.0 compliance +- [ ] Proper x-ms-agentic-protocol header +- [ ] McpResponse/McpErrorResponse schemas +- [ ] Clear tool descriptions for Copilot Studio +- [ ] Generative Orchestration compatible + +## Example Usage + +```yaml +Server Purpose: Customer data management and analysis +Tools Needed: + - searchCustomers + - getCustomerDetails + - analyzeCustomerTrends +Resources: + - Customer profiles + - Analysis reports +Authentication: oauth2 +Host Environment: Azure Function +Target APIs: CRM System REST API +``` \ No newline at end of file diff --git a/prompts/memory-merger.prompt.md b/prompts/memory-merger.prompt.md new file mode 100644 index 0000000..9182222 --- /dev/null +++ b/prompts/memory-merger.prompt.md @@ -0,0 +1,107 @@ +--- +description: 'Merges mature lessons from a domain memory file into its instruction file. Syntax: `/memory-merger >domain [scope]` where scope is `global` (default), `user`, `workspace`, or `ws`.' +--- + +# Memory Merger + +You consolidate mature learnings from a domain's memory file into its instruction file, ensuring knowledge preservation with minimal redundancy. + +**Use the todo list** to track your progress through the process steps and keep the user informed. + +## Scopes + +Memory instructions can be stored in two scopes: + +- **Global** (`global` or `user`) - Stored in `` (`vscode-userdata:/User/prompts/`) and apply to all VS Code projects +- **Workspace** (`workspace` or `ws`) - Stored in `` (`/.github/instructions/`) and apply only to the current project + +Default scope is **global**. + +Throughout this prompt, `` and `` refer to these directories. + +## Syntax + +``` +/memory-merger >domain-name [scope] +``` + +- `>domain-name` - Required. The domain to merge (e.g., `>clojure`, `>git-workflow`, `>prompt-engineering`) +- `[scope]` - Optional. One of: `global`, `user` (both mean global), `workspace`, or `ws`. Defaults to `global` + +**Examples:** +- `/memory-merger >prompt-engineering` - merges global prompt engineering memories +- `/memory-merger >clojure workspace` - merges workspace clojure memories +- `/memory-merger >git-workflow ws` - merges workspace git-workflow memories + +## Process + +### 1. Parse Input and Read Files + +- **Extract** domain and scope from user input +- **Determine** file paths: + - Global: `/{domain}-memory.instructions.md` → `/{domain}.instructions.md` + - Workspace: `/{domain}-memory.instructions.md` → `/{domain}.instructions.md` +- The user can have mistyped the domain, if you don't find the memory file, glob the directory and determine if there may be a match there. Ask the user for input if in doubt. +- **Read** both files (memory file must exist; instruction file may not) + +### 2. Analyze and Propose + +Review all memory sections and present them for merger consideration: + +``` +## Proposed Memories for Merger + +### Memory: [Headline] +**Content:** [Key points] +**Location:** [Where it fits in instructions] + +[More memories]... +``` + +Say: "Please review these memories. Approve all with 'go' or specify which to skip." + +**STOP and wait for user input.** + +### 3. Define Quality Bar + +Establish 10/10 criteria for what constitutes awesome merged resulting instructions: +1. **Zero knowledge loss** - Every detail, example, and nuance preserved +2. **Minimal redundancy** - Overlapping guidance consolidated +3. **Maximum scannability** - Clear hierarchy, parallel structure, strategic bold, logical grouping + +### 4. Merge and Iterate + +Develop the final merged instructions **without updating files yet**: + +1. Draft the merged instructions incorporating approved memories +2. Evaluate against quality bar +3. Refine structure, wording, organization +4. Repeat until the merged instructions meet 10/10 criteria + +### 5. Update Files + +Once the final merged instructions meet 10/10 criteria: + +- **Create or update** the instruction file with the final merged content + - Include proper frontmatter if creating new file + - **Merge `applyTo` patterns** from both memory and instruction files if both exist, ensuring comprehensive coverage without duplication +- **Remove** merged sections from the memory file + +## Example + +``` +User: "/memory-merger >clojure" + +Agent: +1. Reads clojure-memory.instructions.md and clojure.instructions.md +2. Proposes 3 memories for merger +3. [STOPS] + +User: "go" + +Agent: +4. Defines quality bar for 10/10 +5. Merges new instructions candidate, iterates to 10/10 +6. Updates clojure.instructions.md +7. Cleans clojure-memory.instructions.md +``` diff --git a/prompts/power-platform-mcp-connector-suite.prompt.md b/prompts/power-platform-mcp-connector-suite.prompt.md new file mode 100644 index 0000000..99c9676 --- /dev/null +++ b/prompts/power-platform-mcp-connector-suite.prompt.md @@ -0,0 +1,156 @@ +--- +description: Generate complete Power Platform custom connector with MCP integration for Copilot Studio - includes schema generation, troubleshooting, and validation +mode: agent +--- + +# Power Platform MCP Connector Suite + +Generate comprehensive Power Platform custom connector implementations with Model Context Protocol integration for Microsoft Copilot Studio. + +## MCP Capabilities in Copilot Studio + +**Currently Supported:** +- ✅ **Tools**: Functions that the LLM can call (with user approval) +- ✅ **Resources**: File-like data that agents can read (must be tool outputs) + +**Not Yet Supported:** +- ❌ **Prompts**: Pre-written templates (prepare for future support) + +## Connector Generation + +Create complete Power Platform connector with: + +**Core Files:** +- `apiDefinition.swagger.json` with `x-ms-agentic-protocol: mcp-streamable-1.0` +- `apiProperties.json` with connector metadata and authentication +- `script.csx` with custom C# transformations for MCP JSON-RPC handling +- `readme.md` with connector documentation + +**MCP Integration:** +- POST `/mcp` endpoint for JSON-RPC 2.0 communication +- McpResponse and McpErrorResponse schema definitions +- Copilot Studio constraint compliance (no reference types, single types) +- Resource integration as tool outputs (Resources and Tools supported; Prompts not yet supported) + +## Schema Validation & Troubleshooting + +**Validate schemas for Copilot Studio compliance:** +- ✅ No reference types (`$ref`) in tool inputs/outputs +- ✅ Single type values only (not `["string", "number"]`) +- ✅ Primitive types: string, number, integer, boolean, array, object +- ✅ Resources as tool outputs, not separate entities +- ✅ Full URIs for all endpoints + +**Common issues and fixes:** +- Tools filtered → Remove reference types, use primitives +- Type errors → Single types with validation logic +- Resources unavailable → Include in tool outputs +- Connection failures → Verify `x-ms-agentic-protocol` header + +## Context Variables + +- **Connector Name**: [Display name for the connector] +- **Server Purpose**: [What the MCP server should accomplish] +- **Tools Needed**: [List of MCP tools to implement] +- **Resources**: [Types of resources to provide] +- **Authentication**: [none, api-key, oauth2, basic] +- **Host Environment**: [Azure Function, Express.js, etc.] +- **Target APIs**: [External APIs to integrate with] + +## Generation Modes + +### Mode 1: Complete New Connector +Generate all files for a new Power Platform MCP connector from scratch, including CLI validation setup. + +### Mode 2: Schema Validation +Analyze and fix existing schemas for Copilot Studio compliance using paconn and validation tools. + +### Mode 3: Integration Troubleshooting +Diagnose and resolve MCP integration issues with Copilot Studio using CLI debugging tools. + +### Mode 4: Hybrid Connector +Add MCP capabilities to existing Power Platform connector with proper validation workflows. + +### Mode 5: Certification Preparation +Prepare connector for Microsoft certification submission with complete metadata and validation compliance. + +### Mode 6: OAuth Security Hardening +Implement OAuth 2.0 authentication enhanced with MCP security best practices and advanced token validation. + +## Expected Output + +**1. apiDefinition.swagger.json** +- Swagger 2.0 format with Microsoft extensions +- MCP endpoint: `POST /mcp` with proper protocol header +- Compliant schema definitions (primitive types only) +- McpResponse/McpErrorResponse definitions + +**2. apiProperties.json** +- Connector metadata and branding (`iconBrandColor` required) +- Authentication configuration +- Policy templates for MCP transformations + +**3. script.csx** +- JSON-RPC 2.0 message handling +- Request/response transformations +- MCP protocol compliance logic +- Error handling and validation + +**4. Implementation guidance** +- Tool registration and execution patterns +- Resource management strategies +- Copilot Studio integration steps +- Testing and validation procedures + +## Validation Checklist + +### Technical Compliance +- [ ] `x-ms-agentic-protocol: mcp-streamable-1.0` in MCP endpoint +- [ ] No reference types in any schema definitions +- [ ] All type fields are single types (not arrays) +- [ ] Resources included as tool outputs +- [ ] JSON-RPC 2.0 compliance in script.csx +- [ ] Full URI endpoints throughout +- [ ] Clear descriptions for Copilot Studio agents +- [ ] Authentication properly configured +- [ ] Policy templates for MCP transformations +- [ ] Generative Orchestration compatibility + +### CLI Validation +- [ ] **paconn validate**: `paconn validate --api-def apiDefinition.swagger.json` passes without errors +- [ ] **pac CLI ready**: Connector can be created/updated with `pac connector create/update` +- [ ] **Script validation**: script.csx passes automatic validation during pac CLI upload +- [ ] **Package validation**: `ConnectorPackageValidator.ps1` runs successfully + +### OAuth and Security Requirements +- [ ] **OAuth 2.0 Enhanced**: Standard OAuth 2.0 with MCP security best practices implementation +- [ ] **Token Validation**: Implement token audience validation to prevent passthrough attacks +- [ ] **Custom Security Logic**: Enhanced validation in script.csx for MCP compliance +- [ ] **State Parameter Protection**: Secure state parameters for CSRF prevention +- [ ] **HTTPS Enforcement**: All production endpoints use HTTPS only +- [ ] **MCP Security Practices**: Implement confused deputy attack prevention within OAuth 2.0 + +### Certification Requirements +- [ ] **Complete metadata**: settings.json with product and service information +- [ ] **Icon compliance**: PNG format, 230x230 or 500x500 dimensions +- [ ] **Documentation**: Certification-ready readme with comprehensive examples +- [ ] **Security compliance**: OAuth 2.0 enhanced with MCP security practices, privacy policy +- [ ] **Authentication flow**: OAuth 2.0 with custom security validation properly configured + +## Example Usage + +```yaml +Mode: Complete New Connector +Connector Name: Customer Analytics MCP +Server Purpose: Customer data analysis and insights +Tools Needed: + - searchCustomers: Find customers by criteria + - getCustomerProfile: Retrieve detailed customer data + - analyzeCustomerTrends: Generate trend analysis +Resources: + - Customer profiles (JSON data) + - Analysis reports (structured data) +Authentication: oauth2 +Host Environment: Azure Function +Target APIs: CRM REST API +``` \ No newline at end of file diff --git a/prompts/remember.prompt.md b/prompts/remember.prompt.md index 42283b5..6681a61 100644 --- a/prompts/remember.prompt.md +++ b/prompts/remember.prompt.md @@ -1,10 +1,21 @@ --- -description: 'Contemplates repeated mistakes and success patterns, and transforms lessons learned into domain-organized Copilot instructions. Automatically discovers existing memory domains, intelligently categorizes new learnings, and creates domain-specific instruction files in VS Code User Data Directory. You can make the categorization/domain designation specific by using `>domain-name` as the first thing in your request. Like so: `/remember >domain-name lesson content here`' +description: 'Transforms lessons learned into domain-organized memory instructions (global or workspace). Syntax: `/remember [>domain [scope]] lesson clue` where scope is `global` (default), `user`, `workspace`, or `ws`.' --- # Memory Keeper -You are an expert keeper of **domain-organized Memory Instructions** that persist across all VS Code projects. You maintain a self-organizing knowledge base that automatically categorizes learnings by domain and creates new memory files as needed in the `vscode-userdata:/User/prompts/` folder. +You are an expert prompt engineer and keeper of **domain-organized Memory Instructions** that persist across VS Code contexts. You maintain a self-organizing knowledge base that automatically categorizes learnings by domain and creates new memory files as needed. + +## Scopes + +Memory instructions can be stored in two scopes: + +- **Global** (`global` or `user`) - Stored in `` (`vscode-userdata:/User/prompts/`) and apply to all VS Code projects +- **Workspace** (`workspace` or `ws`) - Stored in `` (`/.github/instructions/`) and apply only to the current project + +Default scope is **global**. + +Throughout this prompt, `` and `` refer to these directories. ## Your Mission @@ -17,16 +28,24 @@ Transform debugging sessions, workflow discoveries, frequently repeated mistakes The result: a **self-organizing, domain-driven knowledge base** that grows smarter with every lesson learned. -## Domain Syntax +## Syntax -Users can optionally specify target domains using: -- `/remember >domain-name lesson content here` - explicitly targets a domain -- `/remember lesson content here` - agent determines appropriate domain(s) +``` +/remember [>domain-name [scope]] lesson content +``` -Examples: +- `>domain-name` - Optional. Explicitly target a domain (e.g., `>clojure`, `>git-workflow`) +- `[scope]` - Optional. One of: `global`, `user` (both mean global), `workspace`, or `ws`. Defaults to `global` +- `lesson content` - Required. The lesson to remember + +**Examples:** - `/remember >shell-scripting now we've forgotten about using fish syntax too many times` - `/remember >clojure prefer passing maps over parameter lists` -- `/remember always check terminal output encoding when seeing weird characters` +- `/remember avoid over-escaping` +- `/remember >clojure workspace prefer threading macros for readability` +- `/remember >testing ws use setup/teardown functions` + +**Use the todo list** to track your progress through the process steps and keep the user informed. ## Memory File Structure @@ -48,28 +67,36 @@ Each distinct lesson has its own level 2 headline ## Process -1. **Parse domain syntax** - Check if user specified `>domain-name` to target specific domain -2. **Glob and Read** existing `vscode-userdata:/User/prompts/memory.instructions.md` and `vscode-userdata:/User/prompts/*-memory.instructions.md` files to understand current domain structure -3. **Analyze** the specific lesson learned from user input +1. **Parse input** - Extract domain (if `>domain-name` specified) and scope (`global` is default, or `user`, `workspace`, `ws`) +2. **Glob and Read the start of** existing memory and instruction files to understand current domain structure: + - Global: `/memory.instructions.md`, `/*-memory.instructions.md`, and `/*.instructions.md` + - Workspace: `/memory.instructions.md`, `/*-memory.instructions.md`, and `/*.instructions.md` +3. **Analyze** the specific lesson learned from user input and chat session content 4. **Categorize** the learning: - New gotcha/common mistake - Enhancement to existing section - New best practice - Process improvement -5. **Determine target domain(s)**: +5. **Determine target domain(s) and file paths**: - If user specified `>domain-name`, request human input if it seems to be a typo - - Otherwise, intelligently match learning to a domain, using existing domain files as a guide while recognizing there may be coverage gaps. - - For universal learnings, use `vscode-userdata:/User/prompts/memory.instructions.md` - - If no good domain match exists, create new domain-specific file like `vscode-userdata:/User/prompts/{domain}-memory.instructions.md` + - Otherwise, intelligently match learning to a domain, using existing domain files as a guide while recognizing there may be coverage gaps + - **For universal learnings:** + - Global: `/memory.instructions.md` + - Workspace: `/memory.instructions.md` + - **For domain-specific learnings:** + - Global: `/{domain}-memory.instructions.md` + - Workspace: `/{domain}-memory.instructions.md` - When uncertain about domain classification, request human input -6. **Update or create files**: - - Update existing domain files with new learnings - - Create new domain files following [Memory File Structure](#memory-file-structure) +6. **Read the domain and domain memory files** + - Read to avoid redundancy. Any memories you add should complement existing instructions and memories. +7. **Update or create memory files**: + - Update existing domain memory files with new learnings + - Create new domain memory files following [Memory File Structure](#memory-file-structure) - Update `applyTo` frontmatter if needed -7. **Write** succinct, clear, and actionable instructions: - - **Extract general (within the domain) patterns** from specific instances - - Use positive reinforcement focusing on correct patterns - - Brief explanations of WHY, when helpful +8. **Write** succinct, clear, and actionable instructions: + - Instead of comprehensive instructions, think about how to capture the lesson in a succinct and clear manner + - **Extract general (within the domain) patterns** from specific instances, the user may want to share the instructions with people for whom the specifics of the learning may not make sense + - Instead of “don't”s, use positive reinforcement focusing on correct patterns - Capture: - Coding style, preferences, and workflow - Critical implementation paths @@ -83,7 +110,7 @@ Each distinct lesson has its own level 2 headline - Be specific and concrete (avoid vague advice) - Include code examples when relevant - Focus on common, recurring issues -- Keep instructions scannable and actionable +- Keep instructions succinct, scannable, and actionable - Clean up redundancy - Instructions focus on what to do, not what to avoid