# error-handling-recovery

Правило error-handling-recovery для Claude Code обрабатывает потерю WebGL-контекста, пересоздаёт ресурсы и показывает запасной интерфейс в Three.js-сценах.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 4719 у репозитория
- Автор: zebbern
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/error-handling-recovery.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/error-handling-recovery

## Что делает

Правило задаёт обработку событий `webglcontextlost` и `webglcontextrestored`: останавливает цикл рендера, показывает сообщение о восстановлении, затем заново инициализирует сцену, материалы и текстуры. Ресурсы можно регистрировать в `SceneManager`, помечать для пересоздания и восстанавливать после возврата контекста.

Внутри также есть шаблон React Error Boundary для перехвата ошибок Three.js, логирование параметров GPU и WebGL, контроль числа геометрий и текстур. Для тестов используется расширение `WEBGL_lose_context`; предусмотрен переход от WebGPU к WebGL2, WebGL1 и статическому изображению.

Правило советует хранить состояние сцены, иначе ресурсы после восстановления не из чего пересоздавать. В обработчиках учитываются утечки памяти, перегрузка GPU, переключение вкладок и сбои драйвера.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/rules/error-handling-recovery.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/error-handling-recovery.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/error-handling-recovery.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/error-handling-recovery.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/error-handling-recovery.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/zebbern/claude-code-guide/tree/HEAD/skills/three-best-practices/rules/error-handling-recovery.md

## Когда брать
- обработать потерю WebGL-контекста
- пересоздать материалы и текстуры после восстановления
- показать пользователю сообщение об ошибке 3D-сцены
- проверить утечки по числу геометрий и текстур
- добавить запасной рендерер или статичное изображение

## Примеры запросов агенту
- Добавь обработку потери WebGL-контекста в Three.js-сцену.
- Сделай восстановление ресурсов после события `webglcontextrestored`.
- Проверь обработку сбоя 3D-сцены через `WEBGL_lose_context`.

## Похожие
- [correctness-and-error-handling](https://affpapa.org/nevibecode/skills/correctness-and-error-handling.md) — скилл · 1900 установок
- [langgraph-error-handling](https://affpapa.org/nevibecode/skills/langgraph-error-handling.md) — скилл · ★ 106 у репозитория
- [react-error-handling](https://affpapa.org/nevibecode/skills/react-error-handling.md) — скилл · 134 установки
- [golang-error-handling](https://affpapa.org/nevibecode/skills/golang-error-handling.md) — скилл · 46400 установок
- [error-handling-ux](https://affpapa.org/nevibecode/skills/error-handling-ux.md) — скилл · 2600 установок
- [error-recovery-reviewer](https://affpapa.org/nevibecode/skills/error-recovery-reviewer.md) — скилл · ★ 529 у репозитория

Из того же набора: [zebbern/claude-code-guide](https://affpapa.org/nevibecode/by/zebbern/claude-code-guide.md) — 86 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
