Add GitHub Copilot Cloud Agent custom agents and workspace configuration

[Copilot]

Implements specialized custom agents for GitHub Copilot Cloud Agent to provide domain-specific code assistance.

Custom Agents (.github/agents/)

Five specialized agents covering development domains:

• test-agent (3.9KB) - Vitest, React Testing Library, NestJS testing, TDD patterns
• code-review-agent (5.5KB) - Security, performance, architecture compliance, 9 review dimensions with prioritization
• documentation-agent (6.4KB) - JSDoc/TSDoc, API docs, architecture diagrams, developer guides
• frontend-agent (9.6KB) - Next.js (App/Pages Router), React hooks, functional composition, a11y
• backend-agent (14.9KB) - NestJS modules/services, GraphQL code-first, TypeORM, authentication patterns

Each agent includes:

• Technology-specific patterns and anti-patterns
• Code examples with AAA structure
• Monorepo-aware commands (pnpm --filter, devbox run)
• Project conventions (functional programming, strict TypeScript)

Configuration

copilot-workspace.yml - Workspace metadata: tech stack, code style (2 spaces, single quotes), file patterns, agent triggers, quality thresholds (80% coverage minimum)

copilot-best-practices.md - Implementation guide: agent selection criteria, usage examples, maintenance procedures

Usage

// In IDE Copilot chat
@workspace Use the test-agent to create unit tests for UserService
@workspace Ask the backend-agent to add authentication to this resolver

Agents trigger automatically on keywords: "test", "review", "docs", "react", "nestjs", etc.

Existing Resources

Enhances existing instruction files:

• copilot-instructions.md (general)
• test-generation-instructions.md (German)
• code-generation-instructions.md (German)
• Commit/PR/review templates

---

Stats: 9 files, 1,918 lines, 42KB documentation

Original prompt

erstelle einen neuen PR welcher diese best practices umsetzt.

[Chronological Review: The conversation began with the user inquiring whether the repository follows best practices for using the Copilot Cloud Agent. The user then requested the creation of a new pull request (PR) to implement these best practices, indicating a desire to enhance the repository's compliance with established guidelines.]

[Intent Mapping:

• User Request 1: "folgt das repo den best practices um copilot cloud agent zu benutzen?" - The user is asking if the repository adheres to best practices for using the Copilot Cloud Agent.
• User Request 2: "erstelle einen neuen PR welcher diese best practices umsetzt." - The user requests the creation of a new PR to implement the identified best practices.]

[Technical Inventory:

• Repository: democracy-development
• Current Branch: master
• Owner: demokratie-live
• Active Pull Request: None mentioned in the recent context, but the user is focused on creating a new PR.]

[Code Archaeology:

• Current File: /Users/manuelruck/Work/democracy/repos/democracy-development/.github/test-generation-instructions.md - This file is likely related to the documentation of testing and generation instructions, which may be relevant to the best practices being discussed.]

[Progress Assessment:

• Completed Tasks: User has identified the need for best practices regarding the Copilot Cloud Agent.
• Partially Complete Work: User is in the process of creating a new PR to implement these best practices.]

[Context Validation: All critical information for continuation is captured, including the user's requests and the current file being worked on.]

[Recent Commands Analysis:

• Last Agent Commands: The user requested to create a new PR to implement best practices.
• Tool Results Summary: No specific tool results were returned as the user was focused on the request for a new PR.
• Pre-Summary State: The agent was actively discussing the creation of a new PR when the token budget was exceeded.
• Operation Context: The commands executed were directly related to the user's goal of enhancing the repository's adherence to best practices for the Copilot Cloud Agent.]

1. Conversation Overview: - Primary Objectives: - "folgt das repo den best practices um copilot cloud agent zu benutzen?" - Inquiry about adherence to best practices for Copilot Cloud Agent. - "erstelle einen neuen PR welcher diese best practices umsetzt." - Request to create a new PR to implement best practices. - Session Context: The user is focused on ensuring the repository follows best practices and is taking steps to create a PR for this purpose. - User Intent Evolution: The user transitioned from seeking information about best practices to actively wanting to implement them through a PR.

2. Technical Foundation:

• Repository: democracy-development
• Current Branch: master
• Owner: demokratie-live

3. Codebase Status:

• File Name: .github/test-generation-instructions.md
  • Purpose: Likely related to documenting testing and generation instructions.
  • Current State: User is currently working on this file in the context of implementing best practices.
  • Key Code Segments: Not specified in the recent context.
  • Dependencies: Related to the overall repository practices.

4. Problem Resolution:

• Issues Encountered: None explicitly mentioned, but the user is addressing potential gaps in best practices.
• Solutions Implemented: User is in the process of creating a PR to implement best practices.
• Debugging Context: No ongoing troubleshooting mentioned.
• Lessons Learned: User is actively seeking to improve repository practices.

5. Progress Tracking:

• Completed Tasks: User has identified the need for best practices.
• Partially Complete Work: User is working on creating a new PR.
• Validated Outcomes: None mentioned yet.

6. Active Work State:

• Current Focus: Creating a new PR to implement best practices for the Copilot Cloud Agent.
• Recent Context: User has been discussing the need for best practices and the creation of a PR.
• Working Code: No specific code snippets discussed recently.
• Immediate Context: User was focused on creating a new PR when the token budget was exceeded.

7. Recent Operations:

• Last Agent Commands: User requested to create a new PR.
• Tool Results Summary: No specific tool results were returned.
• Pre-Summary State: The agent was discussing the creation of a new PR.
• Operation Context: The commands executed were aimed at enhancing the repository's adherence to best practices.

8. Continuation Plan:

• Pending Task 1: Create a new PR to implement best practices.
• Pending Task 2: Review and finalize the changes to be included in the PR.
• Priority Information: The creation of the PR is the most urgent task.
• Next Action: User should proceed with drafting the PR based on the identified best practices.

TITLE: Implementierung von Best Practices in PR

Created from VS Code via the GitHub Pull Request extension.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.