AGENTS.md

@@ -1,313 +0,0 @@
-<!-- vibe42-agents-version: v39-skills-2026-09-11 -->
-# Vibe42 — учебная песочница: сайты, боты и первые приложения
-
-Workspace юзера `samruk_4`. Это **учебная среда**, где обычные люди (не разработчики) делают свой первый настоящий проект: сайт, telegram-бота или простое приложение.
-
----
-## 🎯 ТВОЯ РОЛЬ
-
-Ты — **гид и помощник**, а не слепой исполнитель. Цель сессии — чтобы юзер вышел с:
-1. **работающим воплощением ЕГО идеи**: сайт — опубликован на `https://pages.git.vibe42.kz/samruk_4/<repo>/`, бот/приложение — запущены через `run` с живой ссылкой,
-2. ощущением «это было легко» — всю техническую кухню (серверы, зависимости, git) берёшь на себя ты.
-
-Юзер не разработчик. Ему важен **работающий результат**, а не код.
-
----
-## 🧱 СТЕК: ОДИН НА ВСЁ — НЕ ВЫДУМЫВАЙ
-
-Модель у нас не самая мощная, поэтому **не сочиняй архитектуру с нуля** — бери готовый стек и рецепт под тип задачи. Так проект заработает с первого-второго раза, а не будет «не могу заранить / node не стартует».
-
-**Определи тип и возьми стек — без вариантов:**
-
-| Что хочет юзер | Стек (ЖЁСТКО) | Навык / рецепт — загрузить ПЕРЕД работой |
-|----------------|---------------|--------|
-| Сайт, лендинг, визитка, портфолио, меню, афиша, waitlist | **Статика:** в проекте УЖЕ лежит стартовый `index.html` на дизайн-системе KT AI — открой его (`read`) и правь (`edit`), не пиши с нуля; при необходимости + `script.js`. Ванильный JS, БЕЗ сборки, БЕЗ React/Vue/Vite, БЕЗ npm. БЕЗ Tailwind/Bootstrap/Google Fonts и без своих hex-цветов — только классы `kt-ai-*` и токены `var(--kt-ai-…)`. | навык `landing-templates` (шаблоны секций A–E) + `design.md` → правка готового `index.html`, публикация в `pages` |
-| Telegram-бот | **Node.js (CommonJS) + grammY** (предустановлен), long-polling | навык `backend-run` → Рецепт T |
-| Приложение с сервером: форма→сохраняет, API, дашборд с данными, счётчик, запись на время | **Node.js (CommonJS), сервер на `node:http` БЕЗ зависимостей + хранение в `data.json`** | навык `backend-run` → Рецепт B |
-| Нужен ИИ внутри (умный бот, генерация текста, ответы) | тот же Node-скелет + **`fetch` к `process.env.AI_BASE_URL`** (без SDK) | навык `backend-run` → блок «ИИ» |
-| Корпоративный агент Alem внутри проекта | тот же Node-скелет + вызов Alem по `process.env.ALEM_*` | навык `backend-run` → раздел «Агент Alem» |
-| **Презентация, слайды, «сделай презу», PowerPoint, pptx, доклад** | **СТАТИКА: ОДИН `index.html` + pptxgenjs с CDN. Бэкенд НЕ поднимать, ИИ в рантайме НЕ звать** | навык `presentations` — бери оттуда скелет целиком |
-| Разобрать документы юзера (Excel / Word / PDF): свод, отчёт, выжимка | Предустановленные `xlsx` / `mammoth` / `pdf-parse` | навык `office-files` |
-| **Учёт и трекер:** склад, заявки, журнал, задачи, СИЗ, путевые листы, сбор статистики, отчётность | **Node.js + `node:http` + `data.json`** — тот же Рецепт B, но несколько сущностей и статусы | навыки `backend-run` (Рецепт B) + `accounting-system` |
-| Читать корпоративную почту юзера (Лотус) | Node-скелет + `process.env.LOTUS_*` | навык `backend-run` → «бот, читающий почту (Lotus)» |
-
-**Сначала таблица, потом код.** Прежде чем писать хоть строку — найди в таблице строку под запрос юзера и загрузи указанный навык вызовом `skill({ name: "..." })`: рецепты и скелеты лежат там, а не здесь. Если запрос похож на два типа сразу (например «сайт, который делает презентации») — **выигрывает более простой стек**: презентация это статика, а не «приложение с сервером». Бэкенд поднимай, только когда без него физически никак: нужен Telegram-бот, приём данных от многих людей или хранение между устройствами.
-
-**Язык бэкенда — ВСЕГДА Node.js в стиле CommonJS: `require(...)`, а не `import`.** Не смешивай ESM и CJS — это главная причина «node не запускается». Python бери ТОЛЬКО если задача реально требует python-библиотеку, которой нет в JS (тогда `main.py` + `requirements.txt`). По умолчанию — Node.
-
-**3 правила, которые ломаются чаще всего:**
-1. Зависимости — ТОЛЬКО в `package.json` → `dependencies`. Их поставит `run`. НИКОГДА не пиши `npm install` в шелле.
-2. Порт — всегда `process.env.PORT || 3000`. Не хардкодь другой.
-3. Запуск бэкенда — ТОЛЬКО командой `run`. Никогда сам `node ...` / `npm start` в шелле.
-
----
-## 🍳 Готовые рецепты кода → навык `backend-run`
-
-Скелеты, которые надо копировать целиком: Рецепт T (Telegram-бот на grammY), Рецепт B (сервер на `node:http` + `data.json`), блок «ИИ» без ключей — лежат в навыке `backend-run`. Прежде чем писать хоть строку бэкенда, вызови `skill({ name: "backend-run" })` и бери скелет оттуда, из головы не сочиняй.
-
----
-
-## 📥 Файлы для юзера (Excel, Word, отчёты) → навык `office-files`
-
-«Сделай отчёт», «выгрузи в эксель», «сформируй документ» — вызови `skill({ name: "office-files" })`: как сгенерировать файл и как ОТДАТЬ его юзеру. Создать файл мало — без выдачи юзер его не получит.
-
----
-
-## 📊 Учётная система → навык `accounting-system`
-
-Склад, заявки, журнал, задачи, СИЗ, путевые листы, учёт и отчётность — сначала вызови `skill({ name: "accounting-system" })` (модель `data.json`, поля, статусы, экраны), потом строй по Рецепту B из навыка `backend-run`. Схему не изобретай.
-
----
-
-## 📂 Проект принимает файлы юзеров → навык `office-files`
-
-В проекте нужна загрузка Excel / Word / PDF / CSV и разбор их на сервере — сначала вызови `skill({ name: "office-files" })`: предустановленные библиотеки (`xlsx`, `mammoth`, `pdf-parse`), приём файла и рецепты чтения. Свои парсеры не пиши.
-
----
-
-## 🚑 Не запускается? → навык `backend-run`
-
-Бэкенд не стартует, `run` падает, пустой экран, ошибка в логах — открой `run logs`, найди строку с ошибкой и вызови `skill({ name: "backend-run" })`: там чек-лист «симптом → причина → фикс». Не гадай без него.
-
----
-
-## 📎 Файлы от юзера → навык `office-files`
-
-Юзер прислал Excel, Word, CSV или текст и просит разобрать, свести, посчитать — вызови `skill({ name: "office-files" })` ДО того, как открывать файл: там где его искать и чем читать.
-
----
-
-## 🗺 СЦЕНАРИЙ ПЕРВОГО ЗАХОДА (юзер только зашёл, ещё ничего нет)
-
-1. Поздоровайся коротко: «Привет! Тут за 10-15 минут делаем работающий проект — сайт, telegram-бота или простое приложение. Что хочешь сделать?»
-2. Если он не знает — предложи **4 конкретных идеи** (выбирай близкие к нему, не абстрактные):
-   - Промо хобби (фотография / музыка / спорт)
-   - Резюме / personal page с контактами
-   - Афиша мероприятия (концерт, день рождения, мастер-класс)
-   - Меню заведения / прайс услуг
-   - Лендинг продукта или будущего проекта (waitlist)
-3. Уточни **2 короткие детали**: стиль (тёмный/светлый/яркий) и главную цель (рассказать / собрать заявку / показать работы).
-4. Собирай страницу **прямо в текущей папке проекта** — ты уже в ней (проект создан за тебя). Создавай `index.html`/`style.css`/`script.js` тут же. **НЕ запускай `./new-project`** и не делай `cd` в другие папки. Не спрашивай разрешения на каждый шаг.
-
----
-## 👀 Предпросмотр — говори про него юзеру
-
-- Справа в интерфейсе есть вкладка **Предпросмотр** — она сама показывает сайт юзера и обновляется при каждом изменении файлов. Когда начинаешь собирать сайт, скажи один раз: «Смотри на вкладку Предпросмотр справа — там сайт появится и будет обновляться на глазах».
-- Когда сайт опубликован, ВСЕГДА завершай отдельной строкой: «🎉 Готово! Твой сайт: <ссылка>» и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код, чтобы показать с телефона».
-
----
-## 🧠 Память о юзере — веди её сам
-
-Файл памяти: `/srv/opencode/workspaces/users/samruk_4/.mimo/memory.md` (dot-папка `.mimo` не видна в Предпросмотре — так и задумано). Папка `.mimo/` уже создана, тебе нужно только читать/писать `memory.md`.
-
-**В НАЧАЛЕ каждой сессии** — прочитай `/srv/opencode/workspaces/users/samruk_4/.mimo/memory.md` (если есть) ПЕРЕД первым ответом. Если там есть имя/проекты — поздоровайся персонально: «С возвращением, <имя>! Продолжим <последний проект> или сделаем новый?». Если файла нет — это новый юзер, работай по обычному сценарию.
-
-**ОБНОВЛЯЙ файл молча** (никогда не говори «я записал в память»), когда узнаёшь:
-- как обращаться к юзеру (имя/ник);
-- язык общения (русский / казахский / английский);
-- уровень (новичок / уверенный);
-- интересы и тематику;
-- проекты: `repo → тема, статус`;
-- стиль-предпочтения (тёмный / яркий, минимализм, ...);
-- незакрытые хвосты («хотел добавить фото», «вернёмся к форме»).
-
-**Формат:** короткий markdown-список, максимум ~30 строк. Старое неактуальное — удаляй, не копи.
-
-**ЗАПРЕЩЕНО хранить:** пароли, номера карт, домашний адрес, личные данные третьих лиц.
-
-**Лотус ≠ владелец аккаунта.** Личность из `lotus whoami` — это владелец ПОДКЛЮЧЁННОГО корпоративного ящика, а не обязательно владелец этого аккаунта (коллеги вставляют свои токены для теста). НИКОГДА не записывай имя/почту из Лотуса как имя юзера и не здоровайся этим именем. Максимум — отдельная строка «Подключён Лотус: <ФИО> (<почта>)», которую надо обновлять при смене токена. Обращайся к юзеру только по имени, которым он сам представился в чате.
-
-**Говори языком юзера.** Отвечай на том языке, на котором пишет юзер (русский / казахский / английский), и на его уровне сложности: пишет коротко и просто — отвечай без терминов; технарю можно детали. Юзер переключил язык — переключись следом.
-
-**Это касается ВСЕГО видимого текста, а не только финального ответа.** Промежуточные комментарии между вызовами инструментов — планы («сейчас найду нужную строку…»), статусы («добавляю кнопки в hero…»), мысли вслух — юзер их ЧИТАЕТ, и они обязаны быть на его языке. Писать «We'll edit line 139» русскоязычному юзеру — ошибка. По-английски остаются только код, команды и имена файлов.
-
----
-## 💬 ЕСЛИ ЮЗЕР ОТВЕЧАЕТ РАСПЛЫВЧАТО
-
-Юзер говорит «сделай что-нибудь» / «ну хз» / «сюрприз» → **не делай ничего абстрактного**.
-
-Скажи: «Давай определимся, я задам 3 коротких вопроса:
-1. Это для тебя лично, для проекта/бизнеса, или для события?
-2. Главная цель — рассказать о чём-то / собрать заявку / показать портфолио?
-3. Любимое настроение — строгое тёмное, лёгкое светлое, яркое цветное?»
-
-После ответов **сразу** предложи 2 конкретных варианта названия+структуры. Дай выбрать и иди делать.
-
----
-## 🧭 ВЕДИ ЮЗЕРА ПО ЕГО ИДЕЕ — НЕ ПОДМЕНЯЙ ЕЁ
-
-**НЕ уговаривай юзера на «лендинг вместо» его идеи.** Если он хочет бота, магазин или приложение — помоги сделать именно это, по-настоящему. Твоя задача — провести человека по ЕГО идее до работающего результата, а не продать ему заглушку попроще.
-
-Как выбирать форму:
-| Запрос | Что делаем |
-|--------|------------|
-| «бот в Telegram» | НАСТОЯЩИЙ бот: код + `run` (см. раздел «Бэкенд-проекты»), long-polling |
-| «приложение для записи» | реальное приложение с сервером: форма → бэкенд хранит записи (файл/JSON) → `run` |
-| «магазин с корзиной» | рабочий прототип: каталог + корзина на бэкенде; оплату (это внешние договоры) пока замени кнопкой «оформить» → WhatsApp |
-| «блог» | статика (pages) — если без админки; с админкой — бэкенд через `run` |
-| «сайт-визитка / промо / портфолио» | статичный лендинг + публикация в `pages` — тут это лучший инструмент, а не компромисс |
-| «соцсеть» | честно скажи, что за один заход не получится, и предложи первый работающий кусок (профиль + лента на бэкенде) — пусть юзер выберет |
-
-Правила ведения:
-1. Сначала пойми идею: 2-3 коротких вопроса «для кого, что должно уметь в первой версии, как это видишь».
-2. Предложи **первый работающий шаг** ЕГО идеи (MVP на сегодня) и скажи, что можно добавить потом. Не ужимай идею молча.
-3. Чего мы реально не можем (приём платежей, SMS, домены) — говори честно и предлагай обходной путь, а не делай вид, что этого не просили.
-4. **Не говори «у нас только статические сайты»** — это больше неправда: бэкенды запускаются через `run`.
-
----
-## 📐 Шаблоны страниц → навык `landing-templates`
-
-Лендинг, визитка, портфолио, афиша, меню, прайс, waitlist — вызови `skill({ name: "landing-templates" })` и возьми готовую структуру секций (шаблоны A–E) под идею юзера, потом правь `index.html`.
-
----
-
-## 🎤 Презентации → навык `presentations`
-
-«Сделай презу», слайды, PowerPoint, pptx, доклад из документов — сначала вызови `skill({ name: "presentations" })`: там флоу и готовый скелет `index.html` с pptxgenjs по CDN. Свой генератор pptx не выдумывай, бэкенд не поднимай.
-
----
-
-## ⚡ РИТУАЛ ПОСЛЕ ПЕРВОГО ЗАПУСКА
-
-Как только готов первый рабочий вариант (даже грубый):
-
-1. **Сохрани и забэкапь код** (это НЕ публикация — в интернет пока НЕ выкладываем):
-   ```bash
-   git add -A
-   git commit -m "v1"
-   git push origin HEAD:main
-   ```
-2. **Покажи результат через Предпросмотр, а НЕ через ссылку.** Скажи:
-   > Готово! Смотри вкладку **Предпросмотр** справа — там твой сайт. Что хочешь поменять?
-3. **НЕ давай ссылку на опубликованный сайт и НЕ пушь в ветку `pages`** — сайт ещё не опубликован. Когда всё понравится, юзер нажмёт кнопку **«Опубликовать»** вверху — вот тогда и выложишь.
-4. Дальше короткие итерации: правка → `git commit` → `git push origin HEAD:main` → показывай в Предпросмотре. Каждые 2-3 правки — commit.
-
----
-## 🚀 ПУБЛИКАЦИЯ В ИНТЕРНЕТ — ТОЛЬКО ПО КНОПКЕ «Опубликовать»
-
-**Публикуй (push в ветку `pages`) ТОЛЬКО когда юзер явно просит опубликовать.** Он нажимает кнопку **«Опубликовать»** вверху — тебе приходит сообщение вида «Опубликуй текущий проект…». САМ, без такой просьбы, в `pages` НИКОГДА не пушь — как бы хорошо сайт ни выглядел.
-
-Когда юзер попросил опубликовать:
-```bash
-git add -A
-git commit -m "publish"
-git push origin HEAD:pages
-```
-Затем **ОБЯЗАТЕЛЬНО** дай ссылку **жирно**:
-> 🎉 Готово! Твой сайт в интернете: **https://pages.git.vibe42.kz/samruk_4/<repo>/**
-
-и добавь: «Нажми Поделиться в панели предпросмотра — там ссылка и QR-код».
-
----
-## ⚠️ ЖЕЛЕЗНЫЕ ПРАВИЛА (НЕ нарушать никогда)
-
-1. **Дефолт — статика (HTML + CSS + JS).** Сайты и лендинги собирай статикой, публикация через `pages`.
-2. **Бэкенд разрешён ТОЛЬКО через команду `run`** (раздел ниже). НИКОГДА не запускай серверы сам в шелле (`node server.js`, `npm start`, `python bot.py`) — шелл живёт на общем хосте: процесс убьют, а твоя сессия повиснет.
-3. **Никакой аутентификации / OAuth / JWT.**
-4. **Никакого Docker, nginx, sudo, системных настроек.**
-5. **Никаких `npm install` / `pip install` в шелле** — зависимости ставит `run` внутри контейнера юзера. Для лендингов Tailwind — только через CDN.
-6. **НИКОГДА `git init` в workspace root (`/srv/opencode/workspaces/users/samruk_4`)** — это папка-контейнер юзера, не репозиторий.
-
----
-## ⚙️ Бэкенд, боты, run → навык `backend-run`
-
-Telegram-бот, API, сервер, команда `run`, динамика, ИИ или агент Alem внутри проекта, корпоративная почта Lotus — сначала вызови `skill({ name: "backend-run" })` (рецепты T и B, блок «ИИ», Alem, почта, чек-лист «не запускается»), потом строй. Без него не начинай.
-
----
-
-## 🏗 СТРОЙ ФАЗАМИ — план, красивый фронт, потом остальное
-
-**Шаг 0 — блюпринт.** Перед первой правкой напиши юзеру короткий план: 3-6 строк, какие фазы и какие файлы. Подтверждения НЕ жди — сразу строй.
-
-**Фаза 1 — ВСЕГДА красивый работающий фронт с мок-данными.** Свёрстанный index.html + style.css + script.js, данные захардкодь прямо в код (массив объектов). Фаза закончена = юзер открыл Предпросмотр и увидел КРАСИВУЮ работающую страницу. Не начинай бэкенд, пока фронт не смотрится достойно.
-
-**Фазы 2+ — по одной за раз:** бэкенд (server.js вместо мок-данных), интеграции, доп-страницы. После каждой фазы коротко скажи юзеру, что готово и что дальше.
-
-**Сколько фаз:** простая задача (визитка, лендинг, одна страница) = 1 фаза, НЕ раздувай. Сложная (приложение с данными/ботом) = 2-4. Больше 4 не планируй.
-
-**✅ ЧЕК-ЛИСТ СДАЧИ ФАЗЫ (обязателен, прогоняй молча перед «готово»):**
-1. Каждый созданный/правленный .js прогнан через `node --check <файл>` (bash). Ошибка — почини до сдачи.
-2. Фронт и бэк СОГЛАСОВАНЫ буквально: пути fetch совпадают с роутами server.js, имена полей JSON одинаковые с обеих сторон (открой оба файла и сверь глазами — несовпадение поля это самый частый твой баг).
-3. Каждый id/класс из script.js реально есть в index.html.
-4. В server.js путь запроса очищай от query: сравнивай `req.url.split("?")[0]`, а не весь req.url — иначе ссылка с параметрами отдаст 404.
-5. Если есть бэкенд — запусти `run` и ДОЧИТАЙ лог до конца: ошибка в логе = фаза не сдана. Если только статика — посмотри вкладку Предпросмотр.
-6. Никаких выдуманных CDN-адресов и библиотек: используй только то, что перечислено в рецептах ниже.
-## 📁 ТЫ УЖЕ ВНУТРИ ПАПКИ ПРОЕКТА — собирай сайт ЗДЕСЬ
-
-Твоя рабочая директория (cwd) — это **папка проекта юзера** (`.../users/<username>/<project>/`). Проект уже создан за тебя в тот момент, когда юзер написал идею на главной. Проверь: `pwd` — папка проекта, `ls` — там лежат AGENTS.md/design.md/README.md.
-
-**Собирай сайт ПРЯМО В ТЕКУЩЕЙ папке:** создавай `index.html`, `style.css`, `script.js` здесь же, в cwd.
-
-❌ **НЕ запускай `./new-project`.** ❌ **НЕ делай `cd` в другие папки / в корень воркспейса.** Если создашь новый проект или уйдёшь в корень — сайт окажется НЕ в том проекте, а юзер увидит пустой Предпросмотр своего проекта и спросит «а где сайт?». Именно так это ломается.
-
-❌ **НИКОГДА не пиши файлы по АБСОЛЮТНОМУ пути и не конструируй путь из названия проекта** (`/srv/.../<имя>/index.html`). Только ОТНОСИТЕЛЬНЫЕ пути в cwd: `index.html`, `data.json`, `./style.css`. Абсолютный/угаданный путь создаёт папку-двойник (особенно если в названии кириллица) → файл уходит мимо проекта, Предпросмотр пустой. Не уверен, где ты — сделай `pwd` и `ls`, а не угадывай.
-
-### Когда `./new-project` всё-таки нужен
-Только если юзер ЯВНО просит **отдельный НОВЫЙ проект** («создай ещё один проект», «сделай новый сайт отдельно») — и только тогда, когда в текущей папке реально есть скрипт `new-project` (значит ты в корне воркспейса). В обычном сценарии «сделай мне лендинг» — НЕ нужен, собирай в текущей папке.
-
----
-## 🌐 Git и публикация
-
-**НЕТ GitHub.** Self-hosted git: **https://git.vibe42.kz**
-
-- Профиль юзера: https://git.vibe42.kz/samruk_4
-- Pages (живые лендинги): https://pages.git.vibe42.kz/samruk_4/<repo>/
-- Креды уже в `/srv/opencode/workspaces/users/samruk_4/.git-credentials` — git push/clone работают без пароля
-- **НЕ спрашивай юзера про GitHub URL / токен** — их не нужно
-
-### Опубликовать лендинг (ТОЛЬКО по кнопке «Опубликовать»)
-
-```bash
-git add -A
-git commit -m "site"
-git push origin HEAD:pages
-```
-
-Ветка **`pages`** (Caddy её обслуживает; `gh-pages` тоже работает как fallback). Push → лендинг доступен мгновенно. **Но пушь в `pages` только когда юзер попросил опубликовать (нажал кнопку). Пока не просил — коммить и пушь только в `main`, показывай через Предпросмотр.**
-
-**Если push отклонён («permission denied for writing» и т.п.)** — это проблема git-кредов, она чинится сама при перезаходе. Скажи юзеру ровно это: «Перезайди на платформу (выйди и войди) и нажми "Опубликовать" ещё раз». НИКОГДА не связывай ошибки git/публикации с Лотусом — Лотус это ТОЛЬКО корпоративная почта, к репозиториям и публикации он отношения не имеет. Не выдумывай причин, которых не видишь в выводе команды.
-
----
-## 🔧 Когда что-то идёт не так
-
-- **Pages 404** → запушь ветку `pages` снова: `git push origin HEAD:pages -f`
-
-### ⚠️ Проекты с бэкендом (server.js / run) и статика — НЕ путай юзера
-Вкладка **Превью** и публикация в Pages показывают ТОЛЬКО статические файлы — server.js там НЕ работает: формы method=POST и запросы к твоему серверу будут мертвы. Поэтому:
-- Прежде чем переделывать работающий статический index.html на серверный рендер (форма POST, шаблоны из server.js) — ПРЕДУПРЕДИ юзера: «после этого Превью и Опубликовать перестанут показывать живую версию, рабочая ссылка будет только через run». Меняй только после его согласия.
-- Если проект уже с бэкендом: держи index.html статическим фронтом (разметка + fetch к API бэкенда), а не серверным шаблоном — тогда Превью хотя бы показывает актуальную вёрстку. Юзеру давай run-ссылку как основную и прямо говори, что «Опубликовать» выложит только статическую часть.
-- run-контейнер засыпает после ~20 минут простоя — ссылка перестанет открываться, это нормально: пусть юзер попросит тебя снова сделать `run`.
-- После существенных правок уже опубликованного сайта НАПОМНИ юзеру нажать «Опубликовать» ещё раз — иначе на сайте останется старая версия.
-- **Не дёргай Gitea API типа `/repos/.../pages`, `/settings/pages`, `/deploy_keys`** — их нет
-- **Не пытайся «настроить Pages через UI Gitea»** — Pages у нас работают только через push в ветку `pages`
-- Запуталось — сделай новый чистый проект через `./new-project NAME-v2`, перенеси туда работающий index.html
-
----
-## ❌ Чего НЕ делать НИКОГДА
-
-- ❌ `git init` в workspace root
-- ❌ `npm install` с прод-зависимостями (express/mongoose/pg/prisma/next/nuxt)
-- ❌ Поднимать бэкенд там, где хватает статики (лендинг, визитка, презентация) — сверься с таблицей стека
-- ❌ Ставить прод-фреймворки (express / nest / next / django) — сервер только на `node:http`
-- ❌ Использовать `gh` CLI или GitHub API
-- ❌ Вызывать Gitea Pages-API (его нет)
-- ❌ Долгое отлаживание Pages — почти всегда решение «push HEAD:pages»
-- ❌ Просить юзера ввести токен/URL/пароль — всё уже настроено
-- ❌ Задавать юзеру 10 вопросов подряд (максимум 2-3 за раз)
-- ❌ **Публиковать сам (push в `pages`) без просьбы юзера / кнопки «Опубликовать»** — до публикации показывай результат только через Предпросмотр
-- ❌ **Запускать `./new-project` или уходить `cd` из текущей папки проекта** на обычный запрос «сделай сайт» — ты УЖЕ в папке проекта, собирай тут; иначе сайт уедет не в тот проект
-- ❌ Показывать юзеру голый код больше 1 раза — ему важен результат, а не как написано
-- ❌ Предлагать «давай сначала дизайн в Figma» — мы делаем сразу в HTML
-- ❌ Говорить «это сложно» — переформулируй в простое
-- ❌ Зависать в обсуждениях — сделай первый вариант грубо, потом итерируй
-
----
-## 🎨 design.md + дизайн-система KT AI
-
-Рядом лежит `design.md` — **прочитай его перед первой строкой вёрстки**. В нём каркас `index.html`, классы блоков лендинга и токены дизайн-системы KT AI, которая уже лежит в проекте папкой `design-system/`.
-
-**Порядок для сайта/страницы — ровно такой:** 1) `read design.md`, 2) `read index.html` — стартовый каркас на ДС уже лежит в проекте, 3) `edit index.html` под задачу юзера. Отдельный `style.css` со своей палитрой не нужен: ДС уже стилизует кнопки, карточки и типографику; свой `<style>` — только на мелочи, и цвета в нём — токенами `var(--kt-ai-…)`. Запись HTML/CSS с Tailwind/Bootstrap/Google Fonts или с россыпью hex-цветов отклоняется автоматически (design-guard) — не спорь с ним и не обходи через bash, а исправь файл. Если проект не про веб-страницу (бот, скрипт, разбор документов) — стартовый `index.html` просто удали.
-
-Правило простое: **весь UI собирается из классов и токенов ДС**. Свои цвета, шрифты и чужие CSS-фреймворки (Bootstrap, Tailwind, Material, Font Awesome, Google Fonts) — не подключаем: в ДС уже всё есть, включая шрифт Inter.
-
-Папку `design-system/` коммить вместе с проектом — иначе опубликованная на Pages страница останется без стилей.

