obsidian-vault

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, глобально, регистронезависимо. Это значит:

• Перемещение файла между папками не ломает ссылки, пока имя уникально.
• Дубликат имени файла = поломанные ссылки (Obsidian выберет один из двух наугад). Перед переименованием/созданием:

  find . -name "<новое имя>.md" -not -path "./.git/*" -not -path "./files/*"
  

• Регистр в [[link]] не обязан совпадать с именем файла.
• Wikilinks могут указывать на медиа в files/ ([[image.png]]).

Исключение — скиллы. Все файлы скиллов называются одинаково, 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]», а не перечисляют конкретные открытые символы — иначе задача, которую плагин пометил нестандартным статусом, тихо выпадает из обзора.

1. При закрытии задачи перенеси её строку (вместе с подпунктами-отступами) в верхний блок под # Week: — сразу после последней - [x] и до первой открытой задачи. Задачу, закрытую из # Week+, тоже переноси в этот блок. Если завершённых задач ещё нет, вставь её сразу после заголовка # Week:, перед первой открытой.
2. Позиция по умолчанию — в начало блока открытых задач секции # Week:: сразу после последней - [x] и её подпунктов, перед первой открытой (любой чекбокс, кроме - [x]). Если в Week нет завершённых — сразу после заголовка # Week:.
3. «На потом» / «неделя+» — в конец # Week+, перед строкой-легендой. Явное «в конец» — последней строкой секции # Week: (перед заголовком # Week+).
4. Заголовки секций # Week: / # Week+ и строку-легенду не удаляй и не переставляй. Не меняй порядок других задач и не схлопывай пустые строки-разделители между смысловыми группами, если они уже есть в файле.

Добавить запись о созвоне

1. Имя: Log/YYYY/MM/YYYY-MM-DD <тема>.md
2. Если апдейт большой — упомяни в 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]] продолжат работать, относительные ссылки — сломаются.

Поднять оторвавшуюся ссылку

# Найти все wikilinks
grep -rh "\[\[[^]]*\]\]" --include="*.md" | grep -oP '\[\[[^]|#]+' | sort -u
# Проверить, что таргет существует
find . -iname "<target>.md"

Восстановить потерянные данные вольта

Если файлы затёрты и в git их нет (правки не коммитились), источники восстановления по убыванию полноты:

1. Файловый бэкап машины. Если у машины есть файловый бэкап (restic, borg, Time Machine), в нём лежит и .claude/, и .obsidian/, и незакоммиченное. Конкретная схема — в vault-скилле этого vault. Восстанавливай в отдельный каталог и сравнивай, а не поверх рабочего дерева — часть свежих изменений может быть легитимной.
2. Транскрипты сессий — ~/.claude/projects/<slug>/*.jsonl: результаты Read содержат полный текст файла на момент чтения. Помогает, когда бэкап старше нужного состояния.
3. File recovery в Obsidian — снапшоты в IndexedDB на той машине, где правили; переживают откат файла на диске.
4. 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 — месячный обзор, ревизия глубокого бэклога.