Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Sep 13, 2025

This PR migrates the repository's agent automation rules from the legacy .clinerules directory structure to a modern agents.md file, aligning with GitHub's standard for agent instructions and workflow automation.

Changes Made

Migration Summary:

  • Consolidated 4 files into 1: Combined ai-guidelines.md, cline-instructions.md, csharp-guidelines.md, and idweb-guidelines.md into a comprehensive agents.md file
  • Enhanced structure: Added table of contents and logical organization with clear sections for different aspects of development
  • Improved documentation: Added context explaining the purpose and scope of agent automation configuration
  • Updated references: Modified .github/copilot-instructions.md to point to the new agents.md file instead of the .clinerules directory
  • Preserved changelog: Left the existing changelog entry unchanged to maintain historical accuracy
  • Clean removal: Completely removed the .clinerules directory

Content Organization

The new agents.md file is organized into five main sections:

  1. Core Development Principles - General guidelines for incremental development and quality standards
  2. AI Assistant Guidelines - Tool usage preferences, development workflows, and error handling
  3. C# Development Standards - Language features, formatting rules, nullable reference types, and testing guidelines
  4. Microsoft Identity Web Guidelines - Repository structure, package information, and API change requirements
  5. Tool Usage and Workflows - Development patterns and testing requirements

Benefits

  • Modern standard: Leverages GitHub's widely adopted agents.md format for agent automation
  • Better contributor experience: Single, well-structured file with clear navigation via table of contents
  • Enhanced documentation: More context about how agent automation is configured and used
  • Maintained functionality: All original rules and configurations preserved during migration
  • Future-ready: Aligned with current GitHub agent automation best practices

The migration ensures no loss of important rules or configuration while modernizing the approach to agent automation workflows in the repository.

Fixes #3474.


💡 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.

Copilot AI changed the title [WIP] Migrate repository agent rules from .clinerules to agents.md Migrate repository agent rules from .clinerules to agents.md Sep 13, 2025
Copilot AI requested a review from jennyf19 September 13, 2025 21:34
Copilot finished work on behalf of jennyf19 September 13, 2025 21:34
@jennyf19 jennyf19 marked this pull request as ready for review September 13, 2025 21:39
@jennyf19 jennyf19 requested a review from a team as a code owner September 13, 2025 21:39
Copilot AI requested a review from jennyf19 September 13, 2025 21:39
Copilot finished work on behalf of jennyf19 September 13, 2025 21:39
Copy link
Collaborator

@jennyf19 jennyf19 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

:shipit:

This was referenced Oct 24, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Migrate repository agent rules from .clinerules to agents.md

4 participants