From 14ba99c9194593b452fa39a990713704497a2421 Mon Sep 17 00:00:00 2001 From: Gonen Jerbi Date: Fri, 29 May 2026 17:35:30 +0300 Subject: [PATCH] docs(wix-headless): state docs-search API is tried before web search Agents were defaulting straight to WebSearch for Wix API lookups. Add a one-line lookup-order note to DOCS_SEARCH.md making the precedence explicit: bundled references -> docs-search API -> WebSearch. Web search stays allowed, just as a fallback after the docs-search API. Co-Authored-By: Claude Opus 4.8 (1M context) --- skills/wix-headless/references/shared/DOCS_SEARCH.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/skills/wix-headless/references/shared/DOCS_SEARCH.md b/skills/wix-headless/references/shared/DOCS_SEARCH.md index 73bc163a..0f075a09 100644 --- a/skills/wix-headless/references/shared/DOCS_SEARCH.md +++ b/skills/wix-headless/references/shared/DOCS_SEARCH.md @@ -36,6 +36,8 @@ No auth headers required on these endpoints. Your skill directory includes `.md` reference files with API recipes and error handling for your scope. **Read those first.** Use the doc endpoints above only when you hit an error or endpoint not covered by the bundled recipe — each external doc read costs a tool call and 15–30 s. +**Lookup order for any Wix API:** bundled references → docs-search API (above) → WebSearch. The docs-search API is the source of truth and is always fresher than the open web — reach for it before WebSearch, which is only a fallback when docs-search comes up empty. + ## Absolute paths Subagents run with the **project directory** as CWD, not the skill root. Every dispatch prompt must include `Instruction file (absolute path): /references//INSTRUCTIONS.md`. Read that path only; use the absolute sibling paths it lists. Never resolve `references/...` against the project CWD.