diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..f34b7bca --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,6 @@ +# Agents + +## Useful Resources + +- [TESTING.md](TESTING.md) +- [CONTRIBUTING.md](CONTRIBUTING.md) diff --git a/TESTING.md b/TESTING.md index 5cc9cd45..d900d3ac 100644 --- a/TESTING.md +++ b/TESTING.md @@ -87,3 +87,7 @@ Stream delivery tests fail in CI unless `MEMORY_KINESIS_ARN` and `MEMORY_ROLE_AR - Each test class should correspond to the object under test (e.g. `TestMemoryClient`). - Expensive resources (e.g. memories) should be created the minimum number of times, ideally once in `setup_class`. - All resources created during tests must be cleaned up in `teardown_class`. + +## Anti-Patterns + +**Excessive mocking.** Over-mocking weakens correctness guarantees and couples tests to implementation details. Functionality that requires mocking should have integration or e2e test coverage.