diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 964e5a3b..77de0e68 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -123,7 +123,8 @@ zeroshot/
 npm test
 ```
 
-Runs all tests in `tests/**/*.test.js` using Mocha.
+Runs the fast test suite (unit + top-level tests) as defined in `package.json`.
+Integration tests in `tests/integration/**/*.test.js` are excluded from `npm test`; run them with `npm run test:slow`.
 
 ### Specific Test File
 
diff --git a/README.md b/README.md
index 5b036bab..a6a8b359 100644
--- a/README.md
+++ b/README.md
@@ -95,7 +95,7 @@ npm i -g @google/gemini-cli
 # Opencode: see https://opencode.ai
 
 # Authenticate with the provider CLI
-claude login        # Claude
+claude auth login   # Claude
 codex login         # Codex
 gemini auth login   # Gemini
 opencode auth login # Opencode