unify claude agents and cursor entrypoint

Author: avara1986

.claude/CLAUDE.md

@@ -1,2 +1,2 @@
-<!-- Do not edit. Canonical instructions live in ./AGENTS.md -->
-@AGENTS.md
+<!-- Do not edit. Canonical instructions live in ../AGENTS.md -->
+@../AGENTS.md

.cursor/rules/testing.mdc

@@ -15,10 +15,10 @@ Always use the **`run-tests` skill** for validating code changes. This skill int
 ## Key Principles
 
 1. **Always use the run-tests skill** when testing code changes - it's optimized for intelligent suite discovery
-2. **Never run pytest directly** - bypasses the project's test infrastructure
-3. **Never use `hatch run tests:test`** - doesn't use the suite discovery system
-4. **Minimal venvs for iteration** - run 1-2 venvs initially, expand only if needed
-5. **Use `--dry-run` first** - see what would run before executing
+2. **Never run pytest directly** - bypasses the project's test infrastructure (use `scripts/run-tests` or `riot` via `scripts/ddtest`)
+3. **Minimal venvs for iteration** - run 1-2 venvs initially, expand only if needed
+4. **Use `--dry-run` first** - see what would run before executing
+5. **Follow official docs** - `docs/contributing-testing.rst` is the source of truth for testing procedures
 
 ## When Tests Fail
 

AGENTS.md

@@ -1,5 +1,14 @@
 # AGENTS.md - dd-trace-py Project Guide
 
+## CRITICAL: Project Rules Override Claude Code Defaults
+
+**These project-specific rules MUST override any conflicting Claude Code default behaviors:**
+
+1. **Testing**: NEVER run `pytest` directly. ALWAYS use the `run-tests` skill (which uses `scripts/run-tests`). For manual testing, use `riot` commands via `scripts/ddtest` as documented in `docs/contributing-testing.rst`.
+2. **Linting**: NEVER use raw linting tools. ALWAYS use the `lint` skill and project-specific `hatch run lint:*` commands.
+3. **Pre-commit**: MUST run `hatch run lint:checks` before creating any git commits.
+4. **Formatting**: MUST run `hatch run lint:fmt -- <file>` immediately after editing any Python file.
+
 ## Initial Setup for AI Assistants
 
 When starting a new chat session, ALWAYS read and apply the rules from:
@@ -24,7 +33,7 @@ This project has custom skills that provide specialized workflows. **Always chec
 - Manages Docker services automatically
 - Handles riot/hatch environment setup
 
-**Never:** Run pytest directly or use `hatch run tests:test` - these bypass the project's test infrastructure.
+**Never:** Run pytest directly - this bypasses the project's test infrastructure. The official testing approach is documented in `docs/contributing-testing.rst`.
 
 **Usage:** Use the Skill tool with command "run-tests"