The repository-docs standard requires every SDK repo to have an AGENTS.md at the repository root. sentry-php-agent currently has no AGENTS.md, meaning AI agents working in this repo have no architecture context, no testing conventions, no build instructions, and no SDK-specific standard overrides. The file that makes agentic contributions accurate and consistent.
What needs to be done
- Create
AGENTS.md at the repo root. Use agents-md skill.
- Create
CLAUDE.md as a symlink: ln -s AGENTS.md CLAUDE.md
- Fill in all SDK-specific sections:
- Package manager and key commands (Composer, PHPUnit, PHP CS Fixer, PHPStan/Psalm)
- Architecture overview (what sentry-php-agent is, how it relates to sentry-php, key entry points and responsibilities)
- Development workflow (composer install, test, lint commands)
- Testing conventions (test framework, file naming, test types required per change type)
- Standards overrides (any known deviations from the SDK standards)
- Verify accuracy: have an AI tool attempt a small contribution using the file as context before merging
The repository-docs standard requires every SDK repo to have an
AGENTS.mdat the repository root.sentry-php-agentcurrently has noAGENTS.md, meaning AI agents working in this repo have no architecture context, no testing conventions, no build instructions, and no SDK-specific standard overrides. The file that makes agentic contributions accurate and consistent.What needs to be done
AGENTS.mdat the repo root. Use agents-md skill.CLAUDE.mdas a symlink:ln -s AGENTS.md CLAUDE.md