Windsurf rules

1---
2name: context7-mcp
3model: haiku
4description: "Fetch current library docs via Context7 MCP instead of training data. Use when user asks about frameworks, APIs, setup, or code examples for React, Next.js, Prisma, etc."
5---
6 
7# Context7 MCP
8 
9> **HARD GATE** — Max **3** Context7 tool calls per user question (`resolve-library-id` + `query-docs` count toward the cap). On quota/rate-limit errors, emit an explicit **CONTEXT7_UNAVAILABLE** block — do NOT silently answer from training data.
10>
11> **HARD GATE** — Before HTTP fetch, check `bash scripts/lib/doc-fetch-cache.sh get "<libraryId>:<query>"`. Cache hit within TTL → use cached body (no round-trip). On ETag mismatch after conditional refresh, replace cache entry.
12 
13## When to Use
14 
15- Setup/configuration questions ("How do I configure Next.js middleware?")
16- Code involving libraries ("Write a Prisma query for…")
17- API references ("What are the Supabase auth methods?")
18- User mentions specific frameworks (React, Vue, Svelte, Express, Tailwind, etc.)
19 
20## Bounded Retry (max 3x)
21 
22| Attempt | Action |
23|---------|--------|
24| 1 | `resolve-library-id` → pick best match |
25| 2 | `query-docs` with selected `libraryId` |
26| 3 | Retry `query-docs` once with refined query (narrower scope) |
27 
28After 3 failures, stop and print:
29 
30```
31CONTEXT7_UNAVAILABLE
32Reason: <quota|rate-limit|no-match|timeout>
33Action: Ask user to retry later, paste official docs URL, or run `bts docs <lib>`.
34Do NOT substitute training-data answers without labeling them UNVERIFIED.
35```
36 
37## Fetch Cache (ETag-revalidated)
38 
391. **Cache key:** `"<libraryId>:<normalized-query>"` (lowercase, trimmed).
402. **Read:** `bash scripts/lib/doc-fetch-cache.sh get "<key>"` — exit 0 → use cached body.
413. **Miss / stale:** call `query-docs`; store via `doc-fetch-cache.sh put`.
424. **TTL:** 300s default (`DOC_CACHE_TTL`). Stale entries refresh on next fetch; honor `ETag` when MCP returns it.
43 
44`bts docs <lib>` shares the same cache helper when invoked from this skill.
45 
46## Process
47 
481. `resolve-library-id` with `libraryName` + full user `query`.
492. Select match: name similarity, reputation, benchmark score; prefer version-specific IDs when user names a version.
503. `query-docs` with `libraryId` + specific question (one concept per call).
514. Answer using fetched docs; cite library/version when relevant.
52 
53## Verify
54 
55→ verify: `test -f scripts/lib/doc-fetch-cache.sh`
56