Vault Briefing — Брифинг из Obsidian

Назначение

Перед началом работы над проектом Claude должен знать:

• Что уже было сделано в этом направлении (не повторять)
• Какие паттерны [AVOID] применимы (не наступать на грабли снова)
• Какие гипотезы и методы уже изучены (использовать готовое)
• Какие заметки в vault прямо сейчас актуальны для этого проекта

Без этого скилла: пользователь вручную пишет "найди в Obsidian всё про X" каждый раз. С этим скиллом: один вызов → структурированный брифинг с WHY-объяснением.

Конфигурация vault

VAULT_ROOT = C:/Users/serge/Documents/claude-vault
PATTERNS   = C:/Users/serge/.claude/memory/_auto/patterns.md
WIKI       = C:/Users/serge/.claude/memory/wiki/
PROJECT_MD = VAULT_ROOT/projects/[PROJECT].md

PHASE 1: DETECT PROJECT CONTEXT

Входной аргумент: $ARGUMENTS — название проекта или описание задачи.

Шаг 1а: Читай project file если существует

# Ищем в projects/ файл с именем похожим на $ARGUMENTS
ls "C:/Users/serge/Documents/claude-vault/projects/" | grep -i "[PROJECT_KEYWORD]"

Если файл найден — читай его frontmatter:

• tags: → список тегов (основа поиска)
• status: → если killed/archived → особое внимание к lessons
• related упоминания внутри файла

Шаг 1б: Определи домен автоматически

Если проект не найден или нет frontmatter — определяй домен по ключевым словам:

PHASE 2: PARALLEL SEARCH

Выполни ВСЕ следующие поиски одновременно (один блок tool calls):

2а: Паттерны из patterns.md [HIGHEST PRIORITY]

grep -n -i -A3 "\[AVOID\]\|\[REPEAT\]" "C:/Users/serge/.claude/memory/_auto/patterns.md" | grep -i "[TAG1]\|[TAG2]\|[DOMAIN_KEYWORD]"

Ищи паттерны где хотя бы одно слово из тегов/домена проекта встречается в тексте.

2б: Активные гипотезы

ls "C:/Users/serge/Documents/claude-vault/pipeline/hypothesis/"

Читай frontmatter каждого файла: tags, project, status.

2в: Методология

ls "C:/Users/serge/Documents/claude-vault/knowledge/methodology/" 2>/dev/null
ls "C:/Users/serge/Documents/claude-vault/knowledge/tools/"

Ищи файлы с именами содержащими domain keywords.

2г: Wiki (обработанные уроки сессий)

grep -rl "[DOMAIN_KEYWORD]\|[TAG1]" "C:/Users/serge/.claude/memory/wiki/" | head -10

2д: MOC cross-references

Grep по уже прочитанным MOC (Solo Founding, Research Science, AI-Era Engineering): найди упоминания похожих проектов как "related" или "смежный".

2е: killed/archived projects (ТОЛЬКО при --deep или если статус = killed)

grep -rl "KILLED\|killed\|status: killed\|status: archived" "C:/Users/serge/Documents/claude-vault/projects/" | head -5

Killed проекты = ценнейший источник lessons learned.

PHASE 3: RELEVANCE SCORING

Для каждого найденного элемента считай Score (используй в уме, не показывай пользователю):

Relevance Score = Tag_overlap × 3 + Keyword_match × 2 + Domain_proximity × 1

• Tag overlap: сколько тегов проекта совпадают с тегами найденной заметки (0-5)
• Keyword match: сколько ключевых слов домена встречается в тексте (0-5)
• Domain proximity: прямой домен = 3, смежный = 2, косвенный = 1

Фильтр: показывай только элементы с Score ≥ 4. Лимит: максимум 15 элементов в финальном выводе. Дедупликация: если два элемента говорят одно и то же — оставь тот с выше Score.

PHASE 4: STRUCTURED BRIEF

Выведи брифинг в этом формате:

## Context Brief: [PROJECT NAME]
Домен: [определённый домен] | Статус в vault: [найден/не найден/killed]

━━━ ⚠️ ПАТТЕРНЫ: НЕ ПОВТОРЯТЬ ━━━━━━━━━━━━━━━

[AVOID] [паттерн из patterns.md]
→ Почему релевантно: [объяснение связи с текущим проектом]
→ Как проявляется здесь: [конкретный риск]

(максимум 3 AVOID паттерна)

━━━ ✅ ЧТО РАБОТАЛО — ПРИМЕНИТЬ ━━━━━━━━━━━━━

[REPEAT] [паттерн]
→ Почему применимо: [объяснение]

(максимум 2 REPEAT паттерна)

━━━ 🔬 БЫЛО СДЕЛАНО В ЭТОМ НАПРАВЛЕНИИ ━━━━━━

[если есть killed/archived проект похожего типа]:
⚰️ [Название] — убит потому что [kill reason]
   Главный урок: [что можно взять]

[если есть active related проект]:
🔗 [Название] — [как связан] → можно переиспользовать [что именно]

━━━ 💡 АКТИВНЫЕ ГИПОТЕЗЫ ━━━━━━━━━━━━━━━━━━━

- [Гипотеза] — [почему релевантна для текущего проекта]

