К основному содержанию
правило CX Codex

caliber-conventions — правило для Claude Code: соглашения TypeScript

Правило caliber-conventions задаёт соглашения для разработки CLI-проектов Caliber на TypeScript. Оно пригодится, чтобы агент учитывал требования проекта при работе с кодом и тестами.

MIT ★ 1 319 обновлён 2026-09-24

Установить в Cursor · Вручную: положить файлы Все способы и платформы ↓
.cursor/rules/caliber-conventions.mdc
Открыть на GitHub

Что делает caliber-conventions

Правило задаёт стиль импортов и типизации: для ESM нужны расширения .js, даже если исходный файл написан на TypeScript, а вместо any следует использовать unknown, поскольку ESLint предупреждает о явном any. Тесты размещаются в каталогах __tests__/ рядом с исходниками, общий файл настройки — src/test/setup.ts.

Для коммитов используются префиксы Conventional Commits: feat:, fix:, refactor: и chore:. Правило также задаёт расположение констант и функции resolveCaliber() для поиска пути к CLI-бинарнику. Определение языка файла должно опираться на LLM через src/ai/detect.ts, а collectFingerprint() выполняется асинхронно и дополняет результат с помощью LLM. Нужен Node.js версии 20 или выше.

Какие задачи решает

  • оформить ESM-импорты с расширением .js
  • избежать явного any в TypeScript-коде
  • разместить тесты рядом с исходниками в __tests__/
  • оформить сообщения коммитов с префиксами Conventional Commits
  • учесть требования к версии Node.js и разрешению пути к CLI-бинарнику

Примеры запросов агенту

  • Проверь TypeScript-код Caliber и приведи импорты и типы к соглашениям проекта.
  • Добавь тесты для этого модуля в соседний каталог __tests__/ и учти общий файл src/test/setup.ts.
  • Подготовь сообщение коммита для этого изменения с подходящим префиксом Conventional Commits.

Как установить caliber-conventions

Вручную: положить файлы

.cursor/rules/caliber-conventions.mdc

Во frontmatter: description, globs, alwaysApply

По шагам, с командами для каждой платформы: Cursor rules: файлы .mdc, четыре режима и замена .cursorrules

Вопросы о caliber-conventions

Как установить caliber-conventions в Claude Code?

Сохраните правило в файл .claude/rules/caliber-conventions.md проекта.

Что делает caliber-conventions?

Задаёт соглашения для TypeScript CLI-проектов Caliber: от ESM-импортов и тестов до формата коммитов и работы с определением языка файлов.

Какая версия Node.js нужна для caliber-conventions?

Для проекта требуется Node.js версии 20 или выше.

Исходный текст

caliber-conventions.mdc · MIT
---
description: Caliber project conventions for TypeScript CLI development
alwaysApply: true
---

- ESM imports with `.js` extensions (even for `.ts` sources)
- `unknown` over `any` — ESLint warns on explicit any
- Tests in `__tests__/` dirs next to source, global setup in `src/test/setup.ts`
- Conventional commits: `feat:`, `fix:`, `refactor:`, `chore:`
- No hardcoded file→language mappings — detection is LLM-driven via `src/ai/detect.ts`
- `collectFingerprint()` in `src/fingerprint/index.ts` is async with internal LLM enrichment
- Constants in `src/constants.ts` and `src/scoring/constants.ts`
- `resolveCaliber()` from `src/lib/resolve-caliber.ts` for CLI binary path resolution
- Dev branch: `next` · Stable: `master` · Node >= 20

© caliber-ai-org · MIT · caliber-ai-org/ai-setup

Похожие правила IDE

Все правила IDE по теме «Языки программирования» →
javascript-pro https://github.com/Jeffallan Скилл javascript-pro для Claude Code пишет, отлаживает и рефакторит JavaScript-код с ES2023+, async/await, ESM и Node.js API. Создаёт vanilla JavaScript-приложения и оптимизирует производительность в браузере и Node.js. CX Codex +1 6 600установок 1-conventions ai-driven-dev Правило 1-conventions задаёт соглашения для TypeScript-файлов в src/ и tests/: структуру модулей, имена файлов и уровни тестов. Оно пригодится при добавлении кода и тестов в проект. CX Codex +1 ★ 571звёзд репо tsdown rolldown Скилл tsdown для сборки TypeScript и JavaScript-библиотек на основе Rolldown. Генерирует типы, собирает в ESM/CJS, оптимизирует через tree shaking и минификацию. CX Codex +1 1 600установок rollup-bundler Mindrally Скилл rollup-bundler задаёт агенту правила конфигурации Rollup.js: форматы вывода, внешние зависимости, tree-shaking и плагины для сборки библиотек. CX Codex +1 696установок npm-package jwynia Скилл npm-package ведёт агента через создание npm-библиотеки на Bun: скаффолдинг, строгий TypeScript, тесты, сборка и публикация. CX Codex +1 335установок vueuse-core-skilld skilld-dev Скилл vueuse-core-skilld с полным API @vueuse/core 15.0.0: новые composables, правила миграции с v14, устаревшие функции и требования окружения. CX Codex +1 219установок

Из того же набора17

Весь набор →
caliber-onboarding Правило caliber-onboarding для Claude Code и Codex, которое при запуске сессии проверяет, синхронизированы ли конфиги Caliber. Если синхронизация не установлена, предлагает запустить /setup-caliber одной командой. CX Codex +1 ★ 1 319звёзд репо llm-layer Правило llm-layer для Claude Code задаёт соглашения для кода провайдеров моделей в src/llm/**: интерфейс LLMProvider, конфиг, seat-based режим и учёт использования. CX Codex +1 ★ 1 319звёзд репо testing Правило testing задаёт паттерны написания тестов на Vitest, изоляцию вызовов LLM и структуру тестовых файлов в проекте Caliber. CX Codex +1 ★ 1 319звёзд репо testing-patterns Правило testing-patterns для Claude Code задаёт соглашения по Vitest: расположение тестов, работу с моками LLM и запуск одного теста. CX Codex +1 ★ 1 319звёзд репо scoring-patterns Правило scoring-patterns задаёт архитектурные правила для проверок скоринга в src/scoring/**. Помогает писать детерминированные тесты без сетевых вызовов и случайных значений. CX Codex +1 ★ 1 319звёзд репо llm-patterns Правило llm-patterns задаёт соглашения для LLM-провайдеров в коде проекта. Оно пригодится при работе с моделями, конфигурацией, потоками и ошибками CLI. CX Codex +1 ★ 1 319звёзд репо caliber-pre-commit Правило caliber-pre-commit на каждый коммит: проверяет хук Caliber и, если хука нет, синхронизирует конфиги агентов и добавляет их в индекс. CX Codex +1 ★ 1 319звёзд репо find-skills Скилл find-skills ищет готовые скиллы сообщества через реестр Caliber и подключает их прямо во время диалога с агентом. CX Codex +1 ★ 1 319звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой