knowledge-structures
Skill1 starsChanged 3 months agoMITView on GitHub
Структуры знаний хранилища — когда и как создавать MOC (`#MapOfContent`), синтез-заметки (`#synthesis`) и атомарные заметки, и по каким признакам выделять раздел большой заметки в отдельную. Используй при создании карт, сравнений и при дроблении конспектов и статей на атомарки.
In this repository47 other files it gives its agents.
- AGENTS.mdAGENTS.md
- agentops-brevitySkill
- agentops-canarySkill
- agentops-compressSkill
- agentops-delegateSkill
- analysis-kitSkill
- bear-doctorSkill
- bear-helpSkill
- bear-new-skillSkill
- bear-statsSkill
- book-highlights-processorSkill
- code-grillSkill
- code-last-mileSkill
- code-review-lineSkill
- code-senior-reviewSkill
- content-article-draftSkill
- content-humanizerSkill
- content-tg-postSkill
- content-tutorial-structureSkill
- git-backlog-triageSkill
- git-conventional-commitSkill
- git-monorepo-releaseSkill
- git-pr-descriptionSkill
- git-release-tagSkill
- note-templatesSkill
- obsidian-add-summarySkill
- obsidian-daily-appendSkill
- obsidian-emotion-logSkill
- obsidian-enrich-noteSkill
- obsidian-inbox-reviewSkill
- obsidian-ingestSkill
- obsidian-journal-reviewSkill
- obsidian-note-criticSkill
- obsidian-refactor-inboxSkill
- obsidian-refactor-lectureSkill
- obsidian-split-noteSkill
- obsidian-untangle-knotSkill
- sre-k8s-triageSkill
- srekit-postmortemSkill
- srekit-runbookSkill
- srekitSkill
- teach-ruSkill
- telegram-chat-digestSkill
- vault-archivingSkill
- vault-mermaidSkill
- vault-statsSkill
- vault-tasksSkill
The file
Files
<!-- СГЕНЕРИРОВАНО bin/mirror.js. Не редактировать: правки затрёт следующая генерация.
Источник правды — domains/<домен>/. -->Структуры знаний: 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+ несвязанных тем
Как выделять
- Определи атомарную идею — одна мысль, один инсайт, один факт
- Создай новую заметку в
00. Входящие/с понятным названием - Frontmatter: теги
thought+review, поляup,links - Напиши суть — по умолчанию один абзац своими словами; больше только если идея реально не помещается (не копируй дословно из исходной заметки). Пустые секции шаблона удаляй, а не заполняй ради полноты — см.
note-density.md - Добавь контекст (опционально) — откуда пришла мысль, с чем связана; пропусти, если контекст уже ясен из
up/sources - Поставь ссылки — в
linksукажи исходную заметку и связанные - В исходной заметке замени развёрнутый блок на ссылку:
[[Новая атомарная заметка]]
Не делай
- Не выделяй всё подряд — атомарность ≠ дробление ради дробления
- Не теряй контекст: в новой заметке должно быть понятно, о чём речь, без открытия исходника
- Не удаляй текст из исходной заметки без замены на ссылку
- Не добавляй в 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
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

