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

1-type-honesty — правило для Claude Code: что делает и как установить

Правило 1-type-honesty запрещает опасные приведения типов вроде any в TypeScript-коде и убирает подавление ошибок компилятора.

MIT ★ 571 обновлён 2026-10-29

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/1-type-honesty.md
Открыть на GitHub

Что делает 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 и 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

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

Все правила IDE по теме «Код-ревью и рефакторинг» →
principle-type-system-discipline backnotprop Скилл principle-type-system-discipline для Claude Code помогает проектировать типы, проверять сигнатуры и разбирать внешние данные. Подключается при работе со статически типизированным кодом. CX Codex +1 10 300установок ban-type-assertions Factory-AI Скилл ban-type-assertions для Claude Code запрещает утверждения типов as и помогает заменить их проверяемыми компилятором решениями. Запускается при настройке запрета в пакете или исправлении ошибок линтера. CX Codex +1 151установок python-type-safety Seth Hobson Скилл python-type-safety помогает добавлять типы в Python-код, писать дженерики и протоколы, а также настраивать строгую проверку через mypy или pyright. CX Codex +1 12 643установок ultracite haydenbleasel Скилл ultracite настраивает линтинг и форматирование JS/TS-проектов через Oxlint, Biome или ESLint одной командой. CX Codex +1 13 600установок typescript-quality claude-dev-suite Скилл typescript-quality для Claude Code: настраивает ESLint, Biome и строгий tsconfig для TypeScript и JavaScript. Включается, когда в проекте расходятся типы и множатся правила линтера. CX Codex +1 1 100установок typescript-best-practices cursor Скилл typescript-best-practices задаёт агенту правила работы с типами в .ts и .tsx: дискриминированные объединения, брендированные типы, проверка на границах. CX Codex +1 11 200установок

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

Весь набор →
0-folder-size Правило 0-folder-size следит, чтобы в каталоге было не больше десяти прямых .ts-файлов. Оно помогает заметить дублирование хелперов до дальнейшего разрастания структуры. CX Codex +1 ★ 571звёзд репо rule.generated Правило rule.generated требует добавлять комментарий «// Team reviewed domain change» над каждой новой экспортируемой функцией в папке src/domain/. Помогает отследить, какие изменения домена прошли ревью команды. CX Codex +1 ★ 571звёзд репо 0-orchestration Правило 0-orchestration задаёт границы для оркестраторов в TypeScript: одна зависимость на каждую затронутую область и не больше четырёх других сценариев использования. CX Codex +1 ★ 571звёзд репо 1-comments Правило 1-comments для ИИ-агента: писать комментарий только там, где молчат код и имена, и не ссылаться на тикеты, PR и даты. CX Codex +1 ★ 571звёзд репо 01-ticket-info Скилл 01-ticket-info находит задачу в настроенном трекере и выводит её поля прямо в диалог с ассистентом. CX Codex +1 ★ 571звёзд репо 0-shared-modules Правило 0-shared-modules помогает решить, когда модуль действительно пора выносить в shared/. Оно пригодится при разборе структуры src/contexts/ и перемещении кода между областями приложения. CX Codex +1 ★ 571звёзд репо 01-hello Скилл 01-hello для Claude Code запускает действие greet и подтверждает, что плагин aidd-ui загружен. Он проверяет доступность плагина. CX Codex +1 ★ 571звёзд репо 7-auth Правило 7-auth задаёт правила чтения и сохранения токенов в коде: ленивый поиск GitHub-токена, жёсткие права на файлы и обработку ошибок авторизации. CX Codex +1 ★ 571звёзд репо

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

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