# Чек-лист актуализации документации (после изменения фич)

Цель: чтобы «где что есть» совпадало в трёх местах. Запускать когда добавили/убрали/
переименовали то, что **видит пользователь** (поле отчёта, секция, тариф, лимит, источник).

## 1. Сайт (`~/Services/zemlya-web/frontend`)
- [ ] Лендинг `/` — таблица сравнения Free / Pro / AI (что входит в каждый тариф).
- [ ] `/help` — что показывает отчёт, как пользоваться.
- [ ] Описание секций отчёта / тексты тарифов (если фича попадает в перечень).
- [ ] Сборка фронта: **только** `bash ~/Services/zemlya-web/deploy/rebuild_frontend.sh` — пересобирает и рестартит ОБЕ инстанции (:20141 + :20142) и проверяет, что CSS-хэш совпал. ⚠️ НЕ рестартить одну вручную: фронт крутится в двух инстанциях из одной `.next`, нерестартнутая отдаёт HTML со старыми хэшами чанков → 404 на CSS/JS → «страница без стилей» (флакер, чинится рефрешем). Прецедент: Changelog 2026-05-31 ч.5.

## 2. Бот (`~/Services/zemlya-bot`)
- [ ] `/help`, `/start` — описание возможностей.
- [ ] Тексты тарифов, перечни фич в сообщениях (handlers/start.py, menu, тарифные клавиатуры).
- [ ] Рестарт: `launchctl kickstart -k gui/$(id -u)/local.zemlya-bot`.

## 3. Obsidian (`Projects/Земля без риска check/`)
- [ ] `Changelog.md` — ВСЕГДА (новое сверху).
- [ ] `Decisions.md` — если решение архитектурное (ADR: что выбрали, что отвергли, tradeoff).
- [ ] `Overview.md` — если изменилась таблица тарифов / аудитория / что НЕ делает.
- [ ] `Scenarios.md` — если изменился пользовательский флоу или перечень секций отчёта.

## 4. Парность сайт ↔ бот
- [ ] Сайт и бот говорят ОДНО про фичи/тарифы/лимиты (не разъехались).
- [ ] AI-отчёт: новые секции/поля одинаково описаны там и там (если описаны).

## Анти-паттерн
Добавил фичу в отчёт, но в лендинге/боте/Obsidian про неё ни слова → пользователь не знает,
конкурентное преимущество не продаётся, доки врут. «Готово» = синхронизировано везде.