design.md

@@ -1,228 +0,0 @@
-<!-- vibe42-design-version: v4-ds-scaffold-2026-09-11 -->
-# Дизайн-система KT AI — по ней собирается весь UI
-
-В папке проекта лежит `design-system/` — это **дизайн-система KT AI**
-(источник: `github.com/erjan-A/kt-ai-design-system`, MIT, версия в `design-system/VERSION`).
-Весь визуал берётся оттуда: цвета, шрифт, отступы, кнопки, карточки, секции лендинга.
-
-**Не выдумывай свой стиль и не тащи чужие фреймворки.** Твоя работа — собрать страницу
-из готовых классов ДС и наполнить её содержанием юзера.
-
-Если папки `design-system/` в проекте нет (старый проект) — принеси её один раз:
-
-```bash
-cp -r /srv/opencode/design-system/kt-ai design-system
-```
-
----
-
-## 🔒 Три правила, которые нельзя нарушать
-
-1. **Цвета и размеры — только токенами** `var(--kt-ai-…)`. Сырой hex (`#0F1218`, `#fff`) в вёрстке
-   запрещён: он ломает светлую/тёмную тему.
-2. **Никакого Bootstrap / Tailwind / Material / Font Awesome / Google Fonts.** Шрифт (Inter) уже
-   внутри ДС и работает офлайн. Всё, что нужно лендингу, в ДС уже есть.
-3. **Свой `<style>` — только на мелочи**, которых нет в ДС (позиционирование, картинка-фон).
-   Не переопределяй кнопки, карточки и типографику.
-
----
-
-## Старт: `index.html`
-
-Это рабочий каркас лендинга. Копируй его целиком и меняй содержание.
-
-**В новом проекте этот каркас уже лежит как `index.html`** — не создавай файл заново: `read index.html` → `edit`.
-Если проект старый и файла нет — скопируй каркас ниже целиком. Если проект не про веб-страницу — стартовый `index.html` можно удалить.
-
-```html
-<!DOCTYPE html>
-<html lang="ru" data-theme="auto">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<title>Название проекта</title>
-<link rel="stylesheet" href="design-system/kt-ai-fonts.css">
-<link rel="stylesheet" href="design-system/kt-ai-tokens.css">
-<link rel="stylesheet" href="design-system/kt-ai-components.css">
-<link rel="stylesheet" href="design-system/kt-ai-page.css">
-<style>
-  /* ДС рисует кнопки для <button>; у ссылки-кнопки браузер добавляет подчёркивание */
-  a.kt-ai-btn { text-decoration: none; }
-</style>
-</head>
-<body>
-
-<header class="kt-ai-pagehead">
-  <div class="kt-ai-wrap kt-ai-pagehead-in">
-    <strong>Название</strong>
-    <span class="kt-ai-spacer"></span>
-    <a class="kt-ai-btn" data-variant="ghost" href="#about">О нас</a>
-    <a class="kt-ai-btn" data-variant="primary" href="#contacts">Оставить заявку</a>
-  </div>
-</header>
-
-<section class="kt-ai-hero" data-align="center">
-  <div class="kt-ai-wrap">
-    <h1>Главное обещание в одну строку</h1>
-    <p class="kt-ai-hero-sub">Подзаголовок: кому это и почему стоит остаться.</p>
-    <div class="kt-ai-hero-actions">
-      <a class="kt-ai-btn" data-variant="primary" data-size="lg" href="#contacts">Оставить заявку</a>
-      <a class="kt-ai-btn" data-size="lg" href="#about">Подробнее</a>
-    </div>
-  </div>
-</section>
-
-<section id="about" class="kt-ai-section" data-divider="true">
-  <div class="kt-ai-wrap">
-    <div class="kt-ai-section-head">
-      <h2>Что вы получите</h2>
-      <p>Одно-два предложения пояснения к секции.</p>
-    </div>
-    <div class="kt-ai-grid" style="margin-top:var(--kt-ai-space-9)">
-      <article class="kt-ai-tile"><h3>Пункт первый</h3><p>Коротко и по делу.</p></article>
-      <article class="kt-ai-tile"><h3>Пункт второй</h3><p>Коротко и по делу.</p></article>
-      <article class="kt-ai-tile"><h3>Пункт третий</h3><p>Коротко и по делу.</p></article>
-    </div>
-  </div>
-</section>
-
-<section id="contacts" class="kt-ai-cta">
-  <div class="kt-ai-wrap">
-    <h2>Призыв к действию</h2>
-    <p>Город, адрес, часы работы — то, что нужно, чтобы дойти.</p>
-    <a class="kt-ai-btn" data-variant="primary" data-size="lg" href="#">Написать</a>
-  </div>
-</section>
-
-<footer class="kt-ai-wrap kt-ai-pagefoot">
-  <span>© 2026 Название</span>
-  <span class="kt-ai-spacer"></span>
-  <span>Контакты</span>
-</footer>
-
-</body>
-</html>
-```
-
----
-
-## Блоки страницы (`kt-ai-page.css`)
-
-| Класс | Что это |
-|-------|---------|
-| `.kt-ai-wrap` | контейнер по центру (1080px). `data-width="narrow"` — 720px, `"wide"` — 1200px |
-| `.kt-ai-pagehead` + `.kt-ai-pagehead-in` | липкая шапка страницы |
-| `.kt-ai-hero`, `.kt-ai-hero-sub`, `.kt-ai-hero-actions` | первый экран. `data-align="center"` — по центру |
-| `.kt-ai-section` + `.kt-ai-section-head` (h2 + p) | обычная секция. `data-divider="true"` — линия сверху |
-| `.kt-ai-grid` + `.kt-ai-tile` (h3 + p) | сетка плиток «возможности». `data-cols="2"/"4"`, у плитки `data-span="2"/"full"` |
-| `.kt-ai-tile-icon` | иконка над заголовком плитки (спрайт — `design-system/icons/`) |
-| `.kt-ai-cta` | финальный блок с призывом |
-| `.kt-ai-pagefoot` | подвал |
-| `.kt-ai-spacer` | распорка внутри шапки/подвала (толкает остальное вправо) |
-| `.kt-ai-centered` | одна карточка по центру экрана — для страницы входа и 404 |
-
-Отступы между секциями ДС ставит сама. Адаптив (3→2→1 колонка) — тоже, `@media` писать не нужно.
-
-## Элементы (`kt-ai-components.css`)
-
-| Класс | Как применять |
-|-------|---------------|
-| `.kt-ai-btn` | кнопка / ссылка-кнопка. `data-variant="primary"` — главная, `"ghost"` — прозрачная, `"danger"` — опасная. `data-size="sm"/"lg"` |
-| `.kt-ai-card` | карточка контента |
-| `.kt-ai-chip` | статус-пилюля / тег |
-| `.kt-ai-link` | текстовая ссылка |
-| `.kt-ai-field` + `.kt-ai-input` / `.kt-ai-textarea` / `.kt-ai-select` | поле формы с подписью |
-
-**Один `primary` на экран.** Остальные кнопки — обычные или `ghost`.
-
-## Токены (`kt-ai-tokens.css`)
-
-Цвет: `--kt-ai-bg`, `--kt-ai-bg-soft`, `--kt-ai-fg`, `--kt-ai-fg-muted`, `--kt-ai-fg-faint`,
-`--kt-ai-border`, `--kt-ai-divider`, `--kt-ai-card-bg`, `--kt-ai-card-border`,
-`--kt-ai-primary`, `--kt-ai-link`, `--kt-ai-danger`.
-
-Отступы: `--kt-ai-space-1…12` (2px → 64px). Скругления: `--kt-ai-radius-md/lg/xl/2xl/3xl/full`.
-Текст: `--kt-ai-text-xs…3xl`. Вес: `--kt-ai-weight-regular/medium/semibold/bold`.
-Шрифты: `--kt-ai-font-sans` (Inter), `--kt-ai-font-mono`.
-
-**Тема** — атрибут на `<html>`: `data-theme="auto"` (по системной, ставь его по умолчанию),
-`"light"`, `"dark"`. Проверь страницу в обеих темах — с токенами это бесплатно.
-
----
-
-## Не лендинг, а приложение (дашборд, таблица, очередь заявок, чат)
-
-Тогда экран собирается **не вёрсткой руками, а конфигом**:
-
-1. Возьми `design-system/templates/kt-ai-app-shell.html` — самодостаточный HTML-каркас приложения
-   (без React и npm).
-2. Опиши экран JSON-конфигом по `design-system/docs/PRODUCT_CONTRACT.md` и положи его в тег
-   `<script id="kt-app-config" type="application/json">…</script>` внутри каркаса — он сам отрисует
-   таблицу, KPI, фильтры, drawer и темы.
-3. Проверь конфиг: `python3 design-system/scripts/validate_product.py config.json --strict` → нужен `0/0`.
-
-Полные правила для сложных экранов — `design-system/AGENTS.md`, список компонентов —
-`design-system/COMPONENTS.md`, приёмка — `design-system/CHECKLIST.md`. Читай их, когда лендинга
-уже мало.
-
----
-
-## 📦 Готовые рецепты
-
-### Фото без ключей
-- Одно и то же слово → одна и та же картинка: `https://picsum.photos/seed/coffee/800/600`
-- По теме: `https://loremflickr.com/800/600/coffee` (тег прямо в URL)
-
-Вставляй с рамкой ДС: `<img src="…" alt="…" style="width:100%;border-radius:var(--kt-ai-radius-3xl)">`
-
-### Кнопка WhatsApp
-```html
-<a class="kt-ai-btn" data-variant="primary" data-size="lg"
-   href="https://wa.me/7XXXXXXXXXX?text=Здравствуйте!">Написать в WhatsApp</a>
-```
-`7XXXXXXXXXX` — номер в международном формате без `+`.
-
-### Форма заявки без бэкенда
-```html
-<form action="https://formsubmit.co/EMAIL" method="POST" style="max-width:420px">
-  <div class="kt-ai-field"><label>Имя</label><input class="kt-ai-input" name="name" required></div>
-  <div class="kt-ai-field"><label>Телефон</label><input class="kt-ai-input" name="phone" required></div>
-  <button class="kt-ai-btn" data-variant="primary" type="submit">Отправить</button>
-</form>
-```
-Скажи юзеру: замени `EMAIL` на свою почту — заявки будут приходить туда (первая заявка активирует форму).
-
-### Favicon-эмодзи (без файла)
-```html
-<link rel="icon" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>☕</text></svg>">
-```
-
-### Карта
-На maps.google.com: место → «Поделиться» → «Встроить карту» → вставь iframe как есть:
-```html
-<iframe src="https://www.google.com/maps/embed?pb=..." width="100%" height="320"
-        style="border:0;border-radius:var(--kt-ai-radius-3xl)" loading="lazy"></iframe>
-```
-
-### Плавные появления при скролле
-```html
-<style>
-.reveal{opacity:0;transform:translateY(20px);transition:opacity .6s ease,transform .6s ease}
-.reveal.in{opacity:1;transform:none}
-</style>
-<script>
-var io=new IntersectionObserver(function(entries){
-  entries.forEach(function(e){ if(e.isIntersecting) e.target.classList.add('in'); });
-},{threshold:.15});
-document.querySelectorAll('.reveal').forEach(function(el){ io.observe(el); });
-</script>
-```
-
----
-
-## Перед тем как сказать «готово»
-
-- [ ] Подключены все четыре CSS из `design-system/`, папка лежит в проекте (не забудь закоммитить её).
-- [ ] В вёрстке нет сырых hex-цветов и чужих шрифтов.
-- [ ] Страница нормально выглядит в светлой и тёмной теме и на телефоне (узкое окно).
-- [ ] Один `data-variant="primary"` на экран, тексты — про юзера, а не «Lorem ipsum».

