3-cli-process — правило для Claude Code: процесс CLI и коды выхода
Правило 3-cli-process описывает, как CLI завершает работу, что попадает в stdout и stderr и какие коды выхода отдаёт.
MIT ★ 571 обновлён 2026-10-29
.claude/rules/3-cli-process.mdЧто делает 3-cli-process
Правило про процесс CLI: как команда завершается, куда пишет и с каким кодом выходит. Привязано к src/cli.ts и src/presentation/**/*.ts, поэтому в остальных файлах не мешает.
Завершение — главная часть. Запустить и забыть нельзя: unref() и висящие промисы умирают вместе с процессом. Отложенная работа идёт через online-команду (ONLINE_COMMAND_PATHS в cli.ts), ждёт за таймаутом или уходит в detached. Горячий путь остаётся офлайн: прочитать кэш, напечатать, вернуть. Побочный эффект проверяют на собранном бинаре через e2e или pnpm smoke.
stdout отдаёт информацию, успех и результаты, stderr берёт отладку, предупреждения и ошибки. Конфликт или пропуск помечают как warn, не error. Разметкой по уровню занимается CLIOutput, рендер живёт в presentation/display/, решение остаётся за use case. Кодов выхода два: 0 значит «сделано», 1 приходит из исключения, больного doctor или guard, которому нужен TTY. В contexts/, kernel/ и runtime/ нет вызовов process.exit, и следит за этим плагин biome-plugins/no-process-exit.grit — снимите его, и ограничение останется на ревью.
Какие задачи решает
- Развести вывод команды между
stdoutиstderr - Не дать фоновой работе умереть при завершении процесса
- Назначить код выхода для доменной ошибки
- Убрать
process.exitизcontexts/,kernel/иruntime/ - Проверить побочный эффект на собранном бинаре
Примеры запросов агенту
- Добавь команду
syncвsrc/cli.tsи разведи её вывод по правилу3-cli-process - Проверь
src/cli.tsна висящие промисы иunref()без ожидания - Почему команда вышла с кодом 1? Разбери обработку ошибок по
3-cli-process
Как установить 3-cli-process
Вручную: положить файлы
.claude/rules/3-cli-process.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/3-cli-process.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/3-cli-process.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/3-cli-process.mdВручную: положить файлы
.clinerules/3-cli-process.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о 3-cli-process
Как установить 3-cli-process в Claude Code?
Скопировать файл правила в проект по пути .claude/rules/3-cli-process.md.
Что делает 3-cli-process?
Задаёт правила для CLI-процесса: завершение, каналы вывода, форматирование и коды выхода.
С какими редакторами работает 3-cli-process?
Тот же текст раскладывается как .cursor/rules/3-cli-process.mdc для Cursor и .github/instructions/3-cli-process.instructions.md для GitHub Copilot.
Исходный текст
3-cli-process.md · MIT
--- description: Apply to the process, its channels and its exit codes; the CLI exits when the action resolves. paths: - "src/cli.ts" - "src/presentation/**/*.ts" --- # The CLI Process ## Exit - Never fire and forget: `unref()` and floating promises die with the process. - Deferred work rides an online command (`ONLINE_COMMAND_PATHS` in `cli.ts`), awaits behind a timeout, or runs detached. - The hot path is offline: read cache, print, return. - Assert a side effect against the built binary (e2e or `pnpm smoke`). ## Channels - `stdout`: info, success, results. - `stderr`: debug, warnings, errors. - A conflict or skip is `warn`, never `error`. - One-line final summary. ## Formatting - `CLIOutput` routes by level, nothing else. - Rendering: `presentation/display/`. Deciding: the use case. ## Exit codes - `0`: did what was asked. - `1`: thrown error, unhealthy `doctor`, guard needing a TTY. - `errorHandler.handle` alone turns a domain failure into a code. - A command may exit on a pre-use-case refusal: missing flag, non-interactive guard. - Nothing under `contexts/`, `kernel/`, `runtime/` calls `process.exit` (`biome-plugins/no-process-exit.grit`).
© ai-driven-dev · MIT · ai-driven-dev/framework