Материалы КазИнкас

Appearance

Стартовая инструкция для Antigravity ​

Роль ​

Ты работаешь как инженер статических сайтов и развёртывания Cloudflare. Используй установленные официальные Cloudflare MCP-инструменты и Skills.

Исходные данные ​

Пользователь передаст путь к локальной папке, содержащей Markdown-файлы:

text
<SOURCE_FOLDER>

Не изменяй смысл исходных документов. Сохрани исходные .md-файлы как редактируемый источник.

Цель ​

Преобразовать Markdown-файлы из указанной папки в небольшой удобный сайт для личного использования и развернуть его на Cloudflare Pages.

Сайт не должен оставаться общедоступным. Доступ должен быть закрыт через Cloudflare Access.

Перед началом ​

  1. Прочитай все Markdown-файлы в исходной папке.
  2. Проверь доступные Cloudflare MCP-инструменты и Skills.
  3. Определи, какие действия можно выполнить автоматически.
  4. Не запрашивай данные, которые можно получить через подключённые инструменты.
  5. Для данных, которые нельзя определить автоматически, запроси только минимально необходимое:
    • разрешённый адрес электронной почты для Cloudflare Access;
    • название Cloudflare Pages-проекта;
    • при необходимости название приватного GitHub-репозитория;
    • при необходимости домен или поддомен.

Требования к сайту ​

Структура ​

  • Главная страница со списком документов и краткими описаниями.
  • Отдельная страница для каждого Markdown-файла.
  • Понятная навигация между документами.
  • Автоматическое оглавление по заголовкам.
  • Возможность скопировать ссылку на конкретный раздел.
  • Сохранение порядка файлов по числовому префиксу имени.

Интерфейс ​

  • Русский язык.
  • Удобное чтение на ноутбуке и телефоне.
  • На широком экране — боковое оглавление.
  • На телефоне — сворачиваемое оглавление.
  • Ограниченная ширина основного текста.
  • Хорошая типографика и интервалы.
  • Светлая и тёмная темы либо автоматическое следование системной теме.
  • Таблицы должны прокручиваться по горизонтали на узком экране.
  • Кодовые блоки и цитаты должны визуально отличаться.
  • Не использовать тяжёлые анимации.

Технические ограничения ​

  • Предпочитать простой статический сайт с минимальным количеством зависимостей.
  • Не добавлять аналитику, рекламные скрипты и внешние трекеры.
  • Не загружать шрифты и библиотеки с внешних CDN без необходимости.
  • Не включать секреты, токены, адреса электронной почты и ключи в репозиторий.
  • Хранить секреты только в поддерживаемом Cloudflare или CI-хранилище.
  • Репозиторий GitHub должен быть приватным.
  • Исходные Markdown-файлы должны оставаться легко переносимыми на другой генератор сайта.

Предпочтительный процесс ​

  1. Создай в исходной папке отдельный каталог проекта сайта, не разрушая исходные материалы.
  2. Выбери минимальный статический генератор или простой собственный сборочный скрипт.
  3. Создай главную страницу и навигацию.
  4. Преобразуй Markdown в HTML.
  5. Проверь локальную сборку.
  6. Создай приватный GitHub-репозиторий либо используй указанный существующий.
  7. Зафиксируй файлы в Git и отправь основную ветку.
  8. Создай Cloudflare Pages-проект через доступные Cloudflare инструменты.
  9. Настрой автоматическую сборку из GitHub, если этот способ поддерживается текущими инструментами.
  10. Настрой Cloudflare Access для производственного адреса.
  11. Ограничь доступ только явно разрешённой учётной записью.
  12. Защити также preview-deployments: они не должны оставаться публичными.
  13. Проверь сайт после развёртывания.
  14. Передай пользователю адрес, структуру репозитория и короткую инструкцию обновления.

Критические требования приватности ​

Cloudflare Pages и preview-адреса могут быть публичными без дополнительной защиты. Поэтому:

  • не считать случайный адрес или запрет индексации средством защиты;
  • не считать задачу завершённой, пока не проверена политика Access;
  • открыть производственный и preview-адреса в режиме без авторизации;
  • убедиться, что вместо содержимого появляется запрос аутентификации или отказ;
  • после входа разрешённой учётной записью проверить доступ к содержимому;
  • если Access невозможно настроить через MCP или Skill, не утверждать, что сайт приватный;
  • в этом случае дать точные недостающие ручные шаги и не оставлять чувствительные материалы в заведомо публичном развёртывании.

Выбор способа развёртывания ​

Предпочтительно использовать Git-интеграцию Cloudflare Pages, чтобы новые коммиты автоматически обновляли сайт.

Если подключённые инструменты лучше поддерживают Direct Upload, его можно использовать, но нужно явно сообщить пользователю о выбранном способе. Не создавай одновременно два независимых Pages-проекта без необходимости.

Проверка качества ​

Перед завершением проверь:

  • все Markdown-файлы отображаются;
  • кириллица не повреждена;
  • заголовки формируют оглавление;
  • внутренние ссылки работают;
  • таблицы читаются на телефоне;
  • нет горизонтального переполнения всей страницы;
  • нет публичного доступа без авторизации;
  • preview-развёртывания также защищены;
  • в репозитории нет секретов;
  • повторный deploy воспроизводим;
  • пользователь получил понятный способ обновления сайта.

Ожидаемый результат ​

Предоставь:

  1. путь к созданному проекту;
  2. URL приватного сайта;
  3. URL приватного GitHub-репозитория;
  4. способ обновления содержимого;
  5. сведения о защите Cloudflare Access;
  6. результат проверки неавторизованного доступа;
  7. список действий, которые пришлось оставить пользователю вручную;
  8. краткий журнал выполненных шагов.

Не делать ​

  • не публиковать сайт без Access и не называть его приватным;
  • не создавать публичный GitHub-репозиторий;
  • не менять смысл переговорных материалов;
  • не добавлять учебную программу, которой нет в исходных файлах;
  • не добавлять конфиденциальные данные компании;
  • не использовать реальные данные клиентов или сотрудников;
  • не усложнять проект серверной базой данных и авторизацией внутри приложения, если Cloudflare Access решает задачу;
  • не удалять исходные Markdown-файлы.

Официальные справочные материалы ​