━━━ 🔧 МЕТОДЫ И ИНСТРУМЕНТЫ (уже изучены) ━━━

- [Метод/инструмент] из [файл] — [как применить здесь]

━━━ 📚 ТОП-5 ЗАМЕТОК ━━━━━━━━━━━━━━━━━━━━━━━

1. [[путь/к/заметке]] — WHY: [одна фраза почему именно эта заметка полезна]
2. ...

━━━ 🔗 РЕКОМЕНДУЕМЫЕ СВЯЗИ ━━━━━━━━━━━━━━━━━

Добавь в [PROJECT].md эти wikilinks:
- [[notes/X]] — [причина связи]
- [[notes/Y]] — [причина связи]

━━━ ❓ ПРОБЕЛЫ (чего нет в vault) ━━━━━━━━━━

[что было бы полезно но не найдено в vault]
→ Рекомендация: [создать заметку / запустить research / спросить /last30days]

Режимы

/vault-briefing [проект] — стандартный брифинг

Все 4 фазы, вывод полный.

/vault-briefing --brief [проект] — быстрый старт (3 мин)

Только:

• Топ-3 AVOID паттерна
• Топ-3 релевантные заметки с WHY
• Один конкретный следующий шаг

/vault-briefing --deep [проект] — глубокий поиск

Дополнительно к стандарту:

• Поиск в _auto/wiki/ (AI-generated wiki)
• Поиск в knowledge/research/ (концепции, эксперименты)
• Поиск в knowledge/predictions/ (прогнозы релевантные домену)
• Поиск по knowledge/lessons/ или L3-skills/
• Чтение 2-3 найденных файлов полностью (не только frontmatter)

/vault-briefing --new [проект] — режим нового проекта

Если projects/[проект].md ещё не существует:

• Создать шаблон с правильным frontmatter
• Предложить связи с существующими MOC
• Предложить теги на основе домена

ВАЖНЫЕ ПРАВИЛА

1. WHY обязателен — каждый элемент в выводе должен иметь объяснение почему именно он релевантен. Без WHY = бесполезный список ссылок.
2. Читай файлы ДО объявления релевантности — не угадывай по имени файла. Прочитай хотя бы frontmatter.
3. Killed проекты ценнее активных — если похожий проект был убит, это критическая информация. Всегда ищи причину смерти.
4. Не дампить всё подряд — лучше 5 точных результатов с объяснением, чем 20 без контекста.
5. Пробелы тоже важны — если чего-то нет в vault, это тоже инсайт. Скажи что не нашёл и предложи как получить.
6. Используй Bash для поиска, Read для содержимого — НЕ MCP для файлов с wikilinks (input_guard риск).

ПРИМЕР ВЫВОДА: /vault-briefing VeriFind

## Context Brief: VeriFind
Домен: ai-verification | Статус в vault: найден (projects/verifind.md, P1)

━━━ ⚠️ ПАТТЕРНЫ: НЕ ПОВТОРЯТЬ ━━━━━━━━━━━

[AVOID] Lab-grade ML threshold не работает в real-world
→ Почему релевантно: VeriFind оценивает LLM outputs — threshold для "verified"
  будет отличаться на синтетических тестах vs реальных документах
→ Как проявляется: DIR 53% на paper trading может упасть на live data

[AVOID] Coverage overclaim — README заявляет метрику без верификации
→ Почему: Sharpe 3.7 — не публиковать пока нет 30-дневного скользящего окна

━━━ 🔬 БЫЛО СДЕЛАНО В ЭТОМ НАПРАВЛЕНИИ ━━

⚰️ ArgosArb — убит потому что рынок закрыл арбитражное окно
   Главный урок: validation-first + multi-agent + 0% hallucination
   → применимо к VeriFind verification pipeline

━━━ 💡 АКТИВНЫЕ ГИПОТЕЗЫ ━━━━━━━━━━━━━━━

- hypothesis-revival-engine: "LLM confidence scores не коррелируют с accuracy"
  → напрямую релевантно для VeriFind scoring model

━━━ 📚 ТОП-5 ЗАМЕТОК ━━━━━━━━━━━━━━━━━━

1. [[knowledge/research/concepts/Organic Virality]] — WHY: если VeriFind
   показывает Sharpe 3.7, виральный loop через "публичный leaderboard"
2. [[projects/verifind-harvest-2026]] — WHY: готовые harvest assets Score 17+

Feedback (опционально)

После выдачи брифинга спроси одним сообщением:

"Какие секции были полезны? Что можно пропустить в следующий раз?"

Если пользователь ответил — запиши в raw/:

echo "# Feedback vault-briefing $(date +%Y-%m-%d)

Проект: [ПРОЕКТ]
Полезно: [ответ]
Лишнее: [ответ]
#feedback #vault-briefing" > "C:/Users/serge/.claude/memory/raw/feedback-vault-briefing-$(date +%Y%m%d).md"

Не спрашивай если пользователь явно торопится или написал --brief.

Связанные скилы

• /harvest — если нашёл полезный актив в vault → оцени Score
• /vault-health — если vault структура сломана до поиска
• /hypothesis-arbiter — если нашёл конкурирующие гипотезы
• /snr — если найденного слишком много → приоритизировать