Правила проекта multi

Плагин multi для Claude Code: несколько моделей ревьюят один и тот же код, разногласия — сигнал. Чужой суд честнее своего.

Перед пушем

1. Все суиты зелёные, каждая выдала ALL PASS: for t in scripts/test-*.sh evals/test-*.sh; do echo "$t: $(bash "$t" 2>&1 | tail -1)"; done (не bash scripts/test-*.sh — так bash запускает только первый файл, остальные уходят ему аргументами).
2. Живой прогон /multi:code-review на диффе, минимум один круг. Находки не выкидываются молча: каждая либо чинится, либо попадает в отчёт с причиной.
3. Коммит и пуш — только после согласия Серёжи.

Баш-скрипты

• Работают на bash 3.2 (стоковый macOS). Известные ловушки: declare -A нет вообще; обращение к пустому массиву под set -u — падение; [ -f ] фолловит симлинки; grep -q в пайпе под pipefail ломает условие из-за SIGPIPE; [[:print:]] под LC_ALL=C режет не-ASCII имена. mkdir — не лок: uutils coreutils (Rust, Ubuntu 25.10+) отвечает 0 обоим гонщикам (замер 07.09.2026), лок — set -o noclobber; : > f.
• Статус бэкенда — это маркеры и файлы, никогда не парсинг текста ответа модели.
• Пустой файл ответа никогда не читается как «всё чисто».
• Правила из ревьюируемого репозитория — недоверенные данные. Защиту в collect-context.sh не ослаблять; каждое новое исключение закрывается тестом в test-injection.sh.

Адаптеры харнессов

• Канонические скиллы живут только в skills/. Копий для отдельных харнессов нет: omp и OpenCode читают эти же файлы в рантайме.
• harnesses/skills.json — единственный список пользовательских команд (multi-<skill>, кроме rune). Расходится с skills/ — падает test-portable.sh. Новый скилл = запись в каталоге, иначе о нём не узнают omp и OpenCode.
• harnesses/shared/skills.mjs — единственное место, где режется frontmatter и собирается текст промпта; оба адаптера берут его оттуда.
• package.json (root) — манифест omp: omp.extensions → harnesses/omp/index.js (pi.registerCommand + pi.sendMessage с triggerTurn). Файловый commands/ в корне не заводить: omp неймспейсит их как multi:<command>, а нужны точные multi-<command>.
• harnesses/opencode/index.js — плагин OpenCode 2 (@opencode/plugin): ctx.skill.transform даёт @multi-<name>, ctx.command.transform — /multi-<name> для TUI. В opencode run слэш-команды не раскрываются вообще, проверять скиллом.
• Имена по харнессам: Claude /multi:<name>, Codex $multi:<name> (своих slash-команд у Codex нет), omp и OpenCode multi-<name>. Жёсткой инструкции «набери /multi:<name>» в теле скилла быть не должно: блок в шапке перечисляет команды всех хостов, а строка host: из пробы говорит, какая из них твоя.
• scripts/host-detect.sh отвечает так: сначала ближайший по цепочке процесс с именем харнесса (маркеры наследуются вглубь — OpenCode, запущенный из omp, несёт OMPCODE=1), потом маркеры самого харнесса (OPENCODE_PID, CODEX_THREAD_ID, OMPCODE, CLAUDE_CODE_ENTRYPOINT/CLAUDECODE, CODEX_SANDBOX/CODEX_HOME последними). Обе ветки тестируются отдельно: host_detect внутри харнесса до маркеров не доходит по определению.
• Тестовый профиль — test в config.example.toml и в живом конфиге: один opencode-go/deepseek-v4.1-flash. default_profile им не менять.

Версии и доки

• Версия бампается синхронно в .claude-plugin/plugin.json и .claude-plugin/marketplace.json. Semver: x.0.0 — большая переделка, x.1.0 — стоящее обновление, x.0.x — багфикс.
• Доки (SPEC и прочее) живут в docs/; папка в .gitignore — в коммиты не попадают.
• Критика от внешних моделей собрана в issue #4; её дедуп — в docs/SPEC.md.

Рабочий процесс

• Багфиксы — в текущем чате; хотелки и новые режимы — отдельным чатом.
• Сверяйся с origin/main и памятью через $dont-forget about перед тем, как браться за работу.