# Knowledge Structures > Структуры знаний хранилища — когда и как создавать MOC (`#MapOfContent`), синтез-заметки (`#synthesis`) и атомарные заметки, и по каким признакам выделять раздел большой заметки в отдельную. Используй при создании карт, сравнений и при дроблении конспектов и статей на атомарки. - Skill: `jtprogru/knowledge-structures` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add jtprogru/knowledge-structures` - Raw SKILL.md: https://api.skillmd.com/api/skills/jtprogru/knowledge-structures/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: jtprogru (https://skillmd.com/u/jtprogru) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/jtprogru/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`