Skip to content

Conversation

@jeremydhoover-blip
Copy link

@jeremydhoover-blip jeremydhoover-blip commented Jan 4, 2026

Summary

Replace copilot-instructions.md with .github/agents.md following https://agents.md/ best practices.

Changes

  • Add .github/agents.md - New agent instructions following agents.md format
  • Delete copilot-instructions.md - Replaced by agents.md
  • References docs/agent-docs/SKILL.md (from PR Docs: Add agent-docs for LLM/AI context #82)

Merge Order

Merge PR #82 first, then this PR

This PR references files added in #82. The links will work correctly after #82 is merged.

Why This Change

  • Follows modern agents.md best practices (https://agents.md/)
  • References detailed documentation instead of embedding everything
  • All content from copilot-instructions.md is preserved and enhanced
  • Cleaner, more maintainable structure

- Added clear Purpose, Role, and Key expertise areas in intro
- Removed redundant 'Core rules' section (content integrated into relevant sections)
- Improved persona definition for AI assistants
- Better organization and flow throughout document
- Reduced line count from 327 to 234 lines while maintaining all essential info
- Added 'Follow patterns in existing code' to coding guidelines

This provides clearer, more actionable guidance for AI coding assistants.
@jeremydhoover-blip jeremydhoover-blip requested a review from a team as a code owner January 4, 2026 08:32
- Add .github/agents.md following agents.md best practices (https://agents.md/)
- Delete copilot-instructions.md (replaced by agents.md)
- Reference docs/agent-docs/SKILL.md from PR microsoft#82
- All content from copilot-instructions.md preserved and enhanced
- Follows modern GitHub agents.md format with clear structure
- References detailed agent documentation instead of embedding everything
@jeremydhoover-blip jeremydhoover-blip changed the title docs: Improve copilot-instructions.md structure and clarity Replace copilot-instructions.md with .github/agents.md following agents.md best practices Jan 7, 2026
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.

1 participant