Cross Agent Compatibility
Multi-agent projects must have compatible instruction sets — shared instructions must be agent-neutral, with agent-specific content isolated to dedicated files.
Antipatterns
- Referencing
CLAUDE.mdor.cursorrulesby name in a shared instruction file. The check detects agent-specific filenames in shared files. Agent-specific content belongs in its own file. - Mentioning
.clinerulesorcopilot-instructions.mdin a file that all agents read. Even factual references to agent-specific filenames violate neutrality in shared instructions. - Writing agent-neutral prose but including an example that names a specific agent file. The check matches the filename pattern regardless of surrounding context.
Pass / Fail
Pass
# Coding Standards
Use `ruff` for formatting.
Run `pytest tests/` before committing.
Keep modules under 500 lines.
Fail
# Coding Standards
See `.cursorrules` for Cursor-specific settings.
Claude users should check `CLAUDE.md` for details.
Limitations
Checks for agent-specific filenames (CLAUDE.md, .cursorrules, copilot-instructions.md) referenced in content. Does not detect agent-specific terminology or conventions that don't mention filenames.
