caliber-conventions — правило для Claude Code: соглашения TypeScript
Правило caliber-conventions задаёт соглашения для разработки CLI-проектов Caliber на TypeScript. Оно пригодится, чтобы агент учитывал требования проекта при работе с кодом и тестами.
MIT ★ 1 319 обновлён 2026-09-24
.cursor/rules/caliber-conventions.mdcЧто делает 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
Вручную: положить файлы
.claude/rules/caliber-conventions.mdПоле paths во frontmatter ограничивает файлы: globs из источника → paths
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.github/instructions/caliber-conventions.instructions.mdПоле applyTo задаёт, к каким файлам применять: globs из источника → applyTo
Вручную: положить файлы
.devin/rules/caliber-conventions.mdВручную: положить файлы
.clinerules/caliber-conventions.mdПо шагам, с командами для каждой платформы: 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