diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3575c80..5b72cc3 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -29,19 +29,14 @@ Thanks for your interest in improving the PostHog Ruby SDK.
    ruby example.rb
    ```
 
-## Testing
+## CI-aligned checks
 
-1. Run the full test suite:
+Run the same checks CI uses before opening a PR:
 
-   ```bash
-   bin/test
-   ```
-
-2. Run a specific test if needed:
-
-   ```bash
-   bin/test spec/posthog/client_spec.rb:26
-   ```
+```bash
+bundle exec rspec
+bundle exec rubocop
+```
 
 ## Rails package
 
diff --git a/posthog-rails/CONTRIBUTING.md b/posthog-rails/CONTRIBUTING.md
index ae35127..c8ed8c5 100644
--- a/posthog-rails/CONTRIBUTING.md
+++ b/posthog-rails/CONTRIBUTING.md
@@ -4,13 +4,13 @@ This guide covers package-specific development for `posthog-rails`.
 
 For repository-level setup, see the root [CONTRIBUTING.md](../CONTRIBUTING.md).
 
-## Development
+## CI-aligned checks
 
-Run the package tests from the repository root:
+Run the same checks CI uses before opening a PR:
 
 ```bash
-bundle install
 bundle exec rspec
+bundle exec rubocop
 ```
 
 ## Pull requests