Create AI coding agent instructions for OpenTelemetry Java Instrumentation

[Copilot]

Updated the agent instructions to follow the agents.md format standard to generalize for any AI coding agent, not just GitHub Copilot.

Plan

• Analyze repository structure and existing documentation
• Test and measure build command times and structure
• Document exact bootstrap/setup requirements
• Document complete build process and validate timings
• Document testing scenarios and expected times
• Create instrumentation-specific documentation workflow
• Document code quality tools (spotless, license checks, muzzle)
• Document common navigation patterns and key directories
• Create final comprehensive instructions file
• Convert to agents.md format for agent-agnostic usage
• Address PR feedback and corrections

Completed Work

• Analyzed repository structure: 500+ modules across ~649 lines in settings.gradle.kts
• Validated build timings through testing actual Gradle commands
• Documented Java 21 requirement and multi-JVM testing matrix
• Measured configuration phase (60-90 seconds) and full build times (20-45 minutes)
• Tested code quality tools and muzzle functionality
• Renamed file from copilot-instructions.md to agents.md to follow standard format
• Addressed PR feedback:
  • Updated telemetry collection to use ci-collect.sh for better parallelism
  • Removed unnecessary removeJarVersionNumbers configuration
  • Updated ./gradlew test description and added ./gradlew check command
  • Removed -Ddev=true flag from test commands where not needed
  • Emphasized use of AssertJ and JUnit 5 testing frameworks
  • Updated environment variable usage guidance
• Created comprehensive instructions covering:
  • Build and test workflows with accurate timing estimates
  • Repository navigation for 500+ instrumentation modules
  • Development workflows for instrumentations
  • Critical timeout warnings to prevent premature cancellation
  • Common troubleshooting scenarios and network limitations
  • Extension development patterns
  • CI/CD integration patterns

Key Features

• Agent-agnostic format following agents.md standard
• Accurate build time estimates based on actual testing
• "NEVER CANCEL" warnings with specific timeout recommendations
• Step-by-step instrumentation development workflow
• Common command patterns with validated syntax
• Repository structure guidance for navigating 500+ modules
• Network limitation documentation for sandboxed environments
• Updated testing guidance emphasizing AssertJ and JUnit 5

The instructions are now generalized to work with any AI coding agent, not just GitHub Copilot, while maintaining all the technical accuracy and comprehensive guidance. All feedback from reviewers has been addressed.

Fixes #14769.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.

[jaydeluca]

@copilot use the agents.md format (https://agents.md/) in your output as to generalize for any agent, not just copilot

[Copilot]

@copilot use the agents.md format (https://agents.md/) in your output as to generalize for any agent, not just copilot

Converted to agents.md format as requested. Renamed the file from copilot-instructions.md to agents.md and the content is now agent-agnostic, suitable for any AI coding agent. Commit: 717ea0a

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• agents.md
  • Triggering command: curl -s REDACTED (dns block)
  • Triggering command: curl -s --max-time 10 REDACTED (dns block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

[otelbot-java-instrumentation]

🔧 The result from generateLicenseReport was committed to the PR branch.