From f497a23aaab37e1dec8cbaaf3d25e47bb247cfe4 Mon Sep 17 00:00:00 2001 From: Julian lechner Date: Thu, 8 Oct 2026 13:55:26 +0200 Subject: [PATCH] docs(skills): apply semantic routing before every repository lookup --- shared/skills/research/semantic-search/SKILL.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/shared/skills/research/semantic-search/SKILL.md b/shared/skills/research/semantic-search/SKILL.md index e79ba19..f63b872 100644 --- a/shared/skills/research/semantic-search/SKILL.md +++ b/shared/skills/research/semantic-search/SKILL.md @@ -1,6 +1,6 @@ --- name: semantic-search -description: MUST use before reading or grepping code whenever the exact symbol, file, or string is not already known - concept questions, unfamiliar areas, "where/how is X done", and bug reports that describe behavior. Use rg only for known identifiers, paths, or exact strings. +description: MUST apply before EVERY repository search or lookup, including direct reads, exact matches, and follow-up searches. Route known identifiers to direct reads or rg; run semantic retrieval first for unknown identifiers and behavior questions. --- # Semantic Search @@ -9,7 +9,7 @@ Search the current Git repository, plus the user's registered QMD collections, b ## Rule -Run this search first whenever you do not already know the exact identifier, path, or string. Do not start with `rg` guesses for a concept. This skill locates code; `repository-research` then traces the flow from the verified hits. +Apply `research`, `repository-research`, and this routing rule before each repository lookup. Known exact identifiers, paths, or strings use direct reads or `rg` under the same research checks. Unknown identifiers require semantic retrieval first; guessed keywords are not known identifiers. Reevaluate the route for every follow-up query. Reuse instructions already in context. ## Run