banatie-content/shared/assets-folder-standard.md

Assets Folder Standard

Поле frontmatter: assets_folder

Для статей со скриншотами и другими визуальными материалами добавляем во frontmatter:

assets_folder: assets/{slug}/

Структура папки

assets/{slug}/
├── screenshots/     # скриншоты для статьи
├── diagrams/        # диаграммы
└── other/           # прочие файлы

Подпапки создаются по необходимости. Для простых статей можно класть файлы прямо в корень assets/{slug}/.

Использование

Агент	Действие
Human	Добавляет скриншоты перед передачей @writer
@writer	Вставляет ссылки на изображения из этой папки
@image-gen	Генерирует спеки для изображений, которые будут сохранены сюда

Формат ссылок в статье

![Alt text](assets/{slug}/screenshot-name.png)

Когда использовать

Папка создаётся только когда статье нужны визуальные материалы:

• Скриншоты интерфейса
• Диаграммы и схемы
• Иллюстрации

Для статей без изображений поле assets_folder не добавляется.

---

Стандарт введён: 2026-01-06