Справочник

27 конвенций, отточенных вручную

Наша философия и то, что покрывает библиотека конвенций.

Философия

Мы исходим из того, как код, сгенерированный ИИ, на самом деле ломается: молчаливые any-типы, проглоченные ошибки, недопустимые состояния, достижимые через опциональные поля, runtime-падения из-за невалидированных входных данных. Каждое правило написано так, чтобы увести модель от одного из этих сценариев — и остаётся в библиотеке, только если заметно улучшает код, который пишут агенты.

Каждое правило короткое, с чёткой позицией и самодостаточное. Агент читает правило непосредственно перед релевантным изменением — а не все правила сразу в начале сессии. Это означает меньшие промпты, меньшие счета и правила, которые модель действительно может удерживать в рабочей памяти, пока пишет код.

Что в библиотеке

Текущая библиотека содержит 27 конвенций, охватывающих области, в которых TypeScript, сгенерированный ИИ, чаще всего идёт не так: строгость типов, обработка ошибок, runtime-валидация на границах доверия, именование и структура модулей, поток управления и фреймворк-специфичные паттерны (например, формы пропсов React-компонентов, конвенции моделей Prisma).

Конкретные правила доступны подписчикам через MCP-сервер — мы не публикуем полный список здесь. Оформите подписку, чтобы получить доступ к корпусу.

Обновления

Мы добавляем и дорабатываем конвенции по мере развития инструментов и поведения моделей. Обновления применяются мгновенно: на вашей стороне ничего передеплоивать не нужно. О крупных изменениях подписчиков уведомляем по email.