AI-инструменты для разработки

AstroGlass поставляется со встроенной поддержкой рабочих процессов на основе ИИ. Независимо от того, используете ли вы Claude Code, Cursor, GitHub Copilot или любой другой AI-помощник для кодирования, проект включает конфигурационные файлы, которые дают агентам глубокое понимание архитектуры.

Что включено

.claude/
  commands/
    prune-themes.md      # Хирургическое удаление ненужных тем
    add-locale.md        # Создание нового языка
    switch-provider.md   # Смена провайдера развертывания
    mix-theme.md         # Создание гибридной темы из секций
    deploy.md            # Сборка и развертывание
CLAUDE.md                # Файл проектной документации для ИИ

CLAUDE.md — Проектная документация

Файл CLAUDE.md в корне проекта служит базой знаний для AI-агентов. Он содержит:

Обзор архитектуры — Система тем, структура компонентов, маршрутизация
Расположение ключевых файлов конфигурации — Где найти темы, локали, палитры, провайдеры
Типовые рецепты — Пошаговые инструкции для частых операций
Карта файловой структуры — Полное дерево каталогов с аннотациями
Важные замечания — Особенности вроде «используется Valibot, а не Zod»

Любой AI-агент, прочитавший CLAUDE.md, сразу поймёт организацию проекта и сможет безопасно вносить изменения.

💡

Работает везде

CLAUDE.md распознаётся Claude Code нативно, но его формат Markdown делает его полезным для любого AI-инструмента. Cursor, Windsurf и Copilot также извлекут пользу из наличия этого файла в корне репозитория.

Слэш-команды

Каталог .claude/commands/ содержит шаблоны промптов, которые работают как слэш-команды в Claude Code. Каждая команда проводит ИИ через многоэтапную операцию.

/prune-themes — Удаление ненужных тем

Самая мощная команда. Она использует манифест themeRegistry.ts для хирургического удаления всех файлов, принадлежащих темам, которые вам не нужны.

Пример: «Мне нужна только тема Liquid» → команда удаляет ~200 файлов для остальных 5 тем, обновляет все файлы конфигурации и проверяет, что сборка по-прежнему проходит.

Что удаляется для каждой темы:

Компоненты секций (файлы .astro)
CSS-файлы компонентов
Варианты шапки и подвала
UI-примитивы, специфичные для темы
Скрипты и дизайн-токены
Barrel-файл и записи в конфигурации

ℹ️

Безопасность по дизайну

Команда использует src/config/themeRegistry.ts как единственный источник истины. Этот файл содержит точный манифест файлов для каждой темы, поэтому ничего не будет пропущено и ничего общего не будет удалено.

/add-locale — Добавление нового языка

Создаёт всё необходимое для нового языка:

Создаёт запись локали в src/config/locales.ts
Копирует все JSON-файлы переводов из английского в каталог новой локали
Переводит все строковые значения
Создаёт каталоги контента блога и документации с переведённым содержимым
Добавляет метки навигации боковой панели в src/utils/docs-nav.ts

/mix-theme — Создание гибридной темы

Выбирайте секции из разных тем для создания собственной комбинации:

Hero        → Liquid    (плавные анимации)
About       → Glass     (карточки с эффектом стекла)
Features    → Aurora    (градиентные фоны)
Pricing     → Neo       (смелый, энергичный стиль)
Testimonial → Minimal   (чистый, фокусированный)

Команда создаёт кастомный barrel-файл, регистрирует тему и включает только необходимые CSS-файлы.

/switch-provider — Смена провайдера развертывания

Переключение между Cloudflare Pages, Vercel и Netlify одной командой:

Установка правильного адаптера Astro
Обновление конфигурации активного провайдера
Настройка скриптов сборки
Проверка успешности сборки

/deploy — Сборка и развертывание

Запускает полный конвейер подготовки к развертыванию:

Диагностика TypeScript (pnpm check)
Линтинг (pnpm lint)
Проверка форматирования (pnpm format:check)
Продакшн-сборка (pnpm build)
Развертывание на активном провайдере

Как это работает

Реестр тем — ключ к безопасным операциям

Файл src/config/themeRegistry.ts — это то, что делает AI-операции с темами безопасными. Он содержит полный манифест каждого файла, принадлежащего каждой теме:

export const themeRegistry: Record<string, ThemeManifest> = {
  liquid: {
    barrel: 'src/components/sections/themes/liquid.ts',
    sections: [
      'src/components/sections/hero/HeroLiquid.astro',
      'src/components/sections/about/AboutLiquid.astro',
      // ... все компоненты секций
    ],
    css: [
      'src/styles/components/hero/HeroLiquid.css',
      // ... все CSS-файлы
    ],
    header: ['src/components/layout/header/HeaderLiquid.astro'],
    footer: ['src/components/sections/footer/FooterLiquid.astro'],
    ui: ['src/components/ui/liquid/LiquidSectionTag.astro'],
    scripts: [],
    tokens: ['src/styles/tokens/liquid.css'],
    npmDeps: [],
  },
  // ... другие темы
};

Архитектура на основе конфигурации

Проект использует файлы конфигурации как единственные источники истины:

Конфигурация	Управляет
`themes.ts`	Какие темы существуют и включены
`themePresets.ts`	Порядок секций на лендинге каждой темы
`locales.ts`	Какие языки активны
`palettes.ts`	Доступные цветовые палитры
`active-provider.ts`	Цель развертывания

Советы по работе с AI-агентами

Начните с CLAUDE.md — Направьте агента прочитать его первым для контекста
Используйте слэш-команды для сложных операций — Они кодируют многоэтапные процедуры корректно
Доверяйте реестру тем — Это авторитетный источник принадлежности файлов к темам
Запускайте pnpm check после изменений — Это ловит ошибки TypeScript и отсутствующие импорты
Valibot, а не Zod — Если агент предлагает Zod для валидации, перенаправьте его на Valibot