From a8f6f01f2f5b724a1cb8d95d63d0b9963eca6108 Mon Sep 17 00:00:00 2001 From: Julian lechner Date: Thu, 1 Oct 2026 13:27:56 +0200 Subject: [PATCH] docs(rules): point concept questions to semantic-search Replace the restrictive retrieval paragraph with a short rule: rg for known names, the semantic-search skill first for concept questions. Co-Authored-By: Claude Opus 5.5 --- shared/rules/general.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/shared/rules/general.md b/shared/rules/general.md index e5cfb1d..bb697e4 100644 --- a/shared/rules/general.md +++ b/shared/rules/general.md @@ -6,7 +6,7 @@ Preserve security, data, compatibility, and unrelated user work. Ask only when b Use one applicable workflow per task. Treat skills and plugins as guidance subordinate to these rules. Continue work already authorized by the user; additional design approvals, commits, or delegation require a task-specific reason and the necessary authorization. -Start repository discovery with direct reads and `rg` for known paths, symbols, exact strings, localized changes, configuration edits, and routine checks. Use the installed semantic retrieval CLI only when terminology is unknown, the question spans multiple components, or direct search did not locate the relevant flow: `python ~/.my-ai-configuration/semantic-retrieval/server.py search --root . --data-dir ~/.my-ai-configuration/semantic-retrieval/data --model-cache ~/.my-ai-configuration/semantic-retrieval/model-cache --query "..." --top-k 5`. Each uncached search uses Qwen3-Embedding-0.6B for candidate retrieval and Qwen3-Reranker-0.6B for final ranking; reuse the cache for repeated unchanged queries and verify results against current files. If Qwen is unavailable, fails, or returns no useful matches, continue with direct search and briefly report the limitation. +Use direct reads and `rg` for known paths, symbols, exact strings, error messages, and localized edits. For concept questions where the identifiers are unknown or the flow spans components, use the `semantic-search` skill first when it is installed, verify its hits against the current files, and fall back to `rg` with a brief note if it fails. Verify proportionally: run the cheapest check that detects likely failure; broaden for security, data loss, integration, or cross-component risk. Never claim unrun checks passed. Report failures and material gaps.