diff --git a/.all-contributorsrc b/.all-contributorsrc index ae9f72a..e941b26 100644 --- a/.all-contributorsrc +++ b/.all-contributorsrc @@ -786,8 +786,18 @@ "contributions": [ "code" ] + }, + { + "login": "soderlind", + "name": "Per Søderlind", + "avatar_url": "https://avatars.githubusercontent.com/u/1649452?v=4", + "profile": "https://soderlind.no", + "contributions": [ + "code" + ] } ], "contributorsPerLine": 7, - "linkToUsage": true + "linkToUsage": true, + "commitType": "docs" } diff --git a/.schemas/collection.schema.json b/.schemas/collection.schema.json index e4efe3a..0119882 100644 --- a/.schemas/collection.schema.json +++ b/.schemas/collection.schema.json @@ -57,6 +57,10 @@ "type": "string", "description": "Type of the item", "enum": ["prompt", "instruction", "chat-mode"] + }, + "usage": { + "type": "string", + "description": "Optional usage context for the item" } } }, @@ -81,4 +85,4 @@ } } } -} \ No newline at end of file +} diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 6fafc6c..8945cea 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -152,7 +152,7 @@ display: 1. **Fork this repository** 2. **Create a new branch** for your contribution -3. **Add your instruction or prompt file** following the guidelines above +3. **Add your instruction, prompt file, chatmode, or collection** following the guidelines above 4. **Run the update script** (optional): `node update-readme.js` to update the README with your new file - A GitHub Actions workflow will verify that this step was performed correctly - If the README.md would be modified by running the script, the PR check will fail with a comment showing the required changes diff --git a/README.chatmodes.md b/README.chatmodes.md index 9a61d4a..e663e98 100644 --- a/README.chatmodes.md +++ b/README.chatmodes.md @@ -40,7 +40,7 @@ Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, e | [Expert C++ software engineer mode instructions](chatmodes/expert-cpp-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%2Fexpert-cpp-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%2Fexpert-cpp-software-engineer.chatmode.md) | Provide expert C++ software engineering guidance using modern C++ and industry best practices. | | [Expert React Frontend Engineer Mode Instructions](chatmodes/expert-react-frontend-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%2Fexpert-react-frontend-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%2Fexpert-react-frontend-engineer.chatmode.md) | Provide expert React frontend engineering guidance using modern TypeScript and design patterns. | | [Gilfoyle Code Review Mode](chatmodes/gilfoyle.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%2Fgilfoyle.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%2Fgilfoyle.chatmode.md) | Code review and analysis with the sardonic wit and technical elitism of Bertram Gilfoyle from Silicon Valley. Prepare for brutal honesty about your code. | -| [High-Level Big Picture Architect (HLBPA)](chatmodes/hlbpa.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%2Fhlbpa.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%2Fhlbpa.chatmode.md) | HLBPA: Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. | +| [High-Level Big Picture Architect (HLBPA)](chatmodes/hlbpa.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%2Fhlbpa.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%2Fhlbpa.chatmode.md) | Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing. | | [Idea Generator mode instructions](chatmodes/simple-app-idea-generator.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%2Fsimple-app-idea-generator.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%2Fsimple-app-idea-generator.chatmode.md) | Brainstorm and develop new application ideas through fun, interactive questioning until ready for specification creation. | | [Implementation Plan Generation Mode](chatmodes/implementation-plan.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%2Fimplementation-plan.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%2Fimplementation-plan.chatmode.md) | Generate an implementation plan for new features or refactoring existing code. | | [Kusto Assistant: Azure Data Explorer (Kusto) Engineering Assistant](chatmodes/kusto-assistant.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%2Fkusto-assistant.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%2Fkusto-assistant.chatmode.md) | Expert KQL assistant for live Azure Data Explorer analysis via Azure MCP server | diff --git a/README.collections.md b/README.collections.md index b5db549..4b2df4e 100644 --- a/README.collections.md +++ b/README.collections.md @@ -25,5 +25,6 @@ Curated collections of related prompts, instructions, and chat modes organized a | [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 | | [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 | | [Technical Spike](collections/technical-spike.md) | Tools for creation, management and research of technical spikes to reduce unknowns and assumptions before proceeding to specification and implementation of solutions. | 2 items | technical-spike, assumption-testing, validation, research | | [Testing & Test Automation](collections/testing-automation.md) | Comprehensive collection for writing tests, test automation, and test-driven development including unit tests, integration tests, and end-to-end testing strategies. | 11 items | testing, tdd, automation, unit-tests, integration, playwright, jest, nunit | diff --git a/README.instructions.md b/README.instructions.md index 60b04cc..d1cb738 100644 --- a/README.instructions.md +++ b/README.instructions.md @@ -20,6 +20,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Angular Development Instructions](instructions/angular.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%2Fangular.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%2Fangular.instructions.md) | Angular-specific coding standards and best practices | | [Ansible Conventions and Best Practices](instructions/ansible.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%2Fansible.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%2Fansible.instructions.md) | Ansible conventions and best practices | | [ASP.NET REST API Development](instructions/aspnet-rest-apis.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%2Faspnet-rest-apis.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%2Faspnet-rest-apis.instructions.md) | Guidelines for building REST APIs with ASP.NET | +| [Astro Development Instructions](instructions/astro.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%2Fastro.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%2Fastro.instructions.md) | Astro development standards and best practices for content-driven websites | | [Azure DevOps Pipeline YAML Best Practices](instructions/azure-devops-pipelines.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%2Fazure-devops-pipelines.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%2Fazure-devops-pipelines.instructions.md) | Best practices for Azure DevOps Pipeline YAML files | | [Azure Functions Typescript](instructions/azure-functions-typescript.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%2Fazure-functions-typescript.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%2Fazure-functions-typescript.instructions.md) | TypeScript patterns for Azure Functions | | [Azure Logic Apps and Power Automate Instructions](instructions/azure-logic-apps-power-automate.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%2Fazure-logic-apps-power-automate.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%2Fazure-logic-apps-power-automate.instructions.md) | Guidelines for developing Azure Logic Apps and Power Automate workflows with best practices for Workflow Definition Language (WDL), integration patterns, and enterprise automation | @@ -87,6 +88,7 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Spec Driven Workflow v1](instructions/spec-driven-workflow-v1.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%2Fspec-driven-workflow-v1.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%2Fspec-driven-workflow-v1.instructions.md) | Specification-Driven Workflow v1 provides a structured approach to software development, ensuring that requirements are clearly defined, designs are meticulously planned, and implementations are thoroughly documented and validated. | | [Spring Boot Development](instructions/springboot.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%2Fspringboot.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%2Fspringboot.instructions.md) | Guidelines for building Spring Boot base applications | | [SQL Development](instructions/sql-sp-generation.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%2Fsql-sp-generation.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%2Fsql-sp-generation.instructions.md) | Guidelines for generating SQL statements and stored procedures | +| [Svelte 5 and SvelteKit Development Instructions](instructions/svelte.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%2Fsvelte.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%2Fsvelte.instructions.md) | Svelte 5 and SvelteKit development standards and best practices for component-based user interfaces and full-stack applications | | [Taming Copilot](instructions/taming-copilot.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%2Ftaming-copilot.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%2Ftaming-copilot.instructions.md) | Prevent Copilot from wreaking havoc across your codebase, keeping it under control. | | [TanStack Start with Shadcn/ui Development Guide](instructions/tanstack-start-shadcn-tailwind.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%2Ftanstack-start-shadcn-tailwind.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%2Ftanstack-start-shadcn-tailwind.instructions.md) | Guidelines for building TanStack Start applications | | [Task Plan Implementation Instructions](instructions/task-implementation.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%2Ftask-implementation.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%2Ftask-implementation.instructions.md) | Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai | diff --git a/README.md b/README.md index 7a92db2..7cda2a5 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-86-orange.svg?style=flat-square)](#contributors-) +[![All Contributors](https://img.shields.io/badge/all_contributors-87-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. @@ -234,6 +234,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
💻 diff --git a/chatmodes/hlbpa.chatmode.md b/chatmodes/hlbpa.chatmode.md index 357ab69..9b75483 100644 --- a/chatmodes/hlbpa.chatmode.md +++ b/chatmodes/hlbpa.chatmode.md @@ -1,21 +1,21 @@ --- -description: 'HLBPA: Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing.' -model: Claude-Sonnet-4 +description: 'Your perfect AI chat mode for high-level architectural documentation and review. Perfect for targeted updates after a story or researching that legacy system when nobody remembers what it's supposed to be doing.' +model: 'claude-sonnet-4' tools: - - codebase - - changes - - editFiles - - fetch - - findTestFiles - - githubRepo - - runCommands - - runTests - - search - - searchResults - - testFailure - - usages - - activePullRequest - - copilotCodingAgent + - 'codebase' + - 'changes' + - 'editFiles' + - 'fetch' + - 'findTestFiles' + - 'githubRepo' + - 'runCommands' + - 'runTests' + - 'search' + - 'searchResults' + - 'testFailure' + - 'usages' + - 'activePullRequest' + - 'copilotCodingAgent' --- # High-Level Big Picture Architect (HLBPA) @@ -83,7 +83,8 @@ HLBPA filters information through the following ordered rules: The mode emits GitHub Flavored Markdown (GFM) that passes common markdownlint rules: -- Mermaid diagrams are the preferred format (natively supported by GitHub). Mermaid supports comprehensive diagram types including flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, C4 diagrams, and more. Any other formats (ASCII art, PlantUML, Graphviz, etc.) will be flagged as unsupported. + +- **Only Mermaid diagrams are supported.** Any other formats (ASCII art, ANSI, PlantUML, Graphviz, etc.) are strongly discouraged. All diagrams should be in Mermaid format. - Primary file lives at `#docs/ARCHITECTURE_OVERVIEW.md` (or caller‑supplied name). @@ -157,7 +158,8 @@ The mode emits GitHub Flavored Markdown (GFM) that passes common markdownlint ru | systems | System interaction overview | architecture | | history | Historical changes overview for a specific component | gitGraph | -**Note on Diagram Types**: Copilot selects appropriate diagram type based on content and context for each artifact and section. Users can specify diagram types explicitly to override it's selection. + +**Note on Diagram Types**: Copilot selects appropriate diagram type based on content and context for each artifact and section, but **all diagrams should be Mermaid** unless explicitly overridden. **Note on Inline vs External Diagrams**: diff --git a/collections/edge-ai-tasks.collection.yml b/collections/edge-ai-tasks.collection.yml new file mode 100644 index 0000000..316e2de --- /dev/null +++ b/collections/edge-ai-tasks.collection.yml @@ -0,0 +1,90 @@ +id: edge-ai-tasks +name: Tasks by microsoft/edge-ai +description: Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai +tags: [architecture, planning, research, tasks, implementation] +items: + # Planning Chat Modes + - path: chatmodes/task-researcher.chatmode.md + kind: chat-mode + usage: | + Now you can iterate on research for your tasks! + + ```markdown, research.prompt.md + --- + mode: task-researcher + title: Research microsoft fabric realtime intelligence terraform support + --- + Review the microsoft documentation for fabric realtime intelligence + and come up with ideas on how to implement this support into our terraform components. + ``` + + Research is dumped out into a .copilot-tracking/research/*-research.md file and will include discoveries for GHCP along with examples and schema that will be useful during implementation. + + Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on. + + - path: chatmodes/task-planner.chatmode.md + kind: chat-mode + usage: | + Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on. + + ```markdown, task-plan.prompt.md + --- + mode: task-planner + title: Plan microsoft fabric realtime intelligence terraform support + --- + #file: .copilot-tracking/research/*-fabric-rti-blueprint-modification-research.md + Build a plan to support adding fabric rti to this project + ``` + + `task-planner` will help you create a plan for implementing your task(s). It will use your fully researched ideas or build new research if not already provided. + + `task-planner` will produce three (3) files that will be used by `task-implementation.instructions.md`. + + * `.copilot-tracking/plan/*-plan.instructions.md` + + * A newly generated instructions file that has the plan as a checklist of Phases and Tasks. + * `.copilot-tracking/details/*-details.md` + + * The details for the implementation, the plan file refers to this file for specific details (important if you have a big plan). + * `.copilot-tracking/prompts/implement-*.prompt.md` + + * A newly generated prompt file that will create a `.copilot-tracking/changes/*-changes.md` file and proceed to implement the changes. + + Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase. + + # Planning Instructions + - path: instructions/task-implementation.instructions.md + kind: instruction + usage: | + Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase. + + When you are ready to implement the plan, **create a new chat** and switch to `Agent` mode then fire off the newly generated prompt. + + ```markdown, implement-fabric-rti-changes.prompt.md + --- + mode: agent + title: Implement microsoft fabric realtime intelligence terraform support + --- + /implement-fabric-rti-blueprint-modification phaseStop=true + ``` + + This prompt has the added benefit of attaching the plan as instructions, which helps with keeping the plan in context throughout the whole conversation. + + **Expert Warning** ->>Use `phaseStop=false` to have Copilot implement the whole plan without stopping. Additionally, you can use `taskStop=true` to have Copilot stop after every Task implementation for finer detail control. + + To use these generated instructions and prompts, you'll need to update your `settings.json` accordingly: + + ```json + "chat.instructionsFilesLocations": { + // Existing instructions folders... + ".copilot-tracking/plans": true + }, + "chat.promptFilesLocations": { + // Existing prompts folders... + ".copilot-tracking/prompts": true + }, + ``` + +display: + ordering: alpha # or "manual" to preserve the order above + show_badge: false # set to true to show collection badge on items diff --git a/collections/edge-ai-tasks.md b/collections/edge-ai-tasks.md new file mode 100644 index 0000000..75559ca --- /dev/null +++ b/collections/edge-ai-tasks.md @@ -0,0 +1,100 @@ +# Tasks by microsoft/edge-ai + +Task Researcher and Task Planner for intermediate to expert users and large codebases - Brought to you by microsoft/edge-ai + +**Tags:** architecture, planning, research, tasks, implementation + +## Items in this Collection + +| Title | Type | Description | +| ----- | ---- | ----------- | +| [Task Researcher Instructions](../chatmodes/task-researcher.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%2Ftask-researcher.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%2Ftask-researcher.chatmode.md) | Chat Mode | Task research specialist for comprehensive project analysis - Brought to you by microsoft/edge-ai [see usage](#task-researcher-instructions) | +| [Task Planner Instructions](../chatmodes/task-planner.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%2Ftask-planner.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%2Ftask-planner.chatmode.md) | Chat Mode | Task planner for creating actionable implementation plans - Brought to you by microsoft/edge-ai [see usage](#task-planner-instructions) | +| [Task Plan Implementation Instructions](../instructions/task-implementation.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%2Ftask-implementation.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%2Ftask-implementation.instructions.md) | Instruction | Instructions for implementing task plans with progressive tracking and change record - Brought to you by microsoft/edge-ai [see usage](#task-plan-implementation-instructions) | + +## Collection Usage + +### Task Researcher Instructions + +Now you can iterate on research for your tasks! + +```markdown, research.prompt.md +--- +mode: task-researcher +title: Research microsoft fabric realtime intelligence terraform support +--- +Review the microsoft documentation for fabric realtime intelligence +and come up with ideas on how to implement this support into our terraform components. +``` + +Research is dumped out into a .copilot-tracking/research/*-research.md file and will include discoveries for GHCP along with examples and schema that will be useful during implementation. + +Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on. + +--- + +### Task Planner Instructions + +Also, task-researcher will provide additional ideas for implementation which you can work with GitHub Copilot on selecting the right one to focus on. + +```markdown, task-plan.prompt.md +--- +mode: task-planner +title: Plan microsoft fabric realtime intelligence terraform support +--- +#file: .copilot-tracking/research/*-fabric-rti-blueprint-modification-research.md +Build a plan to support adding fabric rti to this project +``` + +`task-planner` will help you create a plan for implementing your task(s). It will use your fully researched ideas or build new research if not already provided. + +`task-planner` will produce three (3) files that will be used by `task-implementation.instructions.md`. + +* `.copilot-tracking/plan/*-plan.instructions.md` + + * A newly generated instructions file that has the plan as a checklist of Phases and Tasks. +* `.copilot-tracking/details/*-details.md` + + * The details for the implementation, the plan file refers to this file for specific details (important if you have a big plan). +* `.copilot-tracking/prompts/implement-*.prompt.md` + + * A newly generated prompt file that will create a `.copilot-tracking/changes/*-changes.md` file and proceed to implement the changes. + +Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase. + +--- + +### Task Plan Implementation Instructions + +Continue to use `task-planner` to iterate on the plan until you have exactly what you want done to your codebase. + +When you are ready to implement the plan, **create a new chat** and switch to `Agent` mode then fire off the newly generated prompt. + +```markdown, implement-fabric-rti-changes.prompt.md +--- +mode: agent +title: Implement microsoft fabric realtime intelligence terraform support +--- +/implement-fabric-rti-blueprint-modification phaseStop=true +``` + +This prompt has the added benefit of attaching the plan as instructions, which helps with keeping the plan in context throughout the whole conversation. + +**Expert Warning** ->>Use `phaseStop=false` to have Copilot implement the whole plan without stopping. Additionally, you can use `taskStop=true` to have Copilot stop after every Task implementation for finer detail control. + +To use these generated instructions and prompts, you'll need to update your `settings.json` accordingly: + +```json + "chat.instructionsFilesLocations": { + // Existing instructions folders... + ".copilot-tracking/plans": true + }, + "chat.promptFilesLocations": { + // Existing prompts folders... + ".copilot-tracking/prompts": true + }, +``` + +--- + +*This collection includes 3 curated items for tasks by microsoft/edge-ai.* \ No newline at end of file diff --git a/instructions/astro.instructions.md b/instructions/astro.instructions.md new file mode 100644 index 0000000..af0dc35 --- /dev/null +++ b/instructions/astro.instructions.md @@ -0,0 +1,182 @@ +--- +description: 'Astro development standards and best practices for content-driven websites' +applyTo: '**/*.astro, **/*.ts, **/*.js, **/*.md, **/*.mdx' +--- + +# Astro Development Instructions + +Instructions for building high-quality Astro applications following the content-driven, server-first architecture with modern best practices. + +## Project Context +- Astro 5.x with Islands Architecture and Content Layer API +- TypeScript for type safety and better DX with auto-generated types +- Content-driven websites (blogs, marketing, e-commerce, documentation) +- Server-first rendering with selective client-side hydration +- Support for multiple UI frameworks (React, Vue, Svelte, Solid, etc.) +- Static site generation (SSG) by default with optional server-side rendering (SSR) +- Enhanced performance with modern content loading and build optimizations + +## Development Standards + +### Architecture +- Embrace the Islands Architecture: server-render by default, hydrate selectively +- Organize content with Content Collections for type-safe Markdown/MDX management +- Structure projects by feature or content type for scalability +- Use component-based architecture with clear separation of concerns +- Implement progressive enhancement patterns +- Follow Multi-Page App (MPA) approach over Single-Page App (SPA) patterns + +### TypeScript Integration +- Configure `tsconfig.json` with recommended v5.0 settings: +```json +{ + "extends": "astro/tsconfigs/base", + "include": [".astro/types.d.ts", "**/*"], + "exclude": ["dist"] +} +``` +- Types auto-generated in `.astro/types.d.ts` (replaces `src/env.d.ts`) +- Run `astro sync` to generate/update type definitions +- Define component props with TypeScript interfaces +- Leverage auto-generated types for content collections and Content Layer API + +### Component Design +- Use `.astro` components for static, server-rendered content +- Import framework components (React, Vue, Svelte) only when interactivity is needed +- Follow Astro's component script structure: frontmatter at top, template below +- Use meaningful component names following PascalCase convention +- Keep components focused and composable +- Implement proper prop validation and default values + +### Content Collections + +#### Modern Content Layer API (v5.0+) +- Define collections in `src/content.config.ts` using the new Content Layer API +- Use built-in loaders: `glob()` for file-based content, `file()` for single files +- Leverage enhanced performance and scalability with the new loading system +- Example with Content Layer API: +```typescript +import { defineCollection, z } from 'astro:content'; +import { glob } from 'astro/loaders'; + +const blog = defineCollection({ + loader: glob({ pattern: '**/*.md', base: './src/content/blog' }), + schema: z.object({ + title: z.string(), + pubDate: z.date(), + tags: z.array(z.string()).optional() + }) +}); +``` + +#### Legacy Collections (backward compatible) +- Legacy `type: 'content'` collections still supported via automatic glob() implementation +- Migrate existing collections by adding explicit `loader` configuration +- Use type-safe queries with `getCollection()` and `getEntry()` +- Structure content with frontmatter validation and auto-generated types + +### View Transitions & Client-Side Routing +- Enable with `` component in layout head (renamed from `` in v5.0) +- Import from `astro:transitions`: `import { ClientRouter } from 'astro:transitions'` +- Provides SPA-like navigation without full page reloads +- Customize transition animations with CSS and view-transition-name +- Maintain state across page navigations with persistent islands +- Use `transition:persist` directive to preserve component state + +### Performance Optimization +- Default to zero JavaScript - only add interactivity where needed +- Use client directives strategically (`client:load`, `client:idle`, `client:visible`) +- Implement lazy loading for images and components +- Optimize static assets with Astro's built-in optimization +- Leverage Content Layer API for faster content loading and builds +- Minimize bundle size by avoiding unnecessary client-side JavaScript + +### Styling +- Use scoped styles in `.astro` components by default +- Implement CSS preprocessing (Sass, Less) when needed +- Use CSS custom properties for theming and design systems +- Follow mobile-first responsive design principles +- Ensure accessibility with semantic HTML and proper ARIA attributes +- Consider utility-first frameworks (Tailwind CSS) for rapid development + +### Client-Side Interactivity +- Use framework components (React, Vue, Svelte) for interactive elements +- Choose the right hydration strategy based on user interaction patterns +- Implement state management within framework boundaries +- Handle client-side routing carefully to maintain MPA benefits +- Use Web Components for framework-agnostic interactivity +- Share state between islands using stores or custom events + +### API Routes and SSR +- Create API routes in `src/pages/api/` for dynamic functionality +- Use proper HTTP methods and status codes +- Implement request validation and error handling +- Enable SSR mode for dynamic content requirements +- Use middleware for authentication and request processing +- Handle environment variables securely + +### SEO and Meta Management +- Use Astro's built-in SEO components and meta tag management +- Implement proper Open Graph and Twitter Card metadata +- Generate sitemaps automatically for better search indexing +- Use semantic HTML structure for better accessibility and SEO +- Implement structured data (JSON-LD) for rich snippets +- Optimize page titles and descriptions for search engines + +### Image Optimization +- Use Astro's `` component for automatic optimization +- Implement responsive images with proper srcset generation +- Use WebP and AVIF formats for modern browsers +- Lazy load images below the fold +- Provide proper alt text for accessibility +- Optimize images at build time for better performance + +### Data Fetching +- Fetch data at build time in component frontmatter +- Use dynamic imports for conditional data loading +- Implement proper error handling for external API calls +- Cache expensive operations during build process +- Use Astro's built-in fetch with automatic TypeScript inference +- Handle loading states and fallbacks appropriately + +### Build & Deployment +- Optimize static assets with Astro's built-in optimizations +- Configure deployment for static (SSG) or hybrid (SSR) rendering +- Use environment variables for configuration management +- Enable compression and caching for production builds + +## Key Astro v5.0 Updates + +### Breaking Changes +- **ClientRouter**: Use `` instead of `` +- **TypeScript**: Auto-generated types in `.astro/types.d.ts` (run `astro sync`) +- **Content Layer API**: New `glob()` and `file()` loaders for enhanced performance + +### Migration Example +```typescript +// Modern Content Layer API +import { defineCollection, z } from 'astro:content'; +import { glob } from 'astro/loaders'; + +const blog = defineCollection({ + loader: glob({ pattern: '**/*.md', base: './src/content/blog' }), + schema: z.object({ title: z.string(), pubDate: z.date() }) +}); +``` + +## Implementation Guidelines + +### Development Workflow +1. Use `npm create astro@latest` with TypeScript template +2. Configure Content Layer API with appropriate loaders +3. Set up TypeScript with `astro sync` for type generation +4. Create layout components with Islands Architecture +5. Implement content pages with SEO and performance optimization + +### Astro-Specific Best Practices +- **Islands Architecture**: Server-first with selective hydration using client directives +- **Content Layer API**: Use `glob()` and `file()` loaders for scalable content management +- **Zero JavaScript**: Default to static rendering, add interactivity only when needed +- **View Transitions**: Enable SPA-like navigation with `` +- **Type Safety**: Leverage auto-generated types from Content Collections +- **Performance**: Optimize with built-in image optimization and minimal client bundles diff --git a/instructions/clojure.instructions.md b/instructions/clojure.instructions.md index 52cdb90..b29fbbc 100644 --- a/instructions/clojure.instructions.md +++ b/instructions/clojure.instructions.md @@ -7,7 +7,7 @@ applyTo: '**/*.{clj,cljs,cljc,bb,edn.mdx?}' ## Code Evaluation Tool usage -“Use the repl” means to use the **Evaluate Clojure Code** tool from Calva Backseat Driver. It connects you to the the same REPL as the user is connected to via Calva. +“Use the repl” means to use the **Evaluate Clojure Code** tool from Calva Backseat Driver. It connects you to the same REPL as the user is connected to via Calva. - Always stay inside Calva's REPL instead of launching a second one from the terminal. - If there is no REPL connection, ask the user to connect the REPL instead of trying to start and connect it yourself. @@ -36,12 +36,67 @@ Docstrings belong immediately after the function name and before the argument ve - Define functions before they are used—prefer ordering over `declare` except when truly necessary. +## Interactive Programming (a.k.a. REPL Driven Development) + +### Align Data Structure Elements for Bracket Balancing +**Always align multi-line elements vertically in all data structures: vectors, maps, lists, sets, all code (since Clojure code is data). Misalignment causes the bracket balancer to close brackets incorrectly, creating invalid forms.** + +```clojure +;; ❌ Wrong - misaligned vector elements +(select-keys m [:key-a + :key-b + :key-c]) ; Misalignment → incorrect ] placement + +;; ✅ Correct - aligned vector elements +(select-keys m [:key-a + :key-b + :key-c]) ; Proper alignment → correct ] placement + +;; ❌ Wrong - misaligned map entries +{:name "Alice" + :age 30 +:city "Oslo"} ; Misalignment → incorrect } placement + +;; ✅ Correct - aligned map entries +{:name "Alice" + :age 30 + :city "Oslo"} ; Proper alignment → correct } placement +``` + +**Critical**: The bracket balancer relies on consistent indentation to determine structure. + +### REPL Dependency Management +Use `clojure.repl.deps/add-libs` for dynamic dependency loading during REPL sessions. + +```clojure +(require '[clojure.repl.deps :refer [add-libs]]) +(add-libs '{dk.ative/docjure {:mvn/version "1.15.0"}}) +``` + +- Dynamic dependency loading requires Clojure 1.12 or later +- Perfect for library exploration and prototyping + +### Checking Clojure Version + +```clojure +*clojure-version* +;; => {:major 1, :minor 12, :incremental 1, :qualifier nil} +``` + +### REPL Availability Discipline + +**Never edit code files when the REPL is unavailable.** When REPL evaluation returns errors indicating that the REPL is unavailable, stop immediately and inform the user. Let the user restore REPL before continuing. + +#### Why This Matters +- **Interactive Programming requires a working REPL** - You cannot verify behavior without evaluation +- **Guessing creates bugs** - Code changes without testing introduce errors + ## Structural Editing and REPL-First Habit - Develop changes in the REPL before touching files. - When editing Clojure files, always use structural editing tools such as **Insert Top Level Form**, **Replace Top Level Form**, **Create Clojure File**, and **Append Code**, and always read their instructions first. ### Creating New Files -- Use the **Create Clojure File** tool, with initial content +- Use the **Create Clojure File** tool with initial content - Follow Clojure naming rules: namespaces in kebab-case, file paths in matching snake_case (e.g., `my.project.ns` → `my/project/ns.clj`). ### Reloading Namespaces @@ -51,22 +106,6 @@ After editing files, reload the edited namespace in the REPL so updated definiti (require 'my.namespace :reload) ``` -### Keeping Brackets Balanced -If tools or the compiler signal bracket imbalance, stop and ask for help rather than guessing—use the human-input tool. - -## Interactive Programming with REPL - -When evaluating code during development, always show the complete code being evaluated in a code block before using evaluation tools. The code block should start with the appropriate `(in-ns ...)` form and contain the exact code being evaluated, so the human can run the same code in their REPL. - -Example: -```clojure -(in-ns 'my.namespace) -(let [test-data {:name "example"}] - (process-data test-data)) -``` - -This applies to all REPL-driven development, whether using Calva, Joyride, or other Clojure evaluation tools. - ## Code Indentation Before Evaluation Consistent indentation is crucial to help the bracket balancer. @@ -121,7 +160,7 @@ You can also use "inline def" when showing the user code in the chat, to make it ## Return values > print side effects -Prefer using the repl and return values from your evaluations, over printing things to stdout. +Prefer using the REPL and return values from your evaluations, over printing things to stdout. ## Reading from `stdin` - When Clojure code uses `(read-line)`, it will prompt the user through VS Code. @@ -272,9 +311,9 @@ Iterate with real data before editing files. ``` #### Benefits -- Verified behaviour before committing changes +- Verified behavior before committing changes - Incremental development with immediate feedback -- Tests that capture known-good behaviour +- Tests that capture known-good behavior - Start new work with failing tests to lock in intent ### Test Naming and Messaging @@ -307,3 +346,4 @@ Guidelines: ## Happy Interactive Programming Remember to prefer the REPL in your work. Keep in mind that the user does not see what you evaluate. Nor the results. Communicate with the user in the chat about what you evaluate and what you get back. + diff --git a/instructions/powershell.instructions.md b/instructions/powershell.instructions.md index 3b7cb4d..83be180 100644 --- a/instructions/powershell.instructions.md +++ b/instructions/powershell.instructions.md @@ -1,11 +1,12 @@ --- applyTo: '**/*.ps1,**/*.psm1' description: 'PowerShell cmdlet and scripting best practices based on Microsoft guidelines' ---- +--- # PowerShell Cmdlet Development Guidelines -This guide provides PowerShell-specific instructions to help GitHub Copilot generate idiomatic, safe, and maintainable scripts. It aligns with Microsoft’s PowerShell cmdlet development guidelines. +This guide provides PowerShell-specific instructions to help GitHub Copilot generate idiomatic, +safe, and maintainable scripts. It aligns with Microsoft’s PowerShell cmdlet development guidelines. ## Naming Conventions @@ -87,19 +88,19 @@ function Set-ResourceConfiguration { param( [Parameter(Mandatory)] [string]$Name, - + [Parameter()] [ValidateSet('Dev', 'Test', 'Prod')] [string]$Environment = 'Dev', - + [Parameter()] [switch]$Force, - + [Parameter()] [ValidateNotNullOrEmpty()] [string[]]$Tags ) - + process { # Logic here } @@ -150,32 +151,32 @@ function Update-ResourceStatus { ) begin { - Write-Verbose "Starting resource status update process" + Write-Verbose 'Starting resource status update process' $timestamp = Get-Date } process { # Process each resource individually Write-Verbose "Processing resource: $Name" - + $resource = [PSCustomObject]@{ - Name = $Name - Status = $Status + Name = $Name + Status = $Status LastUpdated = $timestamp - UpdatedBy = $env:USERNAME + UpdatedBy = $env:USERNAME } # Only output if PassThru is specified - if ($PassThru) { + if ($PassThru.IsPresent) { Write-Output $resource } } end { - Write-Verbose "Resource status update process completed" + Write-Verbose 'Resource status update process completed' } } - ``` +``` ## Error Handling and Safety @@ -198,6 +199,9 @@ function Update-ResourceStatus { - Return meaningful error messages - Use ErrorVariable when needed - Include proper terminating vs non-terminating error handling + - In advanced functions with `[CmdletBinding()]`, prefer `$PSCmdlet.WriteError()` over `Write-Error` + - In advanced functions with `[CmdletBinding()]`, prefer `$PSCmdlet.ThrowTerminatingError()` over `throw` + - Construct proper ErrorRecord objects with category, target, and exception details - **Non-Interactive Design:** - Accept input via parameters @@ -220,7 +224,7 @@ function Remove-UserAccount { ) begin { - Write-Verbose "Starting user account removal process" + Write-Verbose 'Starting user account removal process' $ErrorActionPreference = 'Stop' } @@ -228,7 +232,13 @@ function Remove-UserAccount { try { # Validation if (-not (Test-UserExists -Username $Username)) { - Write-Error "User account '$Username' not found" + $errorRecord = [System.Management.Automation.ErrorRecord]::new( + [System.Exception]::new("User account '$Username' not found"), + 'UserNotFound', + [System.Management.Automation.ErrorCategory]::ObjectNotFound, + $Username + ) + $PSCmdlet.WriteError($errorRecord) return } @@ -236,24 +246,32 @@ function Remove-UserAccount { $shouldProcessMessage = "Remove user account '$Username'" if ($Force -or $PSCmdlet.ShouldProcess($Username, $shouldProcessMessage)) { Write-Verbose "Removing user account: $Username" - + # Main operation Remove-ADUser -Identity $Username -ErrorAction Stop Write-Warning "User account '$Username' has been removed" } - } - catch [Microsoft.ActiveDirectory.Management.ADException] { - Write-Error "Active Directory error: $_" - throw - } - catch { - Write-Error "Unexpected error removing user account: $_" - throw + } catch [Microsoft.ActiveDirectory.Management.ADException] { + $errorRecord = [System.Management.Automation.ErrorRecord]::new( + $_.Exception, + 'ActiveDirectoryError', + [System.Management.Automation.ErrorCategory]::NotSpecified, + $Username + ) + $PSCmdlet.ThrowTerminatingError($errorRecord) + } catch { + $errorRecord = [System.Management.Automation.ErrorRecord]::new( + $_.Exception, + 'UnexpectedError', + [System.Management.Automation.ErrorCategory]::NotSpecified, + $Username + ) + $PSCmdlet.ThrowTerminatingError($errorRecord) } } end { - Write-Verbose "User account removal process completed" + Write-Verbose 'User account removal process completed' } } ``` @@ -296,8 +314,8 @@ function New-Resource { [CmdletBinding(SupportsShouldProcess = $true, ConfirmImpact = 'Medium')] param( [Parameter(Mandatory = $true, - ValueFromPipeline = $true, - ValueFromPipelineByPropertyName = $true)] + ValueFromPipeline = $true, + ValueFromPipelineByPropertyName = $true)] [ValidateNotNullOrEmpty()] [string]$Name, @@ -305,29 +323,34 @@ function New-Resource { [ValidateSet('Development', 'Production')] [string]$Environment = 'Development' ) - + begin { - Write-Verbose "Starting resource creation process" + Write-Verbose 'Starting resource creation process' } - + process { try { - if ($PSCmdlet.ShouldProcess($Name, "Create new resource")) { + if ($PSCmdlet.ShouldProcess($Name, 'Create new resource')) { # Resource creation logic here Write-Output ([PSCustomObject]@{ - Name = $Name - Environment = $Environment - Created = Get-Date - }) + Name = $Name + Environment = $Environment + Created = Get-Date + }) } - } - catch { - Write-Error "Failed to create resource: $_" + } catch { + $errorRecord = [System.Management.Automation.ErrorRecord]::new( + $_.Exception, + 'ResourceCreationFailed', + [System.Management.Automation.ErrorCategory]::NotSpecified, + $Name + ) + $PSCmdlet.ThrowTerminatingError($errorRecord) } } - + end { - Write-Verbose "Completed resource creation process" + Write-Verbose 'Completed resource creation process' } } ``` diff --git a/instructions/svelte.instructions.md b/instructions/svelte.instructions.md new file mode 100644 index 0000000..646b4ba --- /dev/null +++ b/instructions/svelte.instructions.md @@ -0,0 +1,161 @@ +--- +description: 'Svelte 5 and SvelteKit development standards and best practices for component-based user interfaces and full-stack applications' +applyTo: '**/*.svelte, **/*.ts, **/*.js, **/*.css, **/*.scss, **/*.json' +--- + +# Svelte 5 and SvelteKit Development Instructions + +Instructions for building high-quality Svelte 5 and SvelteKit applications with modern runes-based reactivity, TypeScript, and performance optimization. + +## Project Context +- Svelte 5.x with runes system ($state, $derived, $effect, $props, $bindable) +- SvelteKit for full-stack applications with file-based routing +- TypeScript for type safety and better developer experience +- Component-scoped styling with CSS custom properties +- Progressive enhancement and performance-first approach +- Modern build tooling (Vite) with optimizations + +## Development Standards + +### Architecture +- Use Svelte 5 runes system for all reactivity instead of legacy stores +- Organize components by feature or domain for scalability +- Separate presentation components from logic-heavy components +- Extract reusable logic into composable functions +- Implement proper component composition with slots and snippets +- Use SvelteKit's file-based routing with proper load functions + +### TypeScript Integration +- Enable strict mode in `tsconfig.json` for maximum type safety +- Define interfaces for component props using `$props()` syntax +- Type event handlers, refs, and SvelteKit's generated types +- Use generic types for reusable components +- Leverage `$types.ts` files generated by SvelteKit +- Implement proper type checking with `svelte-check` + +### Component Design +- Follow single responsibility principle for components +- Use `