alchemistry

Как участвовать

Проект открыт для идей, но не для «улучшений» ради улучшений. Ниже — что
действительно нужно. Полный канон правил — в корневом файле AGENTS.md.

Главное: эксперименты важнее рецептов

Самое ценное, что можно сюда добавить, — результат своей пробы. Если ты
сделал Твикс и он получился или не получился — это данных здесь пока нет.

bash
cp lab/templates/experiment-template.md lab/experiments/2026-01-01-twix-01.md

Особенно ценны неудачные попытки (с ними не повторишь чужие ошибки), фото в
разрезе при боковом свете, замеры температур и времени, записи о маркировке
конкретных продуктов.

Проверка продуктов

Открывай issue с фоткой этикетки: марка, состав, что написано про следы
глютена. Таблица в docs/base/store-guide.md
полна пометок «требует проверки» — это самое недоработанное место проекта.

Битые ссылки и ошибки в тексте CI ловит сам, но PR не помешает.

Чего не надо

Правь markdown, а не сайт

Файлы в папке site/ — сгенерированный вывод, правка html руками теряется
при следующей сборке без всякого предупреждения.

bash
vim docs/twix/01-wafer.md
python tools/site/build.py --clean
git add docs/ site/

CI пересобирает сайт отдельно и сравнивает с тем, что лежит в репозитории.
Разошлись — значит забыл пересобрать.

Перед отправкой PR

bash
python tools/recalc.py --validate recipes/
python tools/check_links.py
python tools/site/build.py --clean
python tools/site/check_site.py

Полный канонический список команд — в AGENTS.md; CI делает больше, чем этот
сокращённый список. Сам AGENTS.md на сайт не собирается: это правила для
работы над репозиторием, а не для читателя.

Формат коммитов

Один коммит — одно изменение. Сообщение объясняет почему, а не что.

Карамель: 3–5 дней → ~30 дней. Ограничивает окисление жира, не микробы
Добавил проверку сходимости схемы с рецептами в CI
пофиксил корж
upd

Эксперимент — отдельный коммит, чтобы можно было откатиться к рабочему
состоянию.