Ключевые принципы системы сайта
✎
Это не просто сайт. Это система публикации.
Ниже — базовые правила, которые нельзя нарушать, если хочется сохранить контроль и не скатиться в хаос.
Source of truth
HTML — это результат.
Править его напрямую нельзя.
Правильно:
- главная → render_homepage.py
- посты → markdown (.md)
- списки → update_*.py
Любое изменение:
генератор → publish.sh → результат
Pipeline
Основа системы:
Markdown → Python → HTML → publish → сайт
Если этот pipeline работает — CMS не нужна.
Если ломается — всё ломается.
Нельзя править результат
Запрещено:
- редактировать index.html
- использовать sed для правок HTML
- “быстро поправить файл руками”
Причина простая — всё это будет перезаписано.
Claude Code и контроль
Claude без инструкций начинает “догадываться”:
- ищет /var/www
- правит HTML
- ломает структуру
Решение:
CLAUDE.md — это контракт.
Любая задача должна выполняться через понимание структуры проекта.
Как решать любую задачу
Всегда один и тот же алгоритм:
- определить source of truth
- изменить source
- выполнить publish.sh
Если пропустить первый шаг — будет костыль.
Минимализм
Лишнее — враг системы.
- лишние блоки → шум
- лишний CSS → каша
- лишняя логика → баги
Система должна оставаться простой.
UI
Интерфейс не должен мешать.
Цель:
- текст читается легко
- ничего не отвлекает
- нет “дизайна ради дизайна”
Ориентир:
Notion / Medium
Контент важнее функций
Сейчас не нужно:
- авторизация
- теги
- поиск
- админка
Нужно:
- нормальные посты
Сначала наполнение — потом функции.
Контроль изменений
Используется:
- git (история)
- лог публикаций
Это уже даёт уровень контроля выше большинства CMS.
Главное правило
Если работает — не трогай.
Любое улучшение должно:
- не ломать pipeline
- не усложнять систему
Коротко
Ты не делаешь сайт.
Ты строишь систему, которая генерирует сайт.
И пока она проста и предсказуема — она работает.