1-type-honesty — правило для Claude Code: что делает и как установить
Правило 1-type-honesty запрещает опасные приведения типов вроде any в TypeScript-коде и убирает подавление ошибок компилятора.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/1-type-honesty.mdЧто делает 1-type-honesty
Правило контролирует чистоту типов в файлах src/**/*.ts и tests/**/*.ts. Оно блокирует конструкции as unknown as, as any и as never, не позволяя искусственно расширять тип переменной.
В папке src/ полностью запрещены директивы @ts-expect-error и @ts-ignore. При этом директива @ts-expect-error разрешена в тестах, если нужно проверить падение компиляции на некорректных типах. Правило Biome noTsIgnore отсекает @ts-ignore во всём проекте.
Любое исключение требует обоснования: каждое оставшееся приведение фиксируется в списке CASTS_ALLOWED с указанием причины, а проверку обоих скоупов выполняет скрипт scripts/check-cli-type-honesty.mjs из корня репозитория.
Какие задачи решает
- заблокировать обходы типизации через
as anyи двойные приведения - исключить скрытые директивы
@ts-ignoreв основном кодеsrc/ - проверять ошибки компиляции типов внутри тестов через
@ts-expect-error - вести явный реестр допущенных кастов в
CASTS_ALLOWED
Примеры запросов агенту
- Проверь этот файл TypeScript по правилу type-honesty
- Перепиши функцию без использования
as anyи двойных кастов - Добавь тест на ошибку типов с
@ts-expect-error
Как установить 1-type-honesty
Вручную: положить файлы
.claude/rules/1-type-honesty.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/1-type-honesty.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/1-type-honesty.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/1-type-honesty.mdВручную: положить файлы
.clinerules/1-type-honesty.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о 1-type-honesty
Как установить 1-type-honesty в Claude Code?
Сохраните файл правила по пути .claude/rules/1-type-honesty.md в корне вашего проекта.
Что делает правило 1-type-honesty?
Оно запрещает опасные касты к any, never или через unknown, блокирует директивы игнорирования ошибок в исходниках и проверяет соблюдение правил скриптом.
Где разрешено использовать @ts-expect-error?
Только в тестах внутри каталога tests/, когда необходимо доказать, что TypeScript действительно не компилирует некорректный код.
Исходный текст
1-type-honesty.md · MIT
--- description: Apply to every cast; a value is never widened away from the type it holds. paths: - "src/**/*.ts" - "tests/**/*.ts" --- # Type Honesty - No `as unknown as`, `as any`, `as never`. - No `@ts-expect-error` or `@ts-ignore` in `src/`; biome's `noTsIgnore` refuses the latter everywhere. - A test proving non-compilation may use `@ts-expect-error`. - `scripts/check-cli-type-honesty.mjs` enforces both scopes, from the repository root. - `CASTS_ALLOWED` lists each surviving cast with its reason.
© ai-driven-dev · MIT · ai-driven-dev/framework