From 8fef4c2b77ca903a1dd3e719068e225a23ea3040 Mon Sep 17 00:00:00 2001
From: scotjelinski <58397194+scotjelinski@users.noreply.github.com>
Date: Thu, 28 May 2026 21:45:45 -0600
Subject: [PATCH] docs(query): document --include-tests flag and default test
 exclusion

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 39b09b7d2..a3d530df3 100644
--- a/README.md
+++ b/README.md
@@ -685,6 +685,10 @@ definitions:
     filePath: src/types/auth.ts
 ```
 
+Options: `task_context`, `goal`, `limit` (max processes, default 5), `max_symbols` (per process, default 10), `include_content` (full symbol source), `includeTests` (include test files; excluded by default, matching `impact`), `repo`, `service`
+
+Test files are excluded from `query` results by default so production code is not outranked by tests that name the same concept. Pass `--include-tests` (CLI) or `includeTests: true` (MCP) to include them, the same opt-in `impact` uses.
+
 ### Context (360-degree Symbol View)
 
 ```