AGENTS.md

Общие правила проекта

• Сайт работает на HTML, CSS и JavaScript без сборки. Не добавляйте сборщики, транспиляцию и обязательный этап сборки.
• Библиотеки можно подключать напрямую через <script>, включая ES-модули и CDN. Стили библиотек — через <link>.
• Каждый раздел или приложение храните в отдельной папке со стандартными файлами index.html, index.css и, при необходимости, index.js.
• Общие ресурсы храните в /shared/ и /images/; используйте абсолютные пути от корня сайта.
• Сохраняйте самодостаточность разделов. Изменения одного раздела не должны менять оформление и поведение остальных.
• Используйте семантическую HTML-разметку, UTF-8 и метатег viewport.
• Делайте адаптивную вёрстку, поддерживайте клавиатурное управление, видимый фокус и читаемый контраст. Учитывайте prefers-reduced-motion.
• Используйте современные CSS и JavaScript, понятные имена и небольшие функции. Комментируйте нетривиальную логику.
• Оптимизируйте изображения и не подключайте лишние зависимости.
• Добавляйте навигацию на главную и ссылку на репозиторий там, где это уместно.
• Механики и особенности отдельных приложений документируйте в их локальных AGENTS.md.
• Проверяйте изменения в браузере на широком и мобильном экранах; для изменённой логики запускайте подходящие тесты.