index.html

@@ -1,132 +0,0 @@
-<!DOCTYPE html>
-<html lang="ru">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<title>Кофейня</title>
-<style>
-:root{--ink:#0F1218;--cyan:#00E5FF;--cyan-50:#E8FCFF;--white:#fff;--gray-500:#5B6573;--gray-100:#F2F4F7;--coffee:#2C1810;--coffee-light:#3D2317;--gold:#D4A574}
-*{box-sizing:border-box;margin:0;padding:0}
-body{font:17px/1.6 -apple-system,BlinkMacSystemFont,"Segoe UI",Inter,system-ui,sans-serif;color:var(--white);background:var(--ink)}
-.container{max-width:1140px;margin:0 auto;padding:80px 24px}
-.hero{background:linear-gradient(135deg,var(--coffee) 0%,var(--ink) 100%);text-align:center;padding:120px 24px}
-.hero h1{font-size:56px;font-weight:800;line-height:1.05;margin-bottom:16px;color:var(--gold)}
-.hero p{font-size:20px;color:var(--gray-500);max-width:600px;margin:0 auto 32px}
-.hero .emoji{font-size:64px;margin-bottom:24px}
-.btn{display:inline-block;background:var(--gold);color:var(--ink);padding:14px 28px;border-radius:8px;font-weight:700;text-decoration:none}
-.btn:hover{background:#e6b885}
-.section{padding:80px 24px}
-.section h2{font-size:36px;font-weight:700;margin-bottom:48px;text-align:center;color:var(--gold)}
-.menu-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(300px,1fr));gap:24px}
-.menu-category{background:var(--coffee);border-radius:16px;padding:32px}
-.menu-category h3{font-size:22px;font-weight:700;margin-bottom:24px;color:var(--gold);border-bottom:1px solid var(--coffee-light);padding-bottom:12px}
-.menu-item{display:flex;justify-content:space-between;align-items:center;padding:12px 0;border-bottom:1px solid var(--coffee-light)}
-.menu-item:last-child{border-bottom:none}
-.menu-item-name{font-weight:500}
-.menu-item-price{color:var(--gold);font-weight:700;font-size:18px}
-.menu-item-desc{color:var(--gray-500);font-size:14px;margin-top:4px}
-.info-section{background:var(--coffee)}
-.info-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(250px,1fr));gap:32px;text-align:center}
-.info-item{padding:24px}
-.info-item .emoji{font-size:48px;margin-bottom:16px}
-.info-item h3{font-size:20px;font-weight:700;margin-bottom:8px;color:var(--gold)}
-.info-item p{color:var(--gray-500)}
-.cta{text-align:center;padding:80px 24px;background:linear-gradient(135deg,var(--ink) 0%,var(--coffee) 100%)}
-.cta h2{font-size:36px;font-weight:700;margin-bottom:16px;color:var(--gold)}
-.cta p{color:var(--gray-500);margin-bottom:32px}
-.footer{text-align:center;padding:32px;color:var(--gray-500);font-size:14px}
-@media(max-width:640px){.hero h1{font-size:36px}.section h2{font-size:28px}.menu-grid{grid-template-columns:1fr}.info-grid{grid-template-columns:1fr}}
-</style>
-</head>
-<body>
-<section class="hero">
-  <div class="emoji">☕</div>
-  <h1>Кофейня</h1>
-  <p>Свежий кофе, уютная атмосфера и лучшие напитки в городе</p>
-  <a class="btn" href="#menu">Посмотреть меню</a>
-</section>
-<section id="menu" class="section">
-  <h2>Наше меню</h2>
-  <div class="menu-grid">
-    <div class="menu-category">
-      <h3>☕ Кофе</h3>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Эспрессо</div><div class="menu-item-desc">Классика итальянского кофе</div></div>
-        <div class="menu-item-price">400 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Капучино</div><div class="menu-item-desc">Нежная молочная пенка</div></div>
-        <div class="menu-item-price">650 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Латте</div><div class="menu-item-desc">Мягкий вкус с молоком</div></div>
-        <div class="menu-item-price">700 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Раффе</div><div class="menu-item-desc">Сливочный кофейный коктейль</div></div>
-        <div class="menu-item-price">750 ₸</div>
-      </div>
-    </div>
-    <div class="menu-category">
-      <h3>🧊 Холодные напитки</h3>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Айс-латте</div><div class="menu-item-desc">Холодный латте со льдом</div></div>
-        <div class="menu-item-price">750 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Фрапучино</div><div class="menu-item-desc">Кофейный коктейль со льдом</div></div>
-        <div class="menu-item-price">850 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Лимонад</div><div class="menu-item-desc">Домашний лимонад</div></div>
-        <div class="menu-item-price">600 ₸</div>
-      </div>
-    </div>
-    <div class="menu-category">
-      <h3>🥐 Десерты</h3>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Круассан</div><div class="menu-item-desc">Свежий, с шоколадом</div></div>
-        <div class="menu-item-price">500 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Чизкейк</div><div class="menu-item-desc">Классический нью-йорк</div></div>
-        <div class="menu-item-price">700 ₸</div>
-      </div>
-      <div class="menu-item">
-        <div><div class="menu-item-name">Кексы</div><div class="menu-item-desc">Ассортимент на выбор</div></div>
-        <div class="menu-item-price">400 ₸</div>
-      </div>
-    </div>
-  </div>
-</section>
-<section class="section info-section">
-  <div class="container">
-    <div class="info-grid">
-      <div class="info-item">
-        <div class="emoji">📍</div>
-        <h3>Адрес</h3>
-        <p>ул. Примерная, 12<br>Алматы, Казахстан</p>
-      </div>
-      <div class="info-item">
-        <div class="emoji">🕐</div>
-        <h3>Часы работы</h3>
-        <p>Пн-Пт: 8:00 - 22:00<br>Сб-Вс: 9:00 - 23:00</p>
-      </div>
-      <div class="info-item">
-        <div class="emoji">📞</div>
-        <h3>Контакты</h3>
-        <p>+7 (700) 000-00-00<br>hello@coffee.kz</p>
-      </div>
-    </div>
-  </div>
-</section>
-<section class="cta">
-  <h2>Ждём вас!</h2>
-  <p>Приходите попробовать наш кофе или закажите доставку</p>
-  <a class="btn" href="https://wa.me/77000000000">Заказать в WhatsApp</a>
-</section>
-<footer class="footer">
-  <p>© 2026 Кофейня. Все права защищены.</p>
-</footer>
-</body>
-</html>