agentleFS
jtprogrujtprogru/bear-skills/skills/knowledge-structures/SKILL.md

knowledge-structures

Skill1 starsChanged 3 months agoMITView on GitHub

Структуры знаний хранилища — когда и как создавать MOC (`#MapOfContent`), синтез-заметки (`#synthesis`) и атомарные заметки, и по каким признакам выделять раздел большой заметки в отдельную. Используй при создании карт, сравнений и при дроблении конспектов и статей на атомарки.

The file

Files
SKILL.md
<!-- СГЕНЕРИРОВАНО 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+ несвязанных тем

Как выделять

  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

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.