# astro

Набор инструкций для Claude Code по разработке серверных страниц и API-маршрутов на Astro. Помогает писать типизированный бэкенд и настраивать middleware.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 267 у репозитория
- Автор: przeprogramowani
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/przeprogramowani/ai-rules-builder/tree/HEAD/.cursor/rules/astro.mdc
- Обновлён: 2026-02-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/przeprogramowani-astro

## Что делает

Правило задаёт стандарты серверного рендеринга и гибридного режима в Astro. Агент настраивает эндпоинты с флагом `export const prerender = false`, валидирует входящие данные через Zod и оформляет имена обработчиков заглавными буквами вроде `GET` и `POST`. Для блогов и документации подключаются типизированные коллекции контента.

В инструкциях закреплена работа с `Astro.cookies`, переменными окружения через `import.meta.env` и встроенной оптимизацией картинок. Публичные маршруты требуют обязательных правок в `src/middleware/index.ts`, иначе проверка авторизации заблокирует гостевой доступ.

## Установка

### 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/przeprogramowani/ai-rules-builder/tree/HEAD/.cursor/rules/astro.mdc

## Когда брать
- валидировать запросы к API-эндпоинтам через Zod
- настроить гибридный рендеринг и отключить пререндеринг для серверных роутов
- создать типизированные коллекции контента для статей или документации
- управлять сессиями и куками на сервере через `Astro.cookies`

## Примеры запросов агенту
- Сделай серверный эндпоинт POST для формы подписки с проверкой схемы через Zod.
- Добавь типизированную коллекцию контента для раздела документации.
- Настрой middleware для проверки сессии через `Astro.cookies` и добавь исключение для публичной страницы.

## Похожие
- [astro-sites-manager](https://affpapa.org/nevibecode/skills/astro-sites-manager.md) — скилл · ★ 141 у репозитория
- [clerk-astro-patterns](https://affpapa.org/nevibecode/skills/clerk-astro-patterns.md) — скилл · 15000 установок
- [integration-astro-ssr](https://affpapa.org/nevibecode/skills/integration-astro-ssr.md) — скилл · 109 установок
- [astro-framework](https://affpapa.org/nevibecode/skills/astro-framework.md) — скилл · 2200 установок
- [astro-expert](https://affpapa.org/nevibecode/agents/astro-expert.md) — субагент · ★ 1029 у репозитория
- [custom-pages-and-apis](https://affpapa.org/nevibecode/skills/custom-pages-and-apis.md) — скилл · 488 установок

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

Из того же набора: [przeprogramowani/ai-rules-builder](https://affpapa.org/nevibecode/by/przeprogramowani/ai-rules-builder.md) — 24 карточки

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