Knowledge Structures

Структуры знаний: MOC, синтез, атомарные заметки

MOC (Map of Content)

MOC — навигационная заметка, которая собирает ссылки по определённой теме. Главная MOC — README.md в корне. Тематические MOC лежат в 03. Ресурсы/07. Карты/; новую карту агент создаёт в 00. Входящие/ с #MapOfContent + #review и она переезжает в Карты после ревью (см. workflows.md).

Когда создавать MOC

• Тема упоминается в 5+ заметках и нет единой точки входа
• Пользователь явно просит создать карту по теме
• Появляется новая крупная область знаний

Структура и правила MOC

Каркас — Шаблон карты.md в _Система/1. Шаблоны/. Обязательные секции: ## Описание (2–3 предложения своими словами), ## Ключевые заметки (ссылки с краткими аннотациями — не просто список, а список с контекстом), ## Связанные темы, ## Автосбор заметок (Dataview/Bases-запрос по ссылкам или тегу).

• В up указывай родительскую MOC или область (если есть), в down — дочерние крупные подтемы
• Добавляй Dataview-запрос для автоматического сбора связанных заметок

Синтез-заметки

Синтез — заметка, сравнивающая несколько концептов/инструментов/подходов и выдающая кросс-срезовый вывод. Хранится в 03. Ресурсы/07. Карты/, тег #synthesis. Как и карта, создаётся агентом в 00. Входящие/ с #review и переезжает после ревью.

Когда создавать синтез

• Есть 2+ концепта/инструмента для сравнения
• Появился инсайт, охватывающий несколько заметок сразу
• Пользователь явно просит «сравни», «что лучше», «какой подход выбрать»

Структура и правила синтеза

Каркас: frontmatter с tags: [synthesis], sources, confidence + секции ## Сравнение (таблица по критериям), ## Анализ (кросс-срезовые выводы), ## Рекомендация (когда какой подход и почему), ## Связанные заметки (ссылки с пояснениями).

• В sources перечисляй все исходные заметки; каждый вывод должен ссылаться на конкретные заметки
• Если вывод основан на одной заметке — это не синтез, а атомарная мысль
• При обновлении исходных заметок — проверяй актуальность синтеза

Атомарные заметки

Атомарная заметка — одна ключевая идея, мысль или инсайт. Используй Шаблон мысли.md.

Когда выделять

• В длинной заметке есть самостоятельная мысль, полезная отдельно от контекста
• Одна и та же идея повторяется в нескольких заметках
• Заметка разрослась и содержит 3+ несвязанных тем

Как выделять

1. Определи атомарную идею — одна мысль, один инсайт, один факт
2. Создай новую заметку в 00. Входящие/ с понятным названием
3. Frontmatter: теги thought + review, поля up, links
4. Напиши суть — по умолчанию один абзац своими словами; больше только если идея реально не помещается (не копируй дословно из исходной заметки). Пустые секции шаблона удаляй, а не заполняй ради полноты — см. note-density.md
5. Добавь контекст (опционально) — откуда пришла мысль, с чем связана; пропусти, если контекст уже ясен из up/sources
6. Поставь ссылки — в links укажи исходную заметку и связанные
7. В исходной заметке замени развёрнутый блок на ссылку: [[Новая атомарная заметка]]

Не делай

• Не выделяй всё подряд — атомарность ≠ дробление ради дробления
• Не теряй контекст: в новой заметке должно быть понятно, о чём речь, без открытия исходника
• Не удаляй текст из исходной заметки без замены на ссылку
• Не добавляй в frontmatter ссылки на абсолютно все заметки — это перегружает

Когда выделять раздел в отдельную заметку

Применяется в obsidian-split-note, obsidian-ingest — везде, где из большой заметки достаются атомарные.

Признаки «выделяй»

• Описывает одно понятие / теорему / алгоритм / инсайт самодостаточно
• ≥ 5–7 строк содержательного текста (или формула + объяснение)
• Полезен в других контекстах без исходной заметки
• Не дубль уже существующей заметки — rg -l "<название>" перед созданием

Признаки «оставь в оригинале»

• Вводный или связующий абзац («в этой главе рассматривается…»)
• Раздел из 2–3 строк без самодостаточного содержания
• Список примеров, иллюстрирующий соседний раздел
• Q&A-блоки и ответы на вопросы из лекций (если ответ не вырос в полноценный концепт ≥10 строк)
• Если сомневаешься — оставляй в оригинале, лучше недодробить, чем переборщить

Имя и тег нового файла

• Имя — по file-naming.md (claim-based, без запрещённых символов)
• Структурный тег — по tags.md (раздел «Структурные теги»); он же задаёт целевую папку
• Файл создаём в 00. Входящие/ с #review — переезд в целевую папку идёт после ревью автором (workflows.md)
• В новой заметке up ссылается на оригинал — это обязательно. В оригинале down пополняется ссылкой на новую только если там нет смыслового перечисления детей в теле (## Ключевые идеи, ## Список лекций и ИМ и подобных); связь допустимо оставить односторонней, см. политику down в note-types-frontmatter.md