| name | obsidian-vault |
| description | Use when reading, editing, organizing, or adding notes in a private Obsidian work vault — covers folder taxonomy, wikilink rules, where each kind of note belongs, sensitive-content handling, and Obsidian-specific conventions. |
Obsidian Vault
Overview
Приватный рабочий Obsidian vault: активные задачи, дневник работы, заметки, рисёрч и спецификации. Хранилище приватное — в нём могут быть контакты, реквизиты и черновики, не предназначенные для публикации.
When to Use
- Open / edit / create a note in the vault
- Decide where a new note belongs
- Search for existing information (people, companies, processes, tech docs)
- Move or rename a file (link integrity matters)
- Audit the structure or import external content
Don't use for: code in unrelated repos, generic Obsidian questions not specific to this vault.
Folder Taxonomy (ядро)
Базовые папки/файлы, на которых строится рабочий процесс:
| Folder / file | Contains |
|---|
tasks.md | Активные задачи. Разбит на секции # Week: (текущая неделя) и # Week+ (неделя+); завершённые - [x] собираются в верхний блок под # Week:. Чекбоксы с ➕ YYYY-MM-DD (создана) и ✅ YYYY-MM-DD (закрыта). Подгружается хуком при старте сессии. |
tasks-future.md | Бэклог из созвонов и идей, секции по доменам. Переносится в tasks.md вручную. На старте сессии не подгружается. |
Log/ | Хронологический журнал: дневные логи Log/YYYY/MM/YYYY-MM-DD.md. |
Log/Reports/ | Еженедельные отчёты, по одному документу на неделю (YYYY-MM-DD.md — дата дня report_day из .claude/vault-config.md, по умолчанию воскресенье; см. weekly-report). |
Notes/ | Идеи, риски, открытые вопросы, рисёрч (см. правило ниже). |
files/ | Все вложения (PDF, видео, картинки). Управляется Obsidian, исключено из поиска. |
Пример доменных папок (адаптируй под свой проект)
Поверх ядра обычно появляются тематические папки под конкретный проект. Это пример, не обязательная структура — называй и дели под свою предметную область:
| Folder | Назначение (пример) |
|---|
Platform/ | Спецификации продукта, UI, видение |
Parser/ | Технические доки и источники данных |
Processes and scenarios/ | Бизнес-процессы |
Companies/ | Подрядчики, фонды, реквизиты |
Management/ | Руководители, отделы, правила, шаблоны ролей |
Reports/ | Годовые/финансовые отчёты |
_TODO/ | Кросс-проектные задачи |
Корневой index.md — точка входа в vault: ссылки на лестницу задач, Log/, Notes/ и ключевые заметки, описание структуры, журнал изменений. Есть по умолчанию; поддерживается вручную.
Where to Put a New Note
Правило по умолчанию: создавай новую заметку рядом с источниками. Если делаешь документ на основе конкретных файлов (транскрипт планёрки, лог дня, заметка по компании) — клади его в ту же папку, где лежат источники. Это сохраняет контекст и позволяет ссылкам сидеть рядом. Уходи в тематическую папку (Notes/, доменные папки) только если:
- пользователь явно попросил конкретное место;
- документ заведомо переживёт исходный контекст (общая концепция, обновляемая спека, риск на будущее);
- источников нет вообще (документ синтезируется с нуля).
Пример: документ по итогам созвона → кладём в папку этого созвона рядом с транскриптом, не в Notes/. Если позже из этого вырастет общее видение — переносим в Notes/ отдельным движением.
Если источников несколько и они в разных папках — выбирай папку основного источника (тот, на который опирается 70%+ содержимого).
Для случаев, когда правило «рядом с источниками» не применимо (новая заметка с нуля):
Запись созвона, weekly-апдейт? → Log/YYYY/MM/ (имя: YYYY-MM-DD ...md)
Еженедельный отчёт? → Log/Reports/ (YYYY-MM-DD.md, день report_day; по умолчанию воскресенье)
Идея/риск/вопрос/наблюдение? → Notes/ (см. правило ниже)
Активная задача (нужно делать сейчас)? → tasks.md (с маркером `➕ YYYY-MM-DD`)
Задача из созвона, не для немедленной работы? → tasks-future.md (тематическая секция)
Вложение (PDF/видео/картинка)? → files/ (Obsidian положит само)
Тематический документ под домен? → доменная папка (Platform/, Companies/ и т.п.)
Куда в Notes/
Notes/ делится на два уровня:
Корень Notes/ — вечные стратегические ноты (идеи, риски, справочники, вопросы без срока). Привязка ко времени отсутствует — документ живёт годами. Держи ≤10 файлов; если больше, что-то лишнее.
Notes/YYYY/MM/ — всё остальное: исследования, планы, временные заметки, проекты. Папка определяется датой создания ноты.
Правило роста (файл → папка):
- Появился один файл →
Notes/YYYY/MM/тема.md
- Добавился второй связанный файл → сделай папку
Notes/YYYY/MM/тема/ и положи оба туда, сохраняя оригинальные имена файлов (чтобы не ломать wikilinks)
- Папка не переезжает из YYYY/MM при росте — дата создания фиксируется
- Исключение: папка-мини-проект, работа по которой продолжается в новом месяце, может переехать в текущий
Notes/YYYY/MM/. Переноси через git mv (wikilinks по basename не ломаются). Разовые/завершённые заметки оставляй в месяце создания.
Пример:
Notes/
Идеи.md ← вечная, в корне
2026/05/
Изменение рубрик.md ← одна нота
Drive Audio Extractor/ ← вырос в проект
Drive Audio Extractor — план.md
Транскрибация — варианты.md
Conventions
Параметры, которые в разных vault разные, лежат в .claude/vault-config.md (прежнее имя — .claude/vault-paths.md, оно тоже читается). Ключи: weekly_report, report_day, monthly_report, year_goals, dashboard, tasks_legend, work_email. Ключа нет — скилл берёт документированный дефолт и говорит об этом в финале.
Языки имён
- Папки/разделы — английский (
Log, Notes, Reports, и т.п.). Английские имена папок дают чистые URL, если vault когда-нибудь публикуется статическим генератором.
- Содержимое нот — на любом удобном языке.
- Имена файлов — допустим любой язык; в URL транслитерируются автоматически. Новые папки создавай по-английски.
Префикс _
_meta, _TODO, _Page blocks, _Template pages — _ поднимает папку в начало списка в Obsidian. Используется для мета-документов и UI-каркаса, к которым обращаешься часто. Не используй _ для обычного контента.
Индексные файлы и файлы-списки в папке
Если в папке есть файлы-списки или индексные файлы (обзор, каталог, сводка), а рядом лежат тематические документы:
- Если 1 такой файл и остальное — тематические ноты → добавь префикс
_ к индексному файлу (_Обзор.md, _index.md), чтобы он поднялся вверх и не путался с контентом.
- Если 2 и более файлов-списков/индексов → предпочти вложенную папку для тематических нот (или, наоборот, для индексов), чтобы структура читалась без путаницы.
- Если непонятно, какие файлы «списочные», а какие «контентные» — предложи варианты и спроси пользователя, не переименовывай автоматически.
Примеры:
Журнал/
_Обзор.md ← индексный, с _ (выше других)
2026-04-01.md
2026-04-08.md
Media data sources/
_Список/ ← папка для индексов
Каталог.md
Список источников.md
SimilarWeb.md
Файл _index.md обязан иметь frontmatter с title. Иначе в графе и при публикации заголовок отображается как «_index». Title — человекочитаемое имя папки/раздела. Пример:
---
title: Отделы
---
Имена логов
Файлы внутри Log/YYYY/MM/ — YYYY-MM-DD.md или YYYY-MM-DD <короткое описание>.md. Сохраняй формат — он используется для сортировки.
Уникальность имён документов
Имя файла должно быть уникальным и понятным вне контекста папки. Wikilinks Obsidian резолвятся по basename глобально, поэтому общие имена («Результаты», «Ссылки», «Заметки», «План», «Итоги») приводят к коллизиям и хрупким ссылкам.
Если содержимое описывается общим словом, добавляй префикс по теме (обычно — название родительской папки или проекта):
- ❌
Результаты.md → ✅ Чистка ссылок - Результаты.md
- ❌
Ссылки.md → ✅ Чистка ссылок - Ссылки.md
- ❌
План.md → ✅ Drive Audio Extractor — план.md
Разделитель — - или — (по контексту папки). Перед созданием файла с потенциально общим именем проверь:
find . -iname "<имя>.md" -not -path "./.git/*" -not -path "./files/*"
Заголовки внутри файла
Не дублируй имя файла как # Заголовок в его теле — Obsidian уже показывает имя файла как заголовок ноты. Первый # в теле = ещё один уровень вложенности, и оглавление выглядит «двойным».
Начинай содержимое сразу с текста или с ## Подзаголовок. Исключение — когда нужен явный alias/название, отличающееся от имени файла (редкий случай).
Нумерация-приоритет в папках
Иногда файлы префиксуют цифрой-рангом: 0. Foo.md, 1. Bar.md, -1. Baz.md. Цифра — субъективный ранг/приоритет, не порядковый номер. Не перенумеровывай при добавлении; используй ближайшее свободное число.
Короткие ответы
Если пользователь просит короткий ответ (short answer), скилл сообщает только суть: что сделано и куда попало, без имени файла и номера строки, одной фразой; формулировка задачи начинается с глагола, вводные слова убраны.
Перед каждым таким ответом проверь, есть ли .claude/short-answer.md — не полагайся на то, что читал его раньше в этой сессии. Файл есть — он задаёт тон, род и длину, и его указания главнее формулировок скилла. Файла нет — работает правило выше.
Wikilink Rules (важно)
Obsidian резолвит [[Имя файла]] по basename, глобально, регистронезависимо. Это значит:
Исключение — скиллы. Все файлы скиллов называются одинаково, SKILL.md, поэтому [[имя-скилла]] резолвится в случайный/неверный файл и не работает. На скиллы ссылаются по имени в кодовом спане (имя-скилла), не вайклинком; браузабельный индекс всех скиллов — [[Skills list]].
Не используй относительные markdown-ссылки ([text](../folder/file.md)) — они хрупкие. Для нот vault — только [[wikilinks]] или абсолютные http-ссылки; для скиллов — код-спан по имени, см. исключение выше.
Sensitivity
Это приватный репозиторий. Может содержать:
- Реквизиты и регистрационные данные юрлиц
- Контракты и финансовые документы (
files/, отчёты)
- Индексы доступов и паролей
- Контакты и переписку с подрядчиками
- Раннюю стадию идей и рисков (
Notes/)
Не пушь в публичные remote'ы. Не копируй фрагменты в чужие чаты/issue без явного разрешения. Не публикуй ссылки на реквизиты или доступы. Если remote добавляется — убедись, что он приватный. Если vault когда-либо публикуется (статический сайт) — перед публикацией убедись, что в нотах нет лишних доступов/реквизитов. Работая через агентов или shell-команды, не выводи sensitive-контент наружу — в лог стороннего инструмента, вывод команды, который уйдёт в чужой сервис, или чужой чат.
Git в вольте
Вольт — не репозиторий кода. Пользователь правит его напрямую из Obsidian, а коммиты делаются редко, поэтому в рабочем дереве нормально лежат недели незакоммиченных правок. Их нет ни в индексе, ни в reflog — стереть их значит потерять насовсем.
Никогда не выполняй в вольте команды, затирающие рабочее дерево целиком, даже чтобы починить свою же историю коммитов: git reset --hard, git checkout -- ., git restore ., git clean -fd, repo-wide git stash. Если нужно откатить свой коммит — правь только историю (git reset --soft, git commit --amend) или ограничивай операцию явными путями: git restore --source=HEAD -- <файл>.
Перед любой git-командой, меняющей файлы, смотри git status --short: длинный список изменений в вольте — это рабочие данные пользователя, а не мусор от предыдущей неудачной попытки.
Коммить свои правки тоже пофайлово (git commit -- <путь>), не подхватывая git add . чужие незакоммиченные изменения.
Obsidian-Specific Settings
attachmentFolderPath: files — все вложения идут в files/.userIgnoreFilters: ["files/"] — files/ исключён из глобального поиска. Не клади туда .md ноты — их не найдут.alwaysUpdateLinks: true — при перемещении из Obsidian ссылки обновятся; при git mv — нет, но wikilinks по имени всё равно зарезолвятся..obsidian/workspace.json исключён из git (per-machine state).
Лестница задач
Шесть файлов, между которыми задача движется сверху вниз по мере остывания.
tasks.md — активный список. Две секции: # Week: (текущая неделя, завершённые - [x] всплывают наверх блока) и # Week+ (горизонт длиннее недели).projects.md — активные проекты: результат, требующий больше одной задачи. Верхнеуровневый - [ ] — проект, подчекбоксы с отступом — план, обычные подбуллеты — справка. Ближайшая задача каждого проекта зеркалится в # Week: с совпадающим текстом и обратной ссылкой - Проект: [[projects]]; close-task закрывает её в обоих местах.tasks-future.md — бэклог по темам.tasks-snoozed.md — отложенное: ➕ YYYY-MM-DD (когда добавлено) и 📅 YYYY-MM-DD (когда достать). См. snoozed-task и snoozed-review.tasks-recurring.md — регулярные дела, которые не закрываются насовсем.ideas.md — низ лестницы.
Путь демоции при разборе: # Week: → # Week+ → tasks-future.md → ideas.md. Обратный подъём — только через # Week: с новой датой ➕, равной дню активации.
Common Tasks
Записать работу по задаче
Любое движение по задаче (из tasks.md, _TODO/, или просто по ходу дня) фиксируется в файле дня Log/YYYY/MM/YYYY-MM-DD.md (см. скилл worklog).
- Один файл на день (без темы в имени) — туда дописываются все задачи и заметки за этот день.
- Если файл дня ещё не создан — создай его.
- Формат записи свободный, но привязывай к задаче (название из
tasks.md или wikilink на сущность).
- Новые задачи в
tasks.md записывай с датой появления: - [ ] <задача> ➕ YYYY-MM-DD.
- Закрытие задачи в
tasks.md сохраняет дату появления и добавляет дату закрытия: - [x] <задача> ➕ YYYY-MM-DD ✅ YYYY-MM-DD. Закрытие дублируй краткой записью в файле дня — что именно сделано.
- Перенос задачи
tasks-future.md → tasks.md: вырезать строку (с подзадачами) и вставить в секцию # Week: файла tasks.md, добавив ➕ YYYY-MM-DD (дата сегодня — момент, когда задача стала активной).
- Дневные логи разложены по годам и месяцам:
Log/YYYY/MM/YYYY-MM-DD.md. Каталоги создаются по мере надобности. Недельные отчёты — исключение, они лежат плоско в Log/Reports/YYYY-MM-DD.md, потому что их по одному в неделю.
Порядок задач в tasks.md
Файл разбит на секции # Week: (текущая неделя) и # Week+ (неделя+), ниже # Week+ — строка-легенда (ключ tasks_legend в .claude/vault-config.md; ключа нет — просто не трогай строку, начинающуюся с > Активные задачи). Внутри # Week: сначала идут завершённые (- [x]), потом открытые (- [ ]).
Закрытость чекбокса. В базе нет понятия отменённой или промежуточной задачи. Закрытой считается только строка - [x]. Любой другой чекбокс — пустой - [ ], а также любой статус, который проставил сторонний плагин (например, obsidian-tasks-plugin умеет отмечать «в работе» отдельным символом внутри тех же квадратных скобок) — и обычный незачёркнутый буллет считаются открытыми. Скиллы лестницы задач проверяют «не закрыто - [x]», а не перечисляют конкретные открытые символы — иначе задача, которую плагин пометил нестандартным статусом, тихо выпадает из обзора.
- При закрытии задачи перенеси её строку (вместе с подпунктами-отступами) в верхний блок под
# Week: — сразу после последней - [x] и до первой открытой задачи. Задачу, закрытую из # Week+, тоже переноси в этот блок. Если завершённых задач ещё нет, вставь её сразу после заголовка # Week:, перед первой открытой.
- Позиция по умолчанию — в начало блока открытых задач секции
# Week:: сразу после последней - [x] и её подпунктов, перед первой открытой (любой чекбокс, кроме - [x]). Если в Week нет завершённых — сразу после заголовка # Week:.
- «На потом» / «неделя+» — в конец
# Week+, перед строкой-легендой. Явное «в конец» — последней строкой секции # Week: (перед заголовком # Week+).
- Заголовки секций
# Week: / # Week+ и строку-легенду не удаляй и не переставляй. Не меняй порядок других задач и не схлопывай пустые строки-разделители между смысловыми группами, если они уже есть в файле.
Добавить запись о созвоне
- Имя:
Log/YYYY/MM/YYYY-MM-DD <тема>.md
- Если апдейт большой — упомяни в
index.md.
Найти всё по теме/подрядчику
find . -iname "*<тема>*"
grep -rli "<тема>" --include="*.md" .
Перенести ноту в другой раздел
git mv "Notes/Foo.md" "Platform/Foo.md"
git commit -m "refactor: move Foo.md into Platform/"
Wikilinks [[Foo]] продолжат работать, относительные ссылки — сломаются.
Поднять оторвавшуюся ссылку
grep -rh "\[\[[^]]*\]\]" --include="*.md" | grep -oP '\[\[[^]|#]+' | sort -u
find . -iname "<target>.md"
Восстановить потерянные данные вольта
Если файлы затёрты и в git их нет (правки не коммитились), источники восстановления по убыванию полноты:
- Файловый бэкап машины. Если у машины есть файловый бэкап (restic, borg, Time Machine), в нём лежит и
.claude/, и .obsidian/, и незакоммиченное. Конкретная схема — в vault-скилле этого vault. Восстанавливай в отдельный каталог и сравнивай, а не поверх рабочего дерева — часть свежих изменений может быть легитимной.
- Транскрипты сессий —
~/.claude/projects/<slug>/*.jsonl: результаты Read содержат полный текст файла на момент чтения. Помогает, когда бэкап старше нужного состояния.
- File recovery в Obsidian — снапшоты в IndexedDB на той машине, где правили; переживают откат файла на диске.
- Dangling-объекты git (
git fsck --lost-found) — только если файл хоть раз попадал в индекс.
Прежде чем восстанавливать, определи момент потери: find . -newermt "<время>" ! -newermt "<время+1m>" покажет пачку файлов, переписанных одной командой.
Common Mistakes
| Ошибка | Последствия | Фикс |
|---|
git reset --hard / git clean -fd в вольте | Стёрты недели незакоммиченных правок пользователя | Только пофайловые операции; восстанавливать из restic (см. выше) |
Создал .md внутри files/ | Не находится через поиск Obsidian | Перенеси в нужный тематический раздел |
| Дубликат имени файла | Wikilinks резолвятся в случайный из двух | Переименуй один; проверь find -iname перед созданием |
Использовал [text](relative/path.md) | Сломается при перемещении | Замени на [[wikilink]] |
Положил чувствительный документ в Notes/ | Незаметная утечка через скрин/копипаст | Маркируй чувствительные ноты или клади в защищённый раздел |
Перенумеровал N. ... | Конфликты, путаница в ссылках | Сохраняй существующие номера; используй ближайший свободный |
Связанные скиллы
new-task / close-task — открыть/закрыть задачу в tasks.md.list-tasks — утренний обзор открытых задач.worklog — запись хода работы в Log/YYYY/MM/YYYY-MM-DD.md.weekly-report — еженедельный отчёт в Log/Reports/.snoozed-task — отложить задачу в tasks-snoozed.md с датой активации.snoozed-review — разобрать отложенные, у которых наступила дата.weekly-review — недельное ревью лестницы и аудит projects.md.monthly-review — месячный обзор, ревизия глубокого бэклога.
