Разработка с ИИ
ИИ-редакторы и кодовые агенты часто ошибаются насчёт sitelo: они тянутся к приёмам React, Next или Astro, которые здесь неприменимы. Это руководство показывает, как направить их на актуальную документацию sitelo и удержать генерируемый код в правильной модели.
llms.txt
sitelo публикует машиночитаемое описание фреймворка по адресу sitelo.dev/llms.txt. Многие агенты умеют загружать URL; попросите своего прочитать этот файл (и документацию для людей), прежде чем писать код на sitelo.
- https://sitelo.dev/llms.txt — компактное описание API и соглашений
- https://sitelo.dev/ru/docs — полные руководства
- README на GitHub — общая модель и обзор возможностей
- https://ht.js.org — документация
javascript-to-html(рекомендуется для написания HTML на JS)
В отличие от MCP-сервера с документацией, llms.txt не требует установки — вставьте URL в чат, добавьте его в правила проекта или дайте агенту загрузить его самому.
Правила проекта
Если ваш инструмент поддерживает постоянные инструкции (AGENTS.md, правила Cursor, инструкции Copilot, …), добавьте короткое правило про sitelo, чтобы каждая сессия начиналась с верной модели. В базовом примере есть AGENTS.md, который можно скопировать:
# sitelo
Этот проект использует [sitelo](https://sitelo.dev) — генератор статических сайтов на базе Vite.
## Правила
- Страницы — это модули внутри `src/` с расширениями вроде `.ht.js` / `.ht.ts` / `.ht.jsx`, которые **экспортируют по умолчанию функцию (или строку), возвращающую HTML**.
- **Не** добавляй React, Next.js, Astro или любой компонентный фреймворк с гидратацией, если пользователь не попросил об этом явно.
- Маршрутизация строится на файлах: `about.ht.js` → `/about`, `[slug].ht.js` → динамическая (используй `generateStaticParams` для `sitelo build`).
- Загружай данные через `export async function data(ctx)`. Для HTTP с кэшем используй `fetchWithCache` из `sitelo`. Локальный JSON читай через `readJson` / `readJsonCollection` из `sitelo/data`.
- В `dist/` попадает только тот JS/CSS, на который ссылается HTML. Оставляй серверный код без ссылок, чтобы он никогда не публиковался.
- Конфигурация лежит в `sitelo.config.js`. Параметры Vite — под ключом `vite`.
- Команды: `sitelo` (dev), `sitelo build`, `sitelo preview`.
- Актуальные API смотри на https://sitelo.dev/llms.txt и https://sitelo.dev/docs — не выдумывай API из других фреймворков.
- Для разметки предпочитай [javascript-to-html](https://ht.js.org) (`ht.js`): функции-теги, возвращающие строки HTML. Документация: https://ht.js.org
Cursor
Создайте .cursor/rules/sitelo.mdc в своём проекте (или вставьте тот же текст в интерфейс правил проекта в Cursor):
---
description: соглашения статических сайтов sitelo
alwaysApply: true
---
# sitelo
Страницы — это модули `.ht.js` (и т. п.), возвращающие строки HTML, а не компоненты React/Next/Astro.
Для разметки предпочитай javascript-to-html (https://ht.js.org). Используй файловую маршрутизацию, `data()` и `sitelo build`.
Об API sitelo смотри https://sitelo.dev/llms.txt
Советы по работе с sitelo и ИИ
- Начинайте с шаблона — попросите агента развернуть каркас из examples/basic или examples/wordpress, вместо того чтобы выдумывать фреймворк.
- Для разметки предпочитайте javascript-to-html (
ht.js) — функции-теги, возвращающие строки HTML, без шаблонизатора и без React. Направьте агентов на ht.js.org, чтобы они не выдумывали деревья JSX-компонентов. - Страницы — это функции, возвращающие HTML:
export default () => `<html>…</html>`или композиция черезjavascript-to-html. JSX годится, пока компилируется в строки; рантайм React не нужен. - Используйте CLI sitelo —
sitelo/sitelo build— а неviteнапрямую, если только вам точно не нужна своя конфигурация Vite. - Сверяйте API с llms.txt — особенно
generateStaticParams,fetchWithCacheи серверные острова. - Ноль JS по умолчанию — подключайте
<script>только когда странице нужен клиентский код; модули без ссылок остаются на сервере. - Проверяйте и запускайте — после правок агента всегда выполняйте
sitelo build(или сервер разработки); считайте сгенерированную разметку черновиком.