# engineering-conventions

Скилл engineering-conventions задаёт обязательные инженерные инварианты для доработки opencode-swarm. Помогает избежать зависаний инициализации, утечек тестовых моков и поломок совместимости с Node ESM.

- скилл · `type=skill` · Claude Code, Codex, OpenCode, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 539 у репозитория
- Автор: ZaxbyHub
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.opencode/skills/engineering-conventions/SKILL.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/engineering-conventions

## Что делает

Скилл служит кратким руководством по ключевым правилам разработки и ссылается на первоисточники `AGENTS.md` и `docs/engineering-invariants.md`. Агент подключает его перед правкой опасных участков: точки входа `src/index.ts`, хуков, регистрации инструментов, изоляции подпроцессов и сохранения состояния сессий.

Основной упор сделан на четыре критических инварианта. Инициализация плагина обязана быть ограниченной по времени через `withTimeout` и деградировать без фатального сбоя. Вызовы подпроцессов через `bunSpawn` требуют явного таймаута и вызова `proc.kill()` в блоке `finally`. Сборка `dist/index.js` должна оставаться совместимой с Node ESM без прямых импортов `bun:`, а моки в тестах Bun изолируются через паттерны `_test_exports` и `_internals`.

Без переменной окружения `SWARM_ALLOW_FULL_SUITE=1` запуск тестов со `scope: 'all'` через инструмент `test_runner` заблокирован, поэтому проверять весь репозиторий нужно внешними скриптами изоляции.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/engineering-conventions/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/engineering-conventions/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/engineering-conventions/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/engineering-conventions/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ZaxbyHub/opencode-swarm .opencode/skills/engineering-conventions
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/engineering-conventions/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ZaxbyHub/opencode-swarm --path .opencode/skills/engineering-conventions
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/engineering-conventions/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ZaxbyHub/opencode-swarm --skill engineering-conventions -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ZaxbyHub/opencode-swarm/tree/HEAD/.opencode/skills/engineering-conventions/SKILL.md

## Когда брать
- изолировать моки Bun при тестировании без утечек между файлами
- предотвратить зависание инициализации плагина с помощью `withTimeout`
- настроить безопасный вызов подпроцессов через `bunSpawn` с принудительным `proc.kill()`
- сохранить совместимость `dist/index.js` с Node ESM без прямых импортов `bun:`

## Примеры запросов агенту
- Проверь `src/index.ts` по правилам `engineering-conventions` перед изменением инициализации
- Загрузи скилл `engineering-conventions` и настрой вызов дочернего процесса в `src/utils/bun-compat.ts`
- Отрефактори моки в тестах согласно инвариантам `engineering-conventions`

## Похожие
- [nestjs-professional-software-engineering](https://affpapa.org/nevibecode/skills/nestjs-professional-software-engineering.md) — скилл · 556 установок
- [1-conventions](https://affpapa.org/nevibecode/rules/1-conventions.md) — правило · ★ 571 у репозитория
- [phase-10i-transcript-recovery-final-re-review](https://affpapa.org/nevibecode/prompts/phase-10i-transcript-recovery-final-re-review.md) — промпт · ★ 1497 у репозитория
- [writing-dev-server-tests](https://affpapa.org/nevibecode/skills/writing-dev-server-tests.md) — скилл · 1 установка
- [bun-runtime](https://affpapa.org/nevibecode/skills/bun-runtime.md) — скилл · 6500 установок
- [bun-development](https://affpapa.org/nevibecode/skills/bun-development.md) — скилл · 2900 установок

## Другие версии с тем же именем
- [engineering-conventions · zaxbyhub](https://affpapa.org/nevibecode/skills/zaxbyhub-engineering-conventions.md) — ★ 539 у репозитория

Из того же набора: [zaxbyhub/opencode-swarm](https://affpapa.org/nevibecode/by/zaxbyhub/opencode-swarm.md) — 121 карточка

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

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