# astro

Набор инструкций для Cursor по архитектуре Astro: островная гидратация, нулевой JavaScript по умолчанию, строгий TypeScript и структура файлов.

- правило · `type=rule` · Cursor · ★ 3580
- Автор: sanjeed5
- Лицензия: CC0-1.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/sanjeed5/awesome-cursor-rules-mdc/tree/HEAD/rules-mdc/astro.mdc
- Обновлён: 2026-05-19
- HTML: https://affpapa.org/nevibecode/rules/sanjeed5-astro

## Что делает

Правило задаёт стандарты архитектуры Astro в редакторе Cursor. Шаблоны `.astro` и страницы оформляются в `kebab-case`, а острова на React — в `PascalCase`. Полная упаковка страниц во фреймворк запрещена. Агент обязан генерировать серверную разметку без лишних клиентских библиотек.

Инструкция минимизирует клиентский JavaScript. Для интерактивности используются директивы `client:visible` или `client:idle`, а `client:load` остаётся только для критичных элементов первого экрана. Конфигурация требует `astro.config.ts`, строгий TypeScript с `verbatimModuleSyntax` и оптимизацию картинок через `astro:assets`.

Без прописанных путей в `tsconfig.json` импорты через `@components/*` сразу сломают сборку.

## Установка

### Cursor (родная платформа)

**Вручную: положить файлы**
- Файл: `.cursor/rules/astro.mdc` — Во frontmatter: description, globs, alwaysApply

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/rules/astro.md` — Поле paths во frontmatter ограничивает файлы: globs из источника → paths

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/astro.instructions.md` — Поле applyTo задаёт, к каким файлам применять: globs из источника → applyTo

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/astro.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/astro.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/sanjeed5/awesome-cursor-rules-mdc/tree/HEAD/rules-mdc/astro.mdc

## Когда брать
- Разделять статический HTML и интерактивные острова компонентов
- Назначать точечные директивы гидратации вместо избыточного `client:load`
- Организовать файловую структуру с папками `components`, `content` и `layouts`
- Оптимизировать локальные изображения через компонент `Image` из `astro:assets`

## Примеры запросов агенту
- Создай страницу блога со статической статьёй и реактивным островом комментариев на React
- Добавь форму подписки в подвал сайта с отложенной гидратацией через client:visible

## Похожие
- [clerk-astro-patterns](https://affpapa.org/nevibecode/skills/clerk-astro-patterns.md) — скилл · 14300 установок
- [javascript-astro-tailwind-css-cursorrules-prompt-f](https://affpapa.org/nevibecode/rules/javascript-astro-tailwind-css-cursorrules-prompt-f.md) — правило · ★ 41028
- [astro-typescript-cursorrules-prompt-file](https://affpapa.org/nevibecode/rules/astro-typescript-cursorrules-prompt-file.md) — правило · ★ 41028
- [astro-framework](https://affpapa.org/nevibecode/skills/astro-framework.md) — скилл · 2200 установок
- [astro-best-practices](https://affpapa.org/nevibecode/skills/astro-best-practices.md) — скилл · 521 установка
- [astro-seo](https://affpapa.org/nevibecode/skills/astro-seo.md) — скилл · 500 установок

## Другие версии с тем же именем
- [astro · github](https://affpapa.org/nevibecode/rules/astro.md) — ★ 40478

Из того же набора: [sanjeed5/awesome-cursor-rules-mdc](https://affpapa.org/nevibecode/by/sanjeed5/awesome-cursor-rules-mdc.md) — 240 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md