| 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/ | Хронологический журнал: дневные логи YYYY-MM-DD.md. |
Log/Reports/ | Еженедельные отчёты, по одному документу на неделю (YYYY-MM-DD.md, понедельник недели). |
Notes/ | Идеи, риски, открытые вопросы, рисёрч (см. правило ниже). |
files/ | Все вложения (PDF, видео, картинки). Управляется Obsidian, исключено из поиска. |
Пример доменных папок (адаптируй под свой проект)
Поверх ядра обычно появляются тематические папки под конкретный проект. Это пример, не обязательная структура — называй и дели под свою предметную область:
| Folder | Назначение (пример) |
|---|
Platform/ | Спецификации продукта, UI, видение |
Parser/ | Технические доки и источники данных |
Processes and scenarios/ | Бизнес-процессы |
Companies/ | Подрядчики, фонды, реквизиты |
Management/ | Руководители, отделы, правила, шаблоны ролей |
Reports/ | Годовые/финансовые отчёты |
_TODO/ | Кросс-проектные задачи |
Корневые файлы по желанию: index.md — точка входа, описание структуры, журнал изменений.
Where to Put a New Note
Правило по умолчанию: создавай новую заметку рядом с источниками. Если делаешь документ на основе конкретных файлов (транскрипт планёрки, лог дня, заметка по компании) — клади его в ту же папку, где лежат источники. Это сохраняет контекст и позволяет ссылкам сидеть рядом. Уходи в тематическую папку (Notes/, доменные папки) только если:
- пользователь явно попросил конкретное место;
- документ заведомо переживёт исходный контекст (общая концепция, обновляемая спека, риск на будущее);
- источников нет вообще (документ синтезируется с нуля).
Пример: документ по итогам созвона → кладём в папку этого созвона рядом с транскриптом, не в Notes/. Если позже из этого вырастет общее видение — переносим в Notes/ отдельным движением.
Если источников несколько и они в разных папках — выбирай папку основного источника (тот, на который опирается 70%+ содержимого).
Для случаев, когда правило «рядом с источниками» не применимо (новая заметка с нуля):
Запись созвона, weekly-апдейт? → Log/ (имя: YYYY-MM-DD ...md)
Еженедельный отчёт? → Log/Reports/ (YYYY-MM-DD.md, понедельник недели)
Идея/риск/вопрос/наблюдение? → 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
Языки имён
- Папки/разделы — английский (
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-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. Цифра — субъективный ранг/приоритет, не порядковый номер. Не перенумеровывай при добавлении; используй ближайшее свободное число.
Wikilink Rules (важно)
Obsidian резолвит [[Имя файла]] по basename, глобально, регистронезависимо. Это значит:
Не используй относительные markdown-ссылки ([text](../folder/file.md)) — они хрупкие. Только [[wikilinks]] или абсолютные http-ссылки.
Sensitivity
Это приватный репозиторий. Может содержать:
- Реквизиты и регистрационные данные юрлиц
- Контракты и финансовые документы (
files/, отчёты)
- Индексы доступов и паролей
- Контакты и переписку с подрядчиками
- Раннюю стадию идей и рисков (
Notes/)
Не пушь в публичные remote'ы. Не копируй фрагменты в чужие чаты/issue без явного разрешения. Не публикуй ссылки на реквизиты или доступы. Если remote добавляется — убедись, что он приватный. Если vault когда-либо публикуется (статический сайт) — перед публикацией убедись, что в нотах нет лишних доступов/реквизитов.
Obsidian-Specific Settings
attachmentFolderPath: files — все вложения идут в files/.
userIgnoreFilters: ["files/"] — files/ исключён из глобального поиска. Не клади туда .md ноты — их не найдут.
alwaysUpdateLinks: true — при перемещении из Obsidian ссылки обновятся; при git mv — нет, но wikilinks по имени всё равно зарезолвятся.
.obsidian/workspace.json исключён из git (per-machine state).
Common Tasks
Записать работу по задаче
Любое движение по задаче (из tasks.md, _TODO/, или просто по ходу дня) фиксируется в файле дня Log/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 (дата сегодня — момент, когда задача стала активной).
Порядок задач в tasks.md
Файл разбит на секции # Week: (текущая неделя) и # Week+ (неделя+), ниже # Week+ — строка-легенда > Активные задачи. Будущие: [[tasks-future]].. Внутри # Week: сначала идут завершённые (- [x]), потом открытые (- [ ] / - [/]).
- При закрытии задачи перенеси её строку (вместе с подпунктами-отступами) в верхний блок под
# Week: — сразу после последней - [x] и до первой открытой задачи. Задачу, закрытую из # Week+, тоже переноси в этот блок. Если завершённых задач ещё нет, вставь её сразу после заголовка # Week:, перед первой открытой.
- Новые задачи по умолчанию добавляются в конец секции
# Week: (перед заголовком # Week+); «на потом / неделя+» — в конец # Week+.
- Если пользователь просит добавить новую задачу «в начало» — вставляй её после последней завершённой в
# Week: (в самое начало блока открытых задач), а не выше всех - [x].
- Заголовки секций
# Week: / # Week+ и строку-легенду не удаляй и не переставляй. Не меняй порядок других задач и не схлопывай пустые строки-разделители между смысловыми группами, если они уже есть в файле.
Добавить запись о созвоне
- Имя:
Log/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"
Common Mistakes
| Ошибка | Последствия | Фикс |
|---|
Создал .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-DD.md.
[[weekly-report]] — еженедельный отчёт в Log/Reports/.