deep-dive — команда для Claude Code: что делает и как установить
Слэш-команда deep-dive разбирает тему по нескольким углам: механика, история, практика, ограничения. Готовый отчёт с источниками сохраняет в artifacts/research/.
MIT ★ 1 988 обновлён 2026-04-01
/plugin marketplace add glittercowboy/taches-cc-resources
/plugin install taches-cc-resources@taches-cc-resourcesЧто делает deep-dive
Тема берётся из аргумента, а если его нет — из текущего разговора. Перед началом команда задаёт 2–4 вопроса через AskUserQuestion: что нужно понять, какая глубина, какой угол. Дальше развилка из трёх вариантов: начать, задать ещё вопросы или добавить контекст самому.
Отчёт идёт по одной схеме: краткое резюме, ключевые вопросы, обзор, механика, история, паттерны, ограничения и крайние случаи, текущее состояние, выводы, оставшиеся неизвестные. Блок claude_context в конце перечисляет, когда подход применять и когда нет, какие библиотеки и паттерны брать, с чем он конфликтует. Готовый файл ложится в artifacts/research/ под именем вида YYYY-MM-DD-[topic]-deep-dive.md, путь команда печатает в ответе.
Каталог artifacts/research/ создаётся в текущей рабочей директории. Из-за вопросов на входе это не инструмент для быстрой справки: пока не ответишь, исследование не начнётся.
Какие задачи решает
- разобрать незнакомую технологию до механики, а не до пересказа документации
- проследить, зачем инструмент появился и что он заменил
- выписать ограничения и крайние случаи до начала внедрения
- сохранить датированный отчёт с источниками внутри репозитория
- подготовить вводные для
/plan/project
Примеры запросов агенту
/deep-diveСетевое взаимодействие в Kubernetes: нужна механика и типичные ошибки- Запусти
/deep-diveбез аргумента и разбери тему, которую мы сейчас обсуждаем /deep-diveСравни Postgres и SQLite для небольшой консольной утилиты
Как установить deep-dive
1Через маркетплейс плагинов
/plugin marketplace add glittercowboy/taches-cc-resources/plugin install taches-cc-resources@taches-cc-resources2Вручную: положить файлы
.claude/commands/deep-dive.mdВызов — /deep-dive. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/deep-dive.mdВызов — /prompts:deep-dive. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/deep-dive.prompt.mdВручную: положить файлы
.gemini/commands/deep-dive.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о deep-dive
Как установить deep-dive в Claude Code?
Добавьте маркетплейс: /plugin marketplace add glittercowboy/taches-cc-resources, затем поставьте плагин: /plugin install taches-cc-resources@taches-cc-resources. Файл самой команды лежит в .claude/commands/deep-dive.md.
Что делает deep-dive?
Проводит исследование по заданной теме и складывает результат в один файл: механика, история, паттерны, ограничения, выводы. В конце предлагает следующий шаг — применить знание или запустить /plan/project.
Куда сохраняется отчёт deep-dive?
В каталог artifacts/research/ текущей рабочей директории. Имя файла — дата, слаг темы и суффикс deep-dive.md, например 2025-01-15-kubernetes-networking-deep-dive.md.
Исходный текст
deep-dive.md · MIT
--- description: Comprehensive investigation of a topic - thorough analysis with sources argument-hint: [topic or leave blank for current context] --- <objective> Conduct a deep-dive investigation into $ARGUMENTS (or the current topic if no arguments provided). Go beyond surface-level understanding. Synthesize multiple sources into comprehensive knowledge. </objective> <intake_gate> <context_analysis> First, analyze $ARGUMENTS to extract what's already provided: - The topic to investigate - Specific questions to answer - Depth required - How this knowledge will be used Only ask about genuine gaps - don't re-ask what's already stated. </context_analysis> <initial_questions> Use AskUserQuestion to ask 2-4 questions based on actual gaps: **If questions unclear:** - "What do you need to understand?" with options: How it works, When to use it, Why it exists, Limitations/gotchas, All of the above, Other **If depth unclear:** - "How deep should I go?" with options: Overview (key points only), Solid understanding (main concepts), Comprehensive (thorough coverage), Other **If focus unclear:** - "Any specific angles?" with options: Practical application, Theoretical understanding, Comparison to alternatives, Historical context, Other **If application unclear:** - "How will this be used?" with options: Inform implementation, Make architecture decision, Evaluate feasibility, General knowledge, Other Skip questions where $ARGUMENTS already provides the answer. </initial_questions> <decision_gate> After receiving answers, use AskUserQuestion: Question: "Ready to start the deep dive, or would you like me to ask more questions?" Options: 1. **Start research** - I have enough context 2. **Ask more questions** - There are details to clarify 3. **Let me add context** - I want to provide additional information If "Ask more questions" → generate 2-3 contextual follow-ups, then present decision gate again If "Let me add context" → receive input, then present decision gate again If "Start research" → proceed to research </decision_gate> </intake_gate> <process> After intake complete: 1. Define the scope and key questions to answer 2. Gather information from multiple angles: - How it works (mechanics) - Why it exists (history, motivation) - How it's used (patterns, best practices) - Where it fails (limitations, edge cases) - What's next (trends, evolution) 3. Synthesize into coherent understanding 4. Identify remaining unknowns </process> <output_format> ## Deep Dive: [Topic] ### Strategic Summary [2-3 sentences: what this is, key insight, main implication for our work] ### Key Questions - [Question this research answers] - [Question this research answers] ### Overview [2-3 paragraph synthesis of what this is and why it matters] ### How It Works [Detailed explanation of mechanics, architecture, or process] ### History & Context [Why it exists, what problem it solved, how it evolved] ### Patterns & Best Practices - [Pattern/practice 1]: [when and why] - [Pattern/practice 2]: [when and why] - [Pattern/practice 3]: [when and why] ### Limitations & Edge Cases - [Limitation]: [workaround or mitigation] - [Edge case]: [how to handle] ### Current State & Trends [Where things are heading, recent developments, community direction] ### Key Takeaways 1. [Most important insight] 2. [Second most important insight] 3. [Third most important insight] ### Remaining Unknowns - [ ] [Question that still needs answering] - [ ] [Question that still needs answering] ### Implementation Context <claude_context> <application> - when_to_use: [situations where this applies] - when_not_to_use: [situations to avoid this] - prerequisites: [what must be true to use this] </application> <technical> - libraries: [relevant packages/tools] - patterns: [code patterns to follow] - gotchas: [common mistakes, edge cases] </technical> <integration> - works_with: [complementary technologies] - conflicts_with: [incompatible approaches] - alternatives: [other options to consider] </integration> </claude_context> **Next Action:** Apply this knowledge to implementation, research specific aspect deeper, or run /plan/project ### Sources - [Source name]: [URL] - [date accessed] - [Source name]: [URL] - [date accessed] </output_format> <artifact_output> Save the research to a file: 1. Create directory structure if it doesn't exist: - `[current-working-directory]/artifacts/research/` 2. Generate filename from topic: - Get current date in YYYY-MM-DD format - Slugify the topic (lowercase, hyphens for spaces) - Format: `YYYY-MM-DD-[topic]-deep-dive.md` - Example: `2025-01-15-kubernetes-networking-deep-dive.md` 3. Write the complete research to the file 4. Report to user: "Saved to `artifacts/research/[filename]`" </artifact_output> <success_criteria> - Answers the key questions thoroughly - Goes beyond surface-level (not just "what" but "why" and "when") - Identifies limitations honestly - Synthesizes into actionable understanding - Implementation context is specific enough for Claude to apply - Clear about what's still unknown - Output saved to artifacts/research/ directory </success_criteria>
© Lex Christopherson · MIT · glittercowboy/taches-cc-resources