
deepdive
Meta-research под вопрос или решение: веб-поиск, академические источники, Q&A отчёт с атомарными пере-используемыми тезисами.
- GitHub stars
- 373
Install
/plugin install deepdive@deepdiveRun it inside Claude Code after adding the marketplace with /plugin marketplace add Socialpranker/deepdive.
Contents
Discovered from sourceSkills 1
Deepdive — meta-research с дисциплиной
Источник = файл с дословными цитатами, отчёт = Q&A. Скрипты запускать из ~/.claude/skills/deepdive: uv run scripts/X.py. Проверки печатают первые 15 ошибок и 5 предупреждений; --verbose — только когда чинишь конкретную. N конкурентов по фиксированной матрице — обычная таблица, не deepdive.
Глубина
По умолчанию medium; shallow или deep — только если тема явно тривиальна или решение high-stakes. Объяви режим с обоснованием, после Genre+Plan — одной строкой model routing (фазы по моделям, цена, как перебить: «всё на opus» / «cheap mode»); model_routing.md.
| Режим | Источников | Fetcher-агентов | Всего суб-агентов за прогон |
|---|---|---|---|
| shallow | 5–7 | 0 | 0 |
| medium | 25–30 (из 60–100 кандидатов) | 3–4 | ≈14–17 (scout, пул кандидатов, Haiku-проходы, синтезатор, red team) |
| deep | 35–45 (из ≥100 кандидатов) | 5–6 | ≈22–27 |
Суб-агент не запускается на то, что главный поток закроет за несколько вызовов или что считает скрипт.
Перед стартом
- Найди целевую папку и перечисли содержимое; похожий slug — спроси «это update?»; прочитай
CLAUDE.mdиmemory/MEMORY.md: не дублируй сделанное. - Вики прошлых прогонов:
uv run scripts/wiki_query.py --topic "<вопрос>"; непогашенное противоречие идёт вplan.mdвопросом.wiki.md. - Папка: research-папка из CLAUDE.md или
research/,06_Деск-ресёрч/,docs/research/; иначеresearch/(есть манифест),06_Деск-ресёрч/(только документы),~/deepdive/<slug>/(не git-репо). Slug — латиница, дефисы. Путь покажи один раз.
Workflow — 13 фаз
Состав и гейты — phases.yaml (шаг 6.9 не фаза гейта: проверяется артефакт readout.md). Детали фазы — свой файл references/phases/, оглавление в workflow.md; при входе в фазу читай только её файл. Исполнитель: main — главный поток, sub — субагент.
- Reframing [
main] — Decision Spec: решение, потребитель→следующий шаг, ≥1 вилка «покажет X → делаю A» (нет вилки ⇒ даунгрейд в shallow вслух); 2–4 опровергаемые гипотезы.question_reframing.md - Genre & blocks [
main] — жанр и блоки, подтвердить строкой.genres.md,blocks/INDEX.md - Plan [
main] —plan.md§0–16.plan_template.md3.5. Capability Discovery [sub: explore-haiku] (deep) — ключи, API, fallback.capability_discovery.md3.7. Plan-review gate [main] (shallow пропуск) — показать план до дорогой Фазы 4; deep ждёт «Ок», потому что это единственная точка человека, а субагент спросить не может.plan_gate.md - Поиск [
main+sub: explore-haiku+sub: deepdive-fetcher] — каналы по Source Dispatch; пул кандидатовcandidates.csvпо матрице «сфера × позиция» и ≥1 академическому API, отбор на чтение по квотам сфер, второй раунд по переменной решения (гейтvalidate_phases.py,phases/p4_search.md4.1); числа сначала через registry/API; fetcher'ам непересекающиеся диапазоны id и разные оси поиска; тонкий ответ WebFetch (<500 знаков, нет цитаты) ⇒fetch_source.py;state.mdперезаписывается перед каждым раундом (≤6 КБ), иначе контекст копит транскрипт.source_dispatch.md,subagents_v2.md - Claims-ledger [
sub: explore-haiku] —claims.csv; статус и потолок уверенности считаетscore_claims.py --write, не модель (она завышает).source_scoring.md5.5. Evidence-фильтр [sub: explore-haiku] (medium/deep) — relevance×authority;unknown— карантин.evidence_filter.md5.7. Сверка с вики [sub: explore-haiku] (medium/deep) — до синтеза; конфликт с прошлым ресёрчем = обе позиции в отчёт.wiki.md - Синтез + red team [
sub: deepdive-synthesizer+sub: deepdive-redteam; shallow —main] —outline.md→ отчёт по секциям →numbers.csv→ враждебные роли → один раунд ремедиации HIGH →memo.md. Источники и блоки читает синтезатор, главный поток — только его сводку иmemo.md. Finder ≠ fixer.phases/p6_synthesis.md«Оркестрация»,adversarial_pass.md6.5. Verify [sub: explore-haiku, effort medium] (medium/deep) — четыре оси →.verify/*.json; чинится отчёт, не ledger.runtime_verification.md6.9. Человеческая версия [main] (medium/deep) —readout.md, затемhumanizer-ru, затемuv run scripts/build_report.py <run>.report_export.md - Refresh targets + роевая постобработка [
main] (medium/deep) —refresh_targets.md, затемcollect_observations.py→update_priors.py→promote_candidates.py --track; порядок и флаги вswarm_postprocess.md, читать перед первым вызовом. - Decision walkthrough [
main] (всегда) — пройти с пользователем по вилкамmemo.md; на вилки за него не отвечать. Исход →application.md.decision_walkthrough.md
Stop-criteria — по содержанию, не по бюджету
Стоп: гипотезы подтверждены или опровергнуты ≥3 разнотипными источниками либо помечены «данных мало»; разобран ≥1 поиск оппозиции («X criticism / problems with X»); 4+ типа источников; насыщение — 5 источников подряд без нового claim_id и нового root: (считать по файлам).
Не стоп: источники противоречат (копай причину), все одного типа, контраргумент без разбора.
Бюджет: на medium/deep red team (6), Verify (6.5), readout.md (6.9) и finish.py не пропускаются и не сливаются в одного агента. Задан лимит денег (--max-budget-usd) — до Фазы 4 отложи ~40% на фазы 6–Finish и урезай раунды поиска и число фетчеров, а не поздние фазы; урезание — строкой в Урезано: меморандума. N9 (2026-10-28) потратил бюджет на поиск и остановился до red team с Урезано: —.
Тупик: третий поиск подряд даёт источники с total < 8 ⇒ стоп, в Open Questions «литература слабая», предложи интервью или эксперимент.
Finish-up
- Запусти
uv run scripts/finish.py --research-dir <root>/<slug>(--offlineбез сети): он сам строитsources.csv, сверяет леджер, гоняет liveness, пишет в вики и последним прогоняетvalidate_phases.py --strict. Красный ⇒ фаза пропущена: доделай, перезапусти, до зелёного не рапортуй «готово». Шаги по одному не гонять — пропуск флага и есть пропуск фазы. - Человеку — одна ссылка на
<date>_<slug>.html(desktop:SendUserFile), ниже PDF и папка прогона;memo.mdи технический отчёт в чат не выносить. - Резюме 5–8 строк языком
readout.md, без кодов леджера: ответ · что поменяет решение · главный контраргумент · чего не нашли · итог walkthrough. - Предложи 2–3 следующих ресёрча; есть
memory/— 1–3 кандидата в память.
Что не делать
Полные формулировки и артефакты прогона — phases/rules.md.
- Не пропускать 5.5, 5.7, red team (medium/deep) и Фазу 8; не запускать medium/deep без if-then вилки; не писать финал «it depends».
- Не выдавать уверенность выше, чем даёт
score_claims.py: без primary — не вышеmedium, непогашенныйdissentот сильного источника =contested,root:/discovery_path:не копировать. - Число без производителя и
data_as_ofвmemo.mdне идёт; проценты и доли — только вnumbers.csvсformula: оси 6.5 арифметику не проверяют. - WebFetch обходить только через
fetch_source.py, неcurl: он читает robots.txt и чистит страницу от prompt injection. - Fetch-агентов не поднимать на opus «для качества» (растёт уверенность ошибки, не качество); во второй раунд — только дыры, не находки соседей.
- Из одного источника не цитировать дословно >25 слов; факт из памяти берётся без веб-сверки, только если шанс, что он изменился, <10%.
humanizer-ruпоreadout.mdне пропускать, технический отчёт им не чистить;memo.mdвместо страницы человеку не отдавать.
Режим update
update <slug> / «обнови ресёрч X» — дельта, не replay: diffs/<date>_delta.md, новый отчёт только если дельта существенна (решает пользователь), после дельты wiki_ingest.py и wiki_pair.py build. refresh_protocol.md
References — читать при входе в фазу, не заранее
Выше названы файлы по фазам. Базовые для medium/deep: файл текущей фазы из phases/, question_reframing.md, plan_gate.md, genres.md (6 жанров), blocks/INDEX.md (106 блоков), channels.md (29 каналов), source_dispatch.md, model_routing.md, wiki.md. По условию: awesome_lists_registry.md (3.5), stat_sources/INDEX.md и api_sources/INDEX.md (47+ endpoints; когда подвопрос количественный, ключи — через env vars), fetch_ladder.md (4.2), NOTES_dated.md (датированные факты).
Sponsors
Details
- Marketplace
- Socialpranker/deepdive
- Category
- Community