Delete outdated development instructions for Next.js + Tailwind and Python; add comprehensive guidelines for PostgreSQL DBA, Angular, ASP.NET REST APIs, Azure Functions with TypeScript, Bicep, Blazor, CMake with vcpkg, C#, .NET MAUI, GenAIScript, Terraform for Azure, localization, and markdown standards.

This commit is contained in:
James Montemagno 2025-07-02 15:18:54 -07:00
parent 24e1b59cdb
commit a0754dd249
17 changed files with 34 additions and 29 deletions

View File

@ -21,21 +21,21 @@ We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md)
Team and project-specific instructions to enhance GitHub Copilot's behavior for specific technologies and coding practices: Team and project-specific instructions to enhance GitHub Copilot's behavior for specific technologies and coding practices:
- [Angular Development Instructions](instructions/angular.md) - Angular-specific coding standards and best practices - [Angular Development Instructions](instructions/angular.instructions.md) - Angular-specific coding standards and best practices
- [ASP.NET REST API Development](instructions/aspnet-rest-apis.md) - Guidelines for building REST APIs with ASP.NET - [ASP.NET REST API Development](instructions/aspnet-rest-apis.instructions.md) - Guidelines for building REST APIs with ASP.NET
- [Azure Functions Typescript](instructions/azure-functions-typescript.md) - TypeScript patterns for Azure Functions - [Azure Functions Typescript](instructions/azure-functions-typescript.instructions.md) - TypeScript patterns for Azure Functions
- [Bicep Code Best Practices](instructions/bicep-code-best-practices.md) - Infrastructure as Code with Bicep - [Bicep Code Best Practices](instructions/bicep-code-best-practices.instructions.md) - Infrastructure as Code with Bicep
- [Blazor](instructions/blazor.md) - Blazor component and application patterns - [Blazor](instructions/blazor.instructions.md) - Blazor component and application patterns
- [Cmake Vcpkg](instructions/cmake-vcpkg.md) - C++ project configuration and package management - [Cmake Vcpkg](instructions/cmake-vcpkg.instructions.md) - C++ project configuration and package management
- [Copilot Process tracking Instructions](instructions/copilot-thought-logging.instructions.md) - See process Copilot is following where you can edit this to reshape the interaction or save when follow up may be needed - [Copilot Process tracking Instructions](instructions/copilot-thought-logging.instructions.md) - See process Copilot is following where you can edit this to reshape the interaction or save when follow up may be needed
- [C# Development](instructions/csharp.md) - Guidelines for building C# applications - [C# Development](instructions/csharp.instructions.md) - Guidelines for building C# applications
- [Dotnet Maui](instructions/dotnet-maui.md) - MAUI component and application patterns - [Dotnet Maui](instructions/dotnet-maui.instructions.md) - MAUI component and application patterns
- [Genaiscript](instructions/genaiscript.md) - AI-powered script generation guidelines - [Genaiscript](instructions/genaiscript.instructions.md) - AI-powered script generation guidelines
- [Generate Modern Terraform Code For Azure](instructions/generate-modern-terraform-code-for-azure.md) - Guidelines for generating modern Terraform code for Azure - [Generate Modern Terraform Code For Azure](instructions/generate-modern-terraform-code-for-azure.instructions.md) - Guidelines for generating modern Terraform code for Azure
- [Guidance for Localization](instructions/localization.md) - Guidelines for localizing markdown documents - [Guidance for Localization](instructions/localization.instructions.md) - Guidelines for localizing markdown documents
- [Markdown](instructions/markdown.md) - Documentation and content creation standards - [Markdown](instructions/markdown.instructions.md) - Documentation and content creation standards
- [Next.js + Tailwind Development Instructions](instructions/nextjs-tailwind.md) - Next.js + Tailwind development standards and instructions - [Next.js + Tailwind Development Instructions](instructions/nextjs-tailwind.instructions.md) - Next.js + Tailwind development standards and instructions
- [Python Coding Conventions](instructions/python.md) - Python coding conventions and guidelines - [Python Coding Conventions](instructions/python.instructions.md) - Python coding conventions and guidelines
> 💡 **Usage**: Copy these instructions to your `.github/copilot-instructions.md` file or create task-specific `.github/.instructions.md` files in your workspace's `.github/instructions` folder. > 💡 **Usage**: Copy these instructions to your `.github/copilot-instructions.md` file or create task-specific `.github/.instructions.md` files in your workspace's `.github/instructions` folder.
@ -72,8 +72,8 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi
Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, enabling enhanced context-aware assistance for particular tasks or workflows. Custom chat modes define specific behaviors and tools for GitHub Copilot Chat, enabling enhanced context-aware assistance for particular tasks or workflows.
- [4.1 Beast Mode](chatmodes/4.1-Beast.chatmode.md) - A custom prompt to get GPT 4.1 to behave like a top-notch coding agent. - [4.1 Beast Mode](chatmodes/4.1-beast.chatmode.md) - A custom prompt to get GPT 4.1 to behave like a top-notch coding agent.
- [Database Administrator Chat Mode](chatmodes/PostgreSQL%20DBA.chatmode.md) - Work with PostgreSQL databases using the PostgreSQL extension. - [Database Administrator Chat Mode](chatmodes/postgresql-dba.chatmode.md) - Work with PostgreSQL databases using the PostgreSQL extension.
- [Debug Mode Instructions](chatmodes/debug.chatmode.md) - Debug your application to find and fix a bug - [Debug Mode Instructions](chatmodes/debug.chatmode.md) - Debug your application to find and fix a bug
- [Planning mode instructions](chatmodes/planner.chatmode.md) - Generate an implementation plan for new features or refactoring existing code. - [Planning mode instructions](chatmodes/planner.chatmode.md) - Generate an implementation plan for new features or refactoring existing code.
- [Refine Requirement or Issue Chat Mode](chatmodes/refine-issue.chatmode.md) - Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs - [Refine Requirement or Issue Chat Mode](chatmodes/refine-issue.chatmode.md) - Refine the requirement or issue with Acceptance Criteria, Technical Considerations, Edge Cases, and NFRs

View File

@ -1,6 +1,6 @@
--- ---
description: | description: Angular-specific coding standards and best practices
Angular-specific coding standards and best practices applyTo: "**/*.ts, **/*.html, **/*.scss, **/*.css"
--- ---
# Angular Development Instructions # Angular Development Instructions

View File

@ -1,5 +1,6 @@
--- ---
description: Guidelines for building REST APIs with ASP.NET description: Guidelines for building REST APIs with ASP.NET
applyTo: "**/*.cs, **/*.json"
--- ---
# ASP.NET REST API Development # ASP.NET REST API Development

View File

@ -1,5 +1,6 @@
--- ---
description: TypeScript patterns for Azure Functions description: TypeScript patterns for Azure Functions
applyTo: "**/*.ts, **/*.js, **/*.json"
--- ---
## Guidance for Code Generation ## Guidance for Code Generation

View File

@ -1,5 +1,6 @@
--- ---
description: C++ project configuration and package management description: C++ project configuration and package management
applyTo: "**/*.cmake, **/CMakeLists.txt, **/*.cpp, **/*.h, **/*.hpp"
--- ---
This project uses vcpkg in manifest mode. Please keep this in mind when giving vcpkg suggestions. Do not provide suggestions like vcpkg install library, as they will not work as expected. This project uses vcpkg in manifest mode. Please keep this in mind when giving vcpkg suggestions. Do not provide suggestions like vcpkg install library, as they will not work as expected.

View File

@ -1,6 +1,5 @@
--- ---
applyTo: '**' applyTo: '**'
mode: "agent"
description: 'See process Copilot is following where you can edit this to reshape the interaction or save when follow up may be needed' description: 'See process Copilot is following where you can edit this to reshape the interaction or save when follow up may be needed'
--- ---

View File

@ -1,5 +1,6 @@
--- ---
description: Guidelines for building C# applications description: Guidelines for building C# applications
applyTo: "**/*.cs"
--- ---
# C# Development # C# Development

View File

@ -1,12 +1,12 @@
--- ---
description: MAUI component and application patterns description: .NET MAUI component and application patterns
appliesTo: "**/*.xaml, **/*.cs" applyTo: "**/*.xaml, **/*.cs"
--- ---
## MAUI Code Style and Structure ## .NET MAUI Code Style and Structure
- Write idiomatic and efficient MAUI and C# code. - Write idiomatic and efficient .NET MAUI and C# code.
- Follow .NET and MAUI conventions. - Follow .NET and .NET MAUI conventions.
- Prefer inline functions for smaller components but separate complex logic into code-behind or service classes. - Prefer inline functions for smaller components but separate complex logic into code-behind or service classes.
- Async/await should be used where applicable to ensure non-blocking UI operations. - Async/await should be used where applicable to ensure non-blocking UI operations.
@ -16,16 +16,16 @@ appliesTo: "**/*.xaml, **/*.cs"
- Use camelCase for private fields and local variables. - Use camelCase for private fields and local variables.
- Prefix interface names with "I" (e.g., IUserService). - Prefix interface names with "I" (e.g., IUserService).
## MAUI and .NET Specific Guidelines ## .NET MAUI and .NET Specific Guidelines
- Utilize MAUI's built-in features for component lifecycle (e.g. OnAppearing, OnDisappearing). - Utilize .NET MAUI's built-in features for component lifecycle (e.g. OnAppearing, OnDisappearing).
- Use data binding effectively with {Binding}. - Use data binding effectively with {Binding}.
- Structure MAUI components and services following Separation of Concerns. - Structure .NET MAUI components and services following Separation of Concerns.
- Always use the latest version C#, currently C# 13 features like record types, pattern matching, and global usings. - Always use the latest version C#, currently C# 13 features like record types, pattern matching, and global usings.
## Error Handling and Validation ## Error Handling and Validation
- Implement proper error handling for MAUI pages and API calls. - Implement proper error handling for .NET MAUI pages and API calls.
- Use logging for error tracking in the backend and consider capturing UI-level errors in MAUI with tools like MAUI Community Toolkit's Logger. - Use logging for error tracking in the backend and consider capturing UI-level errors in MAUI with tools like MAUI Community Toolkit's Logger.
- Implement validation using FluentValidation or DataAnnotations in forms. - Implement validation using FluentValidation or DataAnnotations in forms.

View File

@ -1,6 +1,6 @@
--- ---
applyTo: "**/*.genai.*"
description: AI-powered script generation guidelines description: AI-powered script generation guidelines
applyTo: "**/*.genai.*"
--- ---
## Role ## Role

View File

@ -1,5 +1,6 @@
--- ---
description: Next.js + Tailwind development standards and instructions description: Next.js + Tailwind development standards and instructions
applyTo: "**/*.tsx, **/*.ts, **/*.jsx, **/*.js, **/*.css"
--- ---
# Next.js + Tailwind Development Instructions # Next.js + Tailwind Development Instructions

View File

@ -1,5 +1,6 @@
--- ---
description: Python coding conventions and guidelines description: Python coding conventions and guidelines
applyTo: "**/*.py"
--- ---
# Python Coding Conventions # Python Coding Conventions