# retrieval-wasp-drone

Субагент retrieval-wasp-drone для поискового слоя приложения: полнотекстовый поиск Postgres, pgvector, гибридная сшивка RRF и оценка recall по золотому набору запросов.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 96 у репозитория
- Автор: Legion Code Inc.
- Лицензия: AGPL-3.0-or-later · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/data-and-ai-tools/agents/retrieval-wasp-drone.md
- Обновлён: 2026-10-18
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/retrieval-wasp-drone

## Что делает

Субагент ведёт поисковую часть приложения. По умолчанию это Neon Postgres: корректность `tsvector` и `websearch_to_tsquery`, ранжирование через `ts_rank`, семантический recall на pgvector, гибридная сшивка Reciprocal Rank Fusion и опциональный cross-encoder вторым этапом. Отдельно он занимается нарезкой документов на чанки и считает recall и precision по золотому набору запросов.

Сначала он смотрит, какая реализация уже стоит в проекте. Если есть `tsvector` и Drizzle-схема, работа идёт по гайдам Postgres. Если есть `grep-core.ts` и `deeplake-schema.ts`, разбираем Deep Lake: один `UNION ALL` по таблицам `memory` и `sessions`, косинус через `<#>` и тихий откат на BM25/`ILIKE`, когда эмбеддинги выключены. Ветка skillify с гейтом KEEP/MERGE/SKIP на Haiku описана как одна из возможностей, а не как весь домен. Маршрутная таблица режимов лежит в `retrieval-stinger/SKILL.md`, отчёты складываются в `library/requirements/reports/retrieval/`.

Границы жёсткие: модель и демон эмбеддингов ведёт `embeddings-runtime-wasp-drone`, колонку и индекс — `vector-store-wasp-drone`. Запрос про схему вектора этот субагент не закроет.

## Требования
- Работает с: PostgreSQL

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add legioncodeinc/vibe-coding-tools
```
В чате агента (не в терминале):
```text
/plugin install data-and-ai-tools@wasp-nest
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/retrieval-wasp-drone.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/retrieval-wasp-drone.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/retrieval-wasp-drone.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/legioncodeinc/vibe-coding-tools/tree/HEAD/plugins/data-and-ai-tools/agents/retrieval-wasp-drone.md

## Когда брать
- разобраться, почему запрос не нашёл нужный документ
- сшить полнотекстовый и векторный поиск через RRF
- подобрать нарезку документов под поиск
- посчитать recall и precision на золотом наборе запросов
- проверить, не ушёл ли семантический поиск в откат на `ILIKE`

## Примеры запросов агенту
- Почему этот запрос ничего не нашёл? Разбери поисковую ветку и скажи, какие плечи сработали.
- Добавь cross-encoder поверх RRF и покажи, как меняется recall на золотом наборе.
- Проверь, не ушёл ли семантический поиск в тихий откат на BM25/`ILIKE`.

## Похожие
- [rag-retrieval](https://affpapa.org/nevibecode/skills/rag-retrieval.md) — скилл · 1500 установок
- [postgres-semantic-search](https://affpapa.org/nevibecode/skills/postgres-semantic-search.md) — скилл · 227 установок
- [stash-ai-memory](https://affpapa.org/nevibecode/skills/stash-ai-memory.md) — скилл · 299 установок
- [Memory Vault](https://affpapa.org/nevibecode/mcp/memory-vault.md) — MCP-сервер · ★ 67 у репозитория
- [Lore](https://affpapa.org/nevibecode/mcp/agentkitai-lore.md) — MCP-сервер · ★ 10 у репозитория
- [Provena Agent Memory](https://affpapa.org/nevibecode/mcp/provena-agent-memory.md) — MCP-сервер · ★ 8 у репозитория

Из того же набора: [legioncodeinc/vibe-coding-tools](https://affpapa.org/nevibecode/by/legioncodeinc/vibe-coding-tools.md) — 172 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
