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/	Хронологический журнал: дневные логи 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, глобально, регистронезависимо. Это значит:

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

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

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

Не используй относительные 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]), потом открытые (- [ ] / - [/]).

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

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

1. Имя: Log/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"

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/.