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

0-error-handling — правило для Claude Code: ошибки и установка

Правило 0-error-handling задаёт единый путь обработки ошибок в TypeScript-коде: исключение поднимается до командного слоя и ловится там.

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

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

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

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

Все правила IDE по теме «Бэкенд и API» →
error-handling affaan-m Скилл error-handling задаёт единые правила обработки ошибок в TypeScript, Python и Go: типизированные исключения, ретраи, circuit breaker, тексты для пользователя. CX Codex +1 6 600установок run-relevant-tests-after-adding-error-handling-wrappers ZaxbyHub Скилл run-relevant-tests-after-adding-error-handling-wrappers для Claude Code напоминает запускать подходящие тесты после добавления обработки ошибок и проверять прежний результат успешного вызова. CX Codex +1 ★ 539звёзд репо golang-error-handling samber Скилл golang-error-handling помогает идиоматично обрабатывать ошибки в Go. Включается при создании, оборачивании, проверке цепочек и логировании ошибок. CX Codex +1 46 400установок correctness-and-error-handling cognitedata Скилл correctness-and-error-handling находит и устраняет сбои в React-коде Cognite Flows: монтирует Error Boundary, обрабатывает промисы и закрывает пустые состояния интерфейса. CX Codex +1 1 900установок error-handling-standardizer patricio0312rev Скилл error-handling-standardizer помогает привести ошибки приложения к общей схеме: от собственных классов до HTTP-ответов и структурированных логов. Пригодится при пересмотре обработки исключений в API. CX Codex +1 269установок error-handling-patterns curiositech Скилл error-handling-patterns для Claude Code проектирует обработку ошибок в TypeScript и Python: помогает выбрать между исключениями и Result-типами и построить recovery-флоу. CX Codex +1 140установок

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

Весь набор →
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звёзд репо 00-onboard Скилл 00-onboard ведёт проект по маршруту AIDD: сканирует репозиторий, решает, какой шаг следующий, показывает экран и выполняет ваш ответ. CX Codex +1 ★ 571звёзд репо 04-skill-generate Скилл 04-skill-generate для Claude Code создаёт маршрутизируемые скиллы для ИИ-инструментов проекта по этапам планирования и валидации. Превращает рабочий процесс в скилл или переписывает существующий. CX Codex +1 ★ 571звёзд репо 03-context-generate Скилл 03-context-generate направляет запрос на создание скилла, правила, субагента, команды или хука к нужному генератору. Если тип не назван, он уточнит его. CX Codex +1 ★ 571звёзд репо 04-spec Скилл 04-spec собирает spec.md — контракт одной фичи — из запроса, PRD или замечаний ревью. Или переписывает готовую спеку под найденные проблемы. CX Codex +1 ★ 571звёзд репо

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

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