0-error-handling — правило для Claude Code: ошибки и установка
Правило 0-error-handling задаёт единый путь обработки ошибок в TypeScript-коде: исключение поднимается до командного слоя и ловится там.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/0-error-handling.mdЧто делает 0-error-handling
Правило применяется к файлам src/**/*.ts. Use case выбрасывает типизированное исключение и не перехватывает его сам, а также не возвращает ошибку как значение. Адаптер может перехватить ошибку только для типизации I/O-ошибки через kernel/errors.ts.
Единственный общий каталог ошибок — kernel/errors.ts: каждый класс из него должен где-то выбрасываться. Командный слой остаётся единственным местом перехвата: он вызывает errorHandler.handle(error) и завершает процесс с кодом 1. Пустой catch допустим лишь для явно перечисленного best effort или сбоя.
Сообщение об ошибке с названием команды считается контрактом: тест errors-that-instruct.arch.test.ts сверяет такую команду с CLI. Хук проверки обновлений — единственное намеренное подавление ошибки, поэтому остальные пустые catch будут поводом для проверки архитектурного теста.
Какие задачи решает
- передать ошибку из use case в командный слой
- типизировать I/O-ошибку в адаптере
- собрать единый каталог классов ошибок
- проверить, что ошибки из каталога действительно выбрасываются
- сверить команды из сообщений об ошибках с CLI
Примеры запросов агенту
- Проверь обработку ошибки в use case и убери локальный
catch. - Перенеси перехват ошибки в командный слой через
errorHandler.handle(error)с завершением1. - Проверь файлы
src/**/*.tsна пустыеcatchи ошибки внеkernel/errors.ts.
Как установить 0-error-handling
Вручную: положить файлы
.claude/rules/0-error-handling.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/0-error-handling.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/0-error-handling.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/0-error-handling.mdВручную: положить файлы
.clinerules/0-error-handling.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о 0-error-handling
Как установить 0-error-handling в Claude Code?
Добавьте правило в файл .claude/rules/0-error-handling.md.
Что делает 0-error-handling?
Правило заставляет use case передавать типизированную ошибку наружу, а командный слой ловит её один раз. Адаптеры перехватывают только I/O-ошибки, чтобы задать им тип.
Можно ли использовать пустой catch с этим правилом?
Только для явно перечисленного best effort или сбоя. Хук проверки обновлений — единственное намеренное подавление ошибки.
Исходный текст
0-error-handling.md · MIT
---
description: Apply when handling a failure; a typed exception travels inward and is caught once, at the command edge.
paths:
- "src/**/*.ts"
---
# Errors
## Flow
- A use case throws.
- It never catches its own errors.
- It never returns a failure as a value.
- An adapter catches only to type an I/O error (`kernel/errors.ts`).
- Never `catch {}` into a default: unreadable is not absent.
- An empty catch is a listed best effort or a failure (`catches-that-swallow.arch.test.ts`).
- The command layer is the only catcher: `errorHandler.handle(error)`, exit 1.
- The update-check hook is the one deliberate swallow.
## Catalog
- `kernel/errors.ts` is the one catalog.
- Every class in it is thrown (`errors-that-are-thrown.arch.test.ts`, empty baseline).
## Instructing
- A message naming a command is a contract.
- `errors-that-instruct.arch.test.ts` checks each named command against the CLI.
- Descriptive prose is not pinned.
© ai-driven-dev · MIT · ai-driven-dev/framework