From 774e5183e5aee61368edec9a9e56659d2c8d62a9 Mon Sep 17 00:00:00 2001
From: mwiegand <martin.wiegand@seibert.group>
Date: Thu, 30 Jul 2026 19:22:16 +0200
Subject: [PATCH] agents: prefer onyx over direct CQL for internal-doc research

---
 agents/AGENTS-claude.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/agents/AGENTS-claude.md b/agents/AGENTS-claude.md
index d2d1f22..743e2d2 100644
--- a/agents/AGENTS-claude.md
+++ b/agents/AGENTS-claude.md
@@ -4,6 +4,12 @@
 
 - For questions about internal processes, tools, or "wie machen wir X
   bei Seibert", check the company knowledge first (skill `onyx`).
+- **Default to onyx for any "find internal docs on topic X" research**
+  (products, services, systems, teams) — its semantic index regularly
+  surfaces Confluence pages that direct CQL/JQL text search misses
+  (unexpected spaces, differently worded titles). Use direct
+  Confluence CQL only for precise lookups where space or title is
+  already known.
 - Pick the mode by use case (see the skill's mode table): `answer` for
   simple factual questions (cheap on context), `search` when you need
   the source text itself — always cite source links.