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 to a modern agents.md file structure, following GitHub's recommended practices for agent instructions and workflow automation.

Changes Made

Created agents.md

  • Comprehensive guidelines: Consolidated all existing rules from .clinerules into a single, well-organized document
  • Modern structure: Used markdown with YAML/JSON code blocks for configuration data as recommended by GitHub
  • Improved organization: Added table of contents and logical sections for better navigation
  • Enhanced documentation: Added context and examples to help contributors understand agent automation

Updated References

  • Copilot instructions: Modified .github/copilot-instructions.md to reference the new agents.md instead of .clinerules
  • Verified completeness: Ensured no other references to .clinerules exist in the repository

Removed Legacy Structure

  • Clean migration: Deleted the entire .clinerules directory after successful content migration
  • No data loss: All important rules and configuration have been preserved in the new format

Content Preserved

The migration maintains all existing guidelines:

  • AI Assistant Workflow: Planning and implementation phases, tool usage guidelines, quality standards
  • C# Development Standards: Formatting rules, nullable reference types, testing frameworks (xUnit SDK v2, Moq 4.14.x)
  • IdentityModel Guidelines: Repository structure, shipped packages, API management with PublicAPI.Unshipped.txt requirements

Benefits

  • Modern format: Follows GitHub's current best practices for agent configuration
  • Better discoverability: Single source of truth at repository root level
  • Improved contributor experience: Clear documentation with examples and structured configuration
  • Enhanced automation: YAML blocks enable better parsing by automation tools
  • Future-ready: Extensible structure for additional agent types and workflows

The new agents.md file provides the same comprehensive guidance while being more accessible and maintainable for both human contributors and AI agents.

Fixes #3312.


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

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:52
@jennyf19 jennyf19 marked this pull request as ready for review September 26, 2025 00:55
@jennyf19 jennyf19 requested a review from a team as a code owner September 26, 2025 00:55
@saurabhsathe-ms saurabhsathe-ms merged commit 6ae2118 into dev Sep 29, 2025
3 of 4 checks passed
This was referenced Dec 12, 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