diff --git a/AGENTS.md b/AGENTS.md
index 49109ab8..3d59fad7 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -39,6 +39,7 @@ Before making changes, read in this order:
 - `releases/`: release notes
 - `patches/`: pnpm dependency patches
 - `docker/`: Docker configuration
+- `report/`: generated analysis and audit reports
 
 ## 4. Dev Setup (Auto DB)
 
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 1eba95e3..ad4ffd69 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -11,8 +11,8 @@ We really appreciate both small fixes and thoughtful larger changes.
 - Pick **one** clear thing to fix/improve
 - Touch the **smallest possible number of files**
 - Make sure the change is very targeted and easy to review
-- All automated checks pass (including Greptile comments)
-- No new lint/test failures
+- All automated checks pass (CI typecheck, tests, build)
+- No new test failures
 
 These almost always get merged quickly when they're clean.
 
@@ -27,7 +27,7 @@ These almost always get merged quickly when they're clean.
   - Clear description of what & why
   - Proof it works (manual testing notes)
   - All tests passing
-  - All Greptile + other PR comments addressed
+  - All PR review comments addressed
 
 PRs that follow this path are **much** more likely to be accepted, even when they're large.
 
diff --git a/docs/agents-runtime.md b/docs/agents-runtime.md
index f3672723..1b4a273a 100644
--- a/docs/agents-runtime.md
+++ b/docs/agents-runtime.md
@@ -37,6 +37,7 @@ Built-in adapters:
 - `claude_local`: runs your local `claude` CLI
 - `codex_local`: runs your local `codex` CLI
 - `opencode_local`: runs your local `opencode` CLI
+- `gemini_local`: runs your local Gemini CLI
 - `hermes_local`: runs your local `hermes` CLI
 - `cursor`: runs Cursor in background mode
 - `pi_local`: runs an embedded Pi agent locally
@@ -44,7 +45,7 @@ Built-in adapters:
 - `process`: generic shell command adapter
 - `http`: calls an external HTTP endpoint
 
-For local CLI adapters (`claude_local`, `codex_local`, `opencode_local`, `hermes_local`), Paperclip assumes the CLI is already installed and authenticated on the host machine.
+For local CLI adapters (`claude_local`, `codex_local`, `opencode_local`, `gemini_local`, `hermes_local`), Paperclip assumes the CLI is already installed and authenticated on the host machine.
 
 ## 3.2 Runtime behavior