Skip to content

Conversation

@adityamparikh
Copy link
Contributor

@adityamparikh adityamparikh commented Jan 7, 2026

Summary

  • Add AGENTS.md guidance file for AI coding assistants (Copilot, Junie, Cursor, Claude Code, etc.)
  • CLAUDE.md symlinks to AGENTS.md for Claude Code compatibility
  • Includes common commands (build, test, format)
  • Documents architecture overview and MCP tools
  • Explains transport modes (STDIO vs HTTP) and testing structure

Test plan

  • File created with accurate information from codebase analysis
  • CLAUDE.md symlink verified working
  • Review content for accuracy and completeness

🤖 Generated with Claude Code

@epugh
Copy link
Contributor

epugh commented Jan 7, 2026

So, if I wante dto add some stylistic things to how it works, would I just add them at the bottom of the file? For example, if we don't want @version or @since tags for our classes...? Would that would go in this file?

@adityamparikh
Copy link
Contributor Author

@epugh yes that would work for claude code.
I will have claude.md be a symlink to a more general agents.md which is an emerging universal standard for all other agents.

Add AGENTS.md as the primary guidance file for all AI coding assistants
(Copilot, Junie, Cursor, Claude Code, etc.) with CLAUDE.md as a symlink.

- Includes common commands (build, test, format)
- Documents architecture overview and MCP tools
- Explains transport modes (STDIO vs HTTP) and testing structure

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
@adityamparikh adityamparikh changed the title docs: add CLAUDE.md for Claude Code guidance docs: add AGENTS.md for AI coding assistants Jan 7, 2026
@epugh
Copy link
Contributor

epugh commented Jan 7, 2026

i think just having agents.md (since that is the future) is probably totally fine!

@adityamparikh
Copy link
Contributor Author

Since I am using Claude code for the most part and it is not yet using agents.md, made this change

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.

2 participants