From 6ecd0098cfe61b6d6fa9262d04338d7e90aa4258 Mon Sep 17 00:00:00 2001 From: Aaron Powell Date: Mon, 16 Feb 2026 12:05:48 +1100 Subject: [PATCH] Remove collections folder and migrate remaining references to plugins - Remove rug-agentic-workflow collection files (already migrated to plugin) - Remove collections.instructions.md (no longer applicable) - Remove suggest-awesome-github-copilot-collections prompt and plugin command - Update awesome-copilot plugin.json to reference skills prompt instead of collections - Update contributor-report.mjs to track plugins instead of collections - Remove unused collection constants from constants.mjs - Update rug-agentic-workflow plugin.json with tags and items from collection - Regenerate README docs and marketplace.json --- .github/plugin/marketplace.json | 2 +- .../rug-agentic-workflow.collection.yml | 31 --- collections/rug-agentic-workflow.md | 37 ---- docs/README.instructions.md | 1 - docs/README.plugins.md | 3 +- docs/README.prompts.md | 1 - eng/constants.mjs | 21 -- eng/contributor-report.mjs | 6 +- instructions/collections.instructions.md | 54 ------ .../.github/plugin/plugin.json | 4 +- ...gest-awesome-github-copilot-collections.md | 1 - .../.github/plugin/plugin.json | 24 ++- ...esome-github-copilot-collections.prompt.md | 183 ------------------ 13 files changed, 30 insertions(+), 338 deletions(-) delete mode 100644 collections/rug-agentic-workflow.collection.yml delete mode 100644 collections/rug-agentic-workflow.md delete mode 100644 instructions/collections.instructions.md delete mode 120000 plugins/awesome-copilot/commands/suggest-awesome-github-copilot-collections.md delete mode 100644 prompts/suggest-awesome-github-copilot-collections.prompt.md diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json index 60f8331c..89b12fcb 100644 --- a/.github/plugin/marketplace.json +++ b/.github/plugin/marketplace.json @@ -13,7 +13,7 @@ { "name": "awesome-copilot", "source": "./plugins/awesome-copilot", - "description": "Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills.", + "description": "Meta prompts that help you discover and generate curated GitHub Copilot agents, instructions, prompts, and skills.", "version": "1.0.0" }, { diff --git a/collections/rug-agentic-workflow.collection.yml b/collections/rug-agentic-workflow.collection.yml deleted file mode 100644 index b94a5922..00000000 --- a/collections/rug-agentic-workflow.collection.yml +++ /dev/null @@ -1,31 +0,0 @@ -id: rug-agentic-workflow -name: RUG Agentic Workflow -description: Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. -tags: [agentic-workflow, orchestration, subagents, software-engineering, qa] -items: - - path: agents/rug-orchestrator.agent.md - kind: agent - usage: | - recommended - - This workflow is designed as a coordinated trio: - - `RUG` orchestrates decomposition, delegation, and validation loops. - - `SWE` executes implementation tasks. - - `QA` validates requirements, edge cases, and regressions. - - Typical usage: - 1. Start with `RUG` for multi-step tasks. - 2. Let `RUG` delegate coding to `SWE`. - 3. Let `RUG` delegate verification to `QA`. - - Best results: - - Keep each delegated task narrowly scoped. - - Require explicit acceptance criteria per task. - - Run a final cross-task validation pass before completion. - - path: agents/swe-subagent.agent.md - kind: agent - - path: agents/qa-subagent.agent.md - kind: agent -display: - ordering: manual - show_badge: false diff --git a/collections/rug-agentic-workflow.md b/collections/rug-agentic-workflow.md deleted file mode 100644 index 7d62b806..00000000 --- a/collections/rug-agentic-workflow.md +++ /dev/null @@ -1,37 +0,0 @@ -# RUG Agentic Workflow - -Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. - -**Tags:** agentic-workflow, orchestration, subagents, software-engineering, qa - -## Items in this Collection - -| Title | Type | Description | MCP Servers | -| ----- | ---- | ----------- | ----------- | -| [RUG](../agents/rug-orchestrator.agent.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/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frug-orchestrator.agent.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/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Frug-orchestrator.agent.md) | Agent | Pure orchestration agent that decomposes requests, delegates all work to subagents, validates outcomes, and repeats until complete. [see usage](#rug) | | -| [SWE](../agents/swe-subagent.agent.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/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fswe-subagent.agent.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/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fswe-subagent.agent.md) | Agent | Senior software engineer subagent for implementation tasks: feature development, debugging, refactoring, and testing. | | -| [QA](../agents/qa-subagent.agent.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/agent?url=vscode%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fqa-subagent.agent.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/agent?url=vscode-insiders%3Achat-agent%2Finstall%3Furl%3Dhttps%3A%2F%2Fraw.githubusercontent.com%2Fgithub%2Fawesome-copilot%2Fmain%2Fagents%2Fqa-subagent.agent.md) | Agent | Meticulous QA subagent for test planning, bug hunting, edge-case analysis, and implementation verification. | | - -## Collection Usage - -### RUG - -recommended - -This workflow is designed as a coordinated trio: -- `RUG` orchestrates decomposition, delegation, and validation loops. -- `SWE` executes implementation tasks. -- `QA` validates requirements, edge cases, and regressions. - -Typical usage: -1. Start with `RUG` for multi-step tasks. -2. Let `RUG` delegate coding to `SWE`. -3. Let `RUG` delegate verification to `QA`. - -Best results: -- Keep each delegated task narrowly scoped. -- Require explicit acceptance criteria per task. -- Run a final cross-task validation pass before completion. - ---- - diff --git a/docs/README.instructions.md b/docs/README.instructions.md index f419c8b9..64bd49ac 100644 --- a/docs/README.instructions.md +++ b/docs/README.instructions.md @@ -50,7 +50,6 @@ Team and project-specific instructions to enhance GitHub Copilot's behavior for | [Codexer Instructions](../instructions/codexer.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%2Fcodexer.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%2Fcodexer.instructions.md) | Advanced Python research assistant with Context 7 MCP integration, focusing on speed, reliability, and 10+ years of software development expertise | | [ColdFusion Coding Standards](../instructions/coldfusion-cfm.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%2Fcoldfusion-cfm.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%2Fcoldfusion-cfm.instructions.md) | ColdFusion cfm files and application patterns | | [ColdFusion Coding Standards for CFC Files](../instructions/coldfusion-cfc.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%2Fcoldfusion-cfc.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%2Fcoldfusion-cfc.instructions.md) | ColdFusion Coding Standards for CFC component and application patterns | -| [Collections Development](../instructions/collections.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%2Fcollections.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%2Fcollections.instructions.md) | Guidelines for creating and managing awesome-copilot collections | | [Comprehensive Guide: Converting Spring Boot Cassandra Applications to use Azure Cosmos DB with Spring Data Cosmos (spring-data-cosmos)](../instructions/convert-cassandra-to-spring-data-cosmos.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%2Fconvert-cassandra-to-spring-data-cosmos.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%2Fconvert-cassandra-to-spring-data-cosmos.instructions.md) | Step-by-step guide for converting Spring Boot Cassandra applications to use Azure Cosmos DB with Spring Data Cosmos | | [Containerization & Docker Best Practices](../instructions/containerization-docker-best-practices.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%2Fcontainerization-docker-best-practices.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%2Fcontainerization-docker-best-practices.instructions.md) | Comprehensive best practices for creating optimized, secure, and efficient Docker images and managing containers. Covers multi-stage builds, image layer optimization, security scanning, and runtime best practices. | | [Context Engineering](../instructions/context-engineering.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%2Fcontext-engineering.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%2Fcontext-engineering.instructions.md) | Guidelines for structuring code and projects to maximize GitHub Copilot effectiveness through better context management | diff --git a/docs/README.plugins.md b/docs/README.plugins.md index 869514fc..0b558723 100644 --- a/docs/README.plugins.md +++ b/docs/README.plugins.md @@ -16,7 +16,7 @@ Curated plugins of related prompts, agents, and skills organized around specific | Name | Description | Items | Tags | | ---- | ----------- | ----- | ---- | -| [⭐ awesome-copilot](../plugins/awesome-copilot/README.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills. | 5 items | github-copilot, discovery, meta, prompt-engineering, agents | +| [⭐ awesome-copilot](../plugins/awesome-copilot/README.md) | Meta prompts that help you discover and generate curated GitHub Copilot agents, instructions, prompts, and skills. | 5 items | github-copilot, discovery, meta, prompt-engineering, agents | | [⭐ copilot-sdk](../plugins/copilot-sdk/README.md) | Build applications with the GitHub Copilot SDK across multiple programming languages. Includes comprehensive instructions for C#, Go, Node.js/TypeScript, and Python to help you create AI-powered applications. | 5 items | copilot-sdk, sdk, csharp, go, nodejs, typescript, python, ai, github-copilot | | [⭐ partners](../plugins/partners/README.md) | Custom agents that have been created by GitHub partners | 20 items | devops, security, database, cloud, infrastructure, observability, feature-flags, cicd, migration, performance | | [azure-cloud-development](../plugins/azure-cloud-development/README.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization for building scalable cloud applications. | 18 items | azure, cloud, infrastructure, bicep, terraform, serverless, architecture, devops | @@ -50,6 +50,7 @@ Curated plugins of related prompts, agents, and skills organized around specific | [project-planning](../plugins/project-planning/README.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 | | [python-mcp-development](../plugins/python-mcp-development/README.md) | Complete toolkit for building Model Context Protocol (MCP) servers in Python using the official SDK with FastMCP. Includes instructions for best practices, a prompt for generating servers, and an expert chat mode for guidance. | 3 items | python, mcp, model-context-protocol, fastmcp, server-development | | [ruby-mcp-development](../plugins/ruby-mcp-development/README.md) | Complete toolkit for building Model Context Protocol servers in Ruby using the official MCP Ruby SDK gem with Rails integration support. | 3 items | ruby, mcp, model-context-protocol, server-development, sdk, rails, gem | +| [rug-agentic-workflow](../plugins/rug-agentic-workflow/README.md) | Three-agent workflow for orchestrated software delivery with an orchestrator plus implementation and QA subagents. | 3 items | agentic-workflow, orchestration, subagents, software-engineering, qa | | [rust-mcp-development](../plugins/rust-mcp-development/README.md) | Build high-performance Model Context Protocol servers in Rust using the official rmcp SDK with async/await, procedural macros, and type-safe implementations. | 3 items | rust, mcp, model-context-protocol, server-development, sdk, tokio, async, macros, rmcp | | [security-best-practices](../plugins/security-best-practices/README.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 | | [software-engineering-team](../plugins/software-engineering-team/README.md) | 7 specialized agents covering the full software development lifecycle from UX design and architecture to security and DevOps. | 7 items | team, enterprise, security, devops, ux, architecture, product, ai-ethics | diff --git a/docs/README.prompts.md b/docs/README.prompts.md index 573a9892..c618c44c 100644 --- a/docs/README.prompts.md +++ b/docs/README.prompts.md @@ -137,7 +137,6 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi | [Spring Boot with Kotlin Best Practices](../prompts/kotlin-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%2Fkotlin-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%2Fkotlin-springboot.prompt.md) | Get best practices for developing applications with Spring Boot and Kotlin. | | [SQL Code Review](../prompts/sql-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%2Fsql-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%2Fsql-code-review.prompt.md) | Universal SQL code review assistant that performs comprehensive security, maintainability, and code quality analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Focuses on SQL injection prevention, access control, code standards, and anti-pattern detection. Complements SQL optimization prompt for complete development coverage. | | [SQL Performance Optimization Assistant](../prompts/sql-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%2Fsql-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%2Fsql-optimization.prompt.md) | Universal SQL performance optimization assistant for comprehensive query tuning, indexing strategies, and database performance analysis across all SQL databases (MySQL, PostgreSQL, SQL Server, Oracle). Provides execution plan analysis, pagination optimization, batch operations, and performance monitoring guidance. | -| [Suggest Awesome GitHub Copilot Collections](../prompts/suggest-awesome-github-copilot-collections.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%2Fsuggest-awesome-github-copilot-collections.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%2Fsuggest-awesome-github-copilot-collections.prompt.md) | Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates. | | [Suggest Awesome GitHub Copilot Custom Agents](../prompts/suggest-awesome-github-copilot-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%2Fsuggest-awesome-github-copilot-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%2Fsuggest-awesome-github-copilot-agents.prompt.md) | Suggest relevant GitHub Copilot Custom Agents files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing custom agents in this repository, and identifying outdated agents that need updates. | | [Suggest Awesome GitHub Copilot Instructions](../prompts/suggest-awesome-github-copilot-instructions.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%2Fsuggest-awesome-github-copilot-instructions.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%2Fsuggest-awesome-github-copilot-instructions.prompt.md) | Suggest relevant GitHub Copilot instruction files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing instructions in this repository, and identifying outdated instructions that need updates. | | [Suggest Awesome GitHub Copilot Prompts](../prompts/suggest-awesome-github-copilot-prompts.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%2Fsuggest-awesome-github-copilot-prompts.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%2Fsuggest-awesome-github-copilot-prompts.prompt.md) | Suggest relevant GitHub Copilot prompt files from the awesome-copilot repository based on current repository context and chat history, avoiding duplicates with existing prompts in this repository, and identifying outdated prompts that need updates. | diff --git a/eng/constants.mjs b/eng/constants.mjs index 6c7cccb8..1f1e95ec 100644 --- a/eng/constants.mjs +++ b/eng/constants.mjs @@ -36,27 +36,6 @@ Ready-to-use prompt templates for specific development scenarios and tasks, defi - Run the \`Chat: Run Prompt\` command from the Command Palette - Hit the run button while you have a prompt file open in VS Code`, - collectionsSection: `## 📦 Collections - -Curated collections of related prompts, instructions, and agents organized around specific themes, workflows, or use cases.`, - - collectionsUsage: `### How to Use Collections - -**Browse Collections:** -- ⭐ Featured collections are highlighted and appear at the top of the list -- Explore themed collections that group related customizations -- Each collection includes prompts, instructions, and agents for specific workflows -- Collections make it easy to adopt comprehensive toolkits for particular scenarios - -**Install Items:** -- Click install buttons for individual items within collections -- Or browse to the individual files to copy content manually -- Collections help you discover related customizations you might have missed`, - - featuredCollectionsSection: `## 🌟 Featured Collections - -Discover our curated collections of prompts, instructions, and agents organized around specific themes and workflows.`, - pluginsSection: `## 🔌 Plugins Curated plugins of related prompts, agents, and skills organized around specific themes, workflows, or use cases. Plugins can be installed directly via GitHub Copilot CLI.`, diff --git a/eng/contributor-report.mjs b/eng/contributor-report.mjs index 0e72282e..fb983be6 100644 --- a/eng/contributor-report.mjs +++ b/eng/contributor-report.mjs @@ -19,8 +19,6 @@ setupGracefulShutdown('contributor-report'); export const AUTO_GENERATED_PATTERNS = [ 'README.md', 'README.*.md', - 'collections/*.md', - 'collections/*.collection.md', 'docs/README.*.md', 'docs/*.generated.md' ]; @@ -42,8 +40,8 @@ export const TYPE_PATTERNS = { skills: [ 'skills/' ], - collections: [ - 'collections/*.collection.yml' + plugins: [ + 'plugins/**/plugin.json' ], doc: [ 'docs/**/*.md', diff --git a/instructions/collections.instructions.md b/instructions/collections.instructions.md deleted file mode 100644 index 608c5d99..00000000 --- a/instructions/collections.instructions.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -description: 'Guidelines for creating and managing awesome-copilot collections' -applyTo: 'collections/*.collection.yml' ---- - -# Collections Development - -## Collection Instructions - -When working with collections in the awesome-copilot repository: - -- Always validate collections using `node validate-collections.js` before committing -- Follow the established YAML schema for collection manifests -- Reference only existing files in the repository -- Use descriptive collection IDs with lowercase letters, numbers, and hyphens -- Keep collections focused on specific workflows or themes -- Test that all referenced items work well together - -## Collection Structure - -- **Required fields**: id, name, description, items -- **Optional fields**: tags, display -- **Item requirements**: path must exist, kind must match file extension -- **Display options**: ordering (alpha/manual), show_badge (true/false) - -## Validation Rules - -- Collection IDs must be unique across all collections -- File paths must exist and match the item kind -- Tags must use lowercase letters, numbers, and hyphens only -- Collections must contain 1-50 items -- Descriptions must be 1-500 characters - -## Best Practices - -- Group 3-10 related items for optimal usability -- Use clear, descriptive names and descriptions -- Add relevant tags for discoverability -- Test the complete workflow the collection enables -- Ensure items complement each other effectively - -## File Organization - -- Collections don't require file reorganization -- Items can be located anywhere in the repository -- Use relative paths from repository root -- Maintain existing directory structure (prompts/, instructions/, agents/) - -## Generation Process - -- Collections automatically generate README files via `npm start` -- Individual collection pages are created in collections/ directory -- Main collections overview is generated as README.collections.md -- VS Code install badges are automatically created for each item diff --git a/plugins/awesome-copilot/.github/plugin/plugin.json b/plugins/awesome-copilot/.github/plugin/plugin.json index aa5edc69..12e33731 100644 --- a/plugins/awesome-copilot/.github/plugin/plugin.json +++ b/plugins/awesome-copilot/.github/plugin/plugin.json @@ -1,6 +1,6 @@ { "name": "awesome-copilot", - "description": "Meta prompts that help you discover and generate curated GitHub Copilot agents, collections, instructions, prompts, and skills.", + "description": "Meta prompts that help you discover and generate curated GitHub Copilot agents, instructions, prompts, and skills.", "version": "1.0.0", "author": { "name": "Awesome Copilot Community" @@ -21,7 +21,7 @@ }, "items": [ { - "path": "prompts/suggest-awesome-github-copilot-collections.prompt.md", + "path": "prompts/suggest-awesome-github-copilot-skills.prompt.md", "kind": "prompt" }, { diff --git a/plugins/awesome-copilot/commands/suggest-awesome-github-copilot-collections.md b/plugins/awesome-copilot/commands/suggest-awesome-github-copilot-collections.md deleted file mode 120000 index 0fcbc578..00000000 --- a/plugins/awesome-copilot/commands/suggest-awesome-github-copilot-collections.md +++ /dev/null @@ -1 +0,0 @@ -../../../prompts/suggest-awesome-github-copilot-collections.prompt.md \ No newline at end of file diff --git a/plugins/rug-agentic-workflow/.github/plugin/plugin.json b/plugins/rug-agentic-workflow/.github/plugin/plugin.json index 25f01800..68aed1ec 100644 --- a/plugins/rug-agentic-workflow/.github/plugin/plugin.json +++ b/plugins/rug-agentic-workflow/.github/plugin/plugin.json @@ -6,5 +6,27 @@ "name": "Awesome Copilot Community" }, "repository": "https://github.com/github/awesome-copilot", - "license": "MIT" + "license": "MIT", + "tags": [ + "agentic-workflow", + "orchestration", + "subagents", + "software-engineering", + "qa" + ], + "items": [ + { + "path": "agents/rug-orchestrator.agent.md", + "kind": "agent", + "usage": "recommended\n\nThis workflow is designed as a coordinated trio:\n- `RUG` orchestrates decomposition, delegation, and validation loops.\n- `SWE` executes implementation tasks.\n- `QA` validates requirements, edge cases, and regressions.\n\nTypical usage:\n1. Start with `RUG` for multi-step tasks.\n2. Let `RUG` delegate coding to `SWE`.\n3. Let `RUG` delegate verification to `QA`.\n\nBest results:\n- Keep each delegated task narrowly scoped.\n- Require explicit acceptance criteria per task.\n- Run a final cross-task validation pass before completion." + }, + { + "path": "agents/swe-subagent.agent.md", + "kind": "agent" + }, + { + "path": "agents/qa-subagent.agent.md", + "kind": "agent" + } + ] } diff --git a/prompts/suggest-awesome-github-copilot-collections.prompt.md b/prompts/suggest-awesome-github-copilot-collections.prompt.md deleted file mode 100644 index 97c3563e..00000000 --- a/prompts/suggest-awesome-github-copilot-collections.prompt.md +++ /dev/null @@ -1,183 +0,0 @@ ---- -agent: 'agent' -description: 'Suggest relevant GitHub Copilot collections from the awesome-copilot repository based on current repository context and chat history, providing automatic download and installation of collection assets, and identifying outdated collection assets that need updates.' -tools: ['edit', 'search', 'runCommands', 'runTasks', 'think', 'changes', 'testFailure', 'openSimpleBrowser', 'web/fetch', 'githubRepo', 'todos', 'search'] ---- -# Suggest Awesome GitHub Copilot Collections - -Analyze current repository context and suggest relevant collections from the [GitHub awesome-copilot repository](https://github.com/github/awesome-copilot/blob/main/docs/README.collections.md) that would enhance the development workflow for this repository. - -## Process - -1. **Fetch Available Collections**: Extract collection list and descriptions from [awesome-copilot README.collections.md](https://github.com/github/awesome-copilot/blob/main/docs/README.collections.md). Must use `#fetch` tool. -2. **Scan Local Assets**: Discover existing prompt files in `prompts/`, instruction files in `instructions/`, and chat modes in `agents/` folders -3. **Extract Local Descriptions**: Read front matter from local asset files to understand existing capabilities -4. **Fetch Remote Versions**: For each local asset that matches a collection item, fetch the corresponding version from awesome-copilot repository using raw GitHub URLs (e.g., `https://raw.githubusercontent.com/github/awesome-copilot/main//`) -5. **Compare Versions**: Compare local asset content with remote versions to identify: - - Assets that are up-to-date (exact match) - - Assets that are outdated (content differs) - - Key differences in outdated assets (tools, description, content) -6. **Analyze Repository Context**: Review chat history, repository files, programming languages, frameworks, and current project needs -7. **Match Collection Relevance**: Compare available collections against identified patterns and requirements -8. **Check Asset Overlap**: For relevant collections, analyze individual items to avoid duplicates with existing repository assets -9. **Present Collection Options**: Display relevant collections with descriptions, item counts, outdated asset counts, and rationale for suggestion -10. **Provide Usage Guidance**: Explain how the installed collection enhances the development workflow - **AWAIT** user request to proceed with installation or updates of specific collections. DO NOT INSTALL OR UPDATE UNLESS DIRECTED TO DO SO. -11. **Download/Update Assets**: For requested collections, automatically: - - Download new assets to appropriate directories - - Update outdated assets by replacing with latest version from awesome-copilot - - Do NOT adjust content of the files - - Use `#fetch` tool to download assets, but may use `curl` using `#runInTerminal` tool to ensure all content is retrieved - -## Context Analysis Criteria - -🔍 **Repository Patterns**: -- Programming languages used (.cs, .js, .py, .ts, .bicep, .tf, etc.) -- Framework indicators (ASP.NET, React, Azure, Next.js, Angular, etc.) -- Project types (web apps, APIs, libraries, tools, infrastructure) -- Documentation needs (README, specs, ADRs, architectural decisions) -- Development workflow indicators (CI/CD, testing, deployment) - -🗨️ **Chat History Context**: -- Recent discussions and pain points -- Feature requests or implementation needs -- Code review patterns and quality concerns -- Development workflow requirements and challenges -- Technology stack and architecture decisions - -## Output Format - -Display analysis results in structured table showing relevant collections and their potential value: - -### Collection Recommendations - -| Collection Name | Description | Items | Asset Overlap | Suggestion Rationale | -|-----------------|-------------|-------|---------------|---------------------| -| [Azure & Cloud Development](https://github.com/github/awesome-copilot/blob/main/collections/azure-cloud-development.md) | Comprehensive Azure cloud development tools including Infrastructure as Code, serverless functions, architecture patterns, and cost optimization | 15 items | 3 similar | Would enhance Azure development workflow with Bicep, Terraform, and cost optimization tools | -| [C# .NET Development](https://github.com/github/awesome-copilot/blob/main/collections/csharp-dotnet-development.md) | Essential prompts, instructions, and chat modes for C# and .NET development including testing, documentation, and best practices | 7 items | 2 similar | Already covered by existing .NET-related assets but includes advanced testing patterns | -| [Testing & Test Automation](https://github.com/github/awesome-copilot/blob/main/collections/testing-automation.md) | Comprehensive collection for writing tests, test automation, and test-driven development | 11 items | 1 similar | Could significantly improve testing practices with TDD guidance and automation tools | - -### Asset Analysis for Recommended Collections - -For each suggested collection, break down individual assets: - -**Azure & Cloud Development Collection Analysis:** -- ✅ **New Assets (12)**: Azure cost optimization prompts, Bicep planning mode, AVM modules, Logic Apps expert mode -- ⚠️ **Similar Assets (3)**: Azure DevOps pipelines (similar to existing CI/CD), Terraform (basic overlap), Containerization (Docker basics covered) -- 🔄 **Outdated Assets (2)**: azure-iac-generator.agent.md (tools updated), bicep-implement.agent.md (description changed) -- 🎯 **High Value**: Cost optimization tools, Infrastructure as Code expertise, Azure-specific architectural guidance - -**Installation Preview:** -- Will install to `prompts/`: 4 Azure-specific prompts -- Will install to `instructions/`: 6 infrastructure and DevOps best practices -- Will install to `agents/`: 5 specialized Azure expert modes - -## Local Asset Discovery Process - -1. **Scan Asset Directories**: - - List all `*.prompt.md` files in `prompts/` directory - - List all `*.instructions.md` files in `instructions/` directory - - List all `*.agent.md` files in `agents/` directory - -2. **Extract Asset Metadata**: For each discovered file, read YAML front matter to extract: - - `description` - Primary purpose and functionality - - `tools` - Required tools and capabilities - - `mode` - Operating mode (for prompts) - - `model` - Specific model requirements (for chat modes) - -3. **Build Asset Inventory**: Create comprehensive map of existing capabilities organized by: - - **Technology Focus**: Programming languages, frameworks, platforms - - **Workflow Type**: Development, testing, deployment, documentation, planning - - **Specialization Level**: General purpose vs. specialized expert modes - -4. **Identify Coverage Gaps**: Compare existing assets against: - - Repository technology stack requirements - - Development workflow needs indicated by chat history - - Industry best practices for identified project types - - Missing expertise areas (security, performance, architecture, etc.) - -## Version Comparison Process - -1. For each local asset file that corresponds to a collection item, construct the raw GitHub URL: - - Agents: `https://raw.githubusercontent.com/github/awesome-copilot/main/agents/` - - Prompts: `https://raw.githubusercontent.com/github/awesome-copilot/main/prompts/` - - Instructions: `https://raw.githubusercontent.com/github/awesome-copilot/main/instructions/` -2. Fetch the remote version using the `#fetch` tool -3. Compare entire file content (including front matter and body) -4. Identify specific differences: - - **Front matter changes** (description, tools, applyTo patterns) - - **Tools array modifications** (added, removed, or renamed tools) - - **Content updates** (instructions, examples, guidelines) -5. Document key differences for outdated assets -6. Calculate similarity to determine if update is needed - -## Collection Asset Download Process - -When user confirms a collection installation: - -1. **Fetch Collection Manifest**: Get collection YAML from awesome-copilot repository -2. **Download Individual Assets**: For each item in collection: - - Download raw file content from GitHub - - Validate file format and front matter structure - - Check naming convention compliance -3. **Install to Appropriate Directories**: - - `*.prompt.md` files → `prompts/` directory - - `*.instructions.md` files → `instructions/` directory - - `*.agent.md` files → `agents/` directory -4. **Avoid Duplicates**: Skip files that are substantially similar to existing assets -5. **Report Installation**: Provide summary of installed assets and usage instructions - -## Requirements - -- Use `fetch` tool to get collections data from awesome-copilot repository -- Use `githubRepo` tool to get individual asset content for download -- Scan local file system for existing assets in `prompts/`, `instructions/`, and `agents/` directories -- Read YAML front matter from local asset files to extract descriptions and capabilities -- Compare collections against repository context to identify relevant matches -- Focus on collections that fill capability gaps rather than duplicate existing assets -- Validate that suggested collections align with repository's technology stack and development needs -- Provide clear rationale for each collection suggestion with specific benefits -- Enable automatic download and installation of collection assets to appropriate directories -- Ensure downloaded assets follow repository naming conventions and formatting standards -- Provide usage guidance explaining how collections enhance the development workflow -- Include links to both awesome-copilot collections and individual assets within collections - -## Collection Installation Workflow - -1. **User Confirms Collection**: User selects specific collection(s) for installation -2. **Fetch Collection Manifest**: Download YAML manifest from awesome-copilot repository -3. **Asset Download Loop**: For each asset in collection: - - Download raw content from GitHub repository - - Validate file format and structure - - Check for substantial overlap with existing local assets - - Install to appropriate directory (`prompts/`, `instructions/`, or `agents/`) -4. **Installation Summary**: Report installed assets with usage instructions -5. **Workflow Enhancement Guide**: Explain how the collection improves development capabilities - -## Post-Installation Guidance - -After installing a collection, provide: -- **Asset Overview**: List of installed prompts, instructions, and chat modes -- **Usage Examples**: How to activate and use each type of asset -- **Workflow Integration**: Best practices for incorporating assets into development process -- **Customization Tips**: How to modify assets for specific project needs -- **Related Collections**: Suggestions for complementary collections that work well together - - -## Icons Reference - -- ✅ Collection recommended for installation / Asset up-to-date -- ⚠️ Collection has some asset overlap but still valuable -- ❌ Collection not recommended (significant overlap or not relevant) -- 🎯 High-value collection that fills major capability gaps -- 📁 Collection partially installed (some assets skipped due to duplicates) -- 🔄 Asset outdated (update available from awesome-copilot) - -## Update Handling - -When outdated collection assets are identified: -1. Include them in the asset analysis with 🔄 status -2. Document specific differences for each outdated asset -3. Provide recommendation to update with key changes noted -4. When user requests update, replace entire local file with remote version -5. Preserve file location in appropriate directory (`agents/`, `prompts/`, or `instructions/`)