# <Название проекта>

## Что это
<Одно-два предложения: тип сайта, движок или его отсутствие, кто аудитория.>
Пример: статические HTML-страницы без CMS, правки вносятся прямо в файлы.

## Где что лежит
blog/<slug>/index.html    — статьи
data/search-index.json    — индекс поиска по сайту
styles.css, pages.css     — общие стили, версия в параметре ?v=
scripts/                  — генераторы страниц
assets/screenshots/       — изображения статей

## Как принято работать
- Перед массовой правкой — бэкап в /root/bak-<дата>.tar.gz
- Правки в общий CSS требуют бампа ?v= на всех страницах
- Новые страницы добавляются генератором, не руками
- Дифф показывать до записи на диск

## Чего делать нельзя
- <Стоп-слова и обороты, запрещённые в текстах>
- Не трогать <перечислите чувствительные файлы: конфиги, .env, выгрузки>
- Не менять URL существующих страниц без редиректа

## Проверки после правок
python3 scripts/check_links.py        # битые внутренние ссылки
python3 scripts/gen-sitemap.py --write # карта сайта
grep -rl "<стоп-слово>" blog/ | wc -l  # чистота текстов

## Полезный контекст
- Основная аудитория: <кто и с какими запросами приходит>
- Приоритетные разделы: <что важнее всего не сломать>
- Аналитика: <какие счётчики стоят и где смотреть данные>