Плоская структура вместо вложенной

Когда агент готовит текст, заметку или документ — глубокая вложенность заголовков не помогает, а мешает. Читатель удерживает в голове только один уровень: где он сейчас. Всё что глубже — теряется.

Trigger: агент пишет документ, заметку, отчёт или инструкцию с несколькими уровнями заголовков.

Правило

Максимум один уровень вложенности в одном документе: заголовок статьи → подзаголовки. Раздел внутри раздела — уже перебор.

Если материала много

Не углубляй структуру — выноси в отдельный файл и давай ссылку.

Плохо:

# Автоматизация
## Типы коннекторов
### Browser use
#### Плюсы
#### Минусы

Хорошо:

# Автоматизация
## Типы коннекторов
Подробнее: [[insights/connector_types]]

Это работает так же как wiki и как контекстное окно LLM: знание живёт в отдельных узлах, связанных ссылками, а не в одной глубокой иерархии. Каждый узел плоский и читаемый сам по себе.

Вместо вложенности — параллелизм

Если нужно разграничить подтемы внутри раздела — используй параллельные конструкции в начале абзаца:

«Для ипотеки...»
«Для аренды...»

Читатель улавливает переход без заголовка.

Правило: если хочется сделать подзаголовок внутри подзаголовка — лучше вынести в отдельный файл и сослаться.

Связано: insights/legibility, insights/connector_types

Источник: sources/maxim_ilyahov