# Assets Folder Standard

## Поле frontmatter: assets_folder

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

```yaml
assets_folder: assets/{slug}/
```

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

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

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

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

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

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

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

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

Папка создаётся только когда статье нужны визуальные материалы:
- Скриншоты интерфейса
- Диаграммы и схемы
- Иллюстрации

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

---

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