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

3-cli-process — правило для Claude Code: процесс CLI и коды выхода

Правило 3-cli-process описывает, как CLI завершает работу, что попадает в stdout и stderr и какие коды выхода отдаёт.

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

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

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

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

Все правила IDE по теме «Бэкенд и API» →
aa/cli taste ahmadawais Промпт aa/cli taste для ChatGPT задаёт набор предпочтений при разработке CLI-проектов. Он предлагает стек, структуру команд и правила для интерфейса терминала. GP ChatGPT ★ 178 201звёзд репо ultracite haydenbleasel Скилл ultracite настраивает линтинг и форматирование JS/TS-проектов через Oxlint, Biome или ESLint одной командой. CX Codex +1 13 600установок typescript-quality claude-dev-suite Скилл typescript-quality для Claude Code: настраивает ESLint, Biome и строгий tsconfig для TypeScript и JavaScript. Включается, когда в проекте расходятся типы и множатся правила линтера. CX Codex +1 1 100установок migrate-to-deno denoland Скилл migrate-to-deno помогает перевести проект с Node.js, npm, Yarn, pnpm или Bun на Deno 2.9+. Объясняет пошаговую миграцию через сохранение package.json и постепенную настройку разрешений. CX Codex +1 125установок TypeScript Library taste f TypeScript Library taste — промпт для ChatGPT, который задаёт правила сборки и публикации TypeScript-библиотеки. Он помогает выбрать инструменты для тестов, типов и версионирования. GP ChatGPT ★ 178 201звёзд репо typescript-scaffold Seth Hobson Команда typescript-scaffold создаёт структуру TypeScript-проекта на pnpm: Next.js, React с Vite, Node.js API или библиотеку, вместе с тестами и сборкой. CX Codex +1 ★ 42 780звёзд репо

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

Весь набор →
10-learn Скилл 10-learn для Claude Code, Cursor и других платформ, который помогает записывать и формализовать решения, соглашения, уроки и находки из кода. CX Codex +1 ★ 571звёзд репо 10-task Скилл 10-task для Claude Code проводит ограниченную задачу бэклога через описание, проверку и запись. Оформляет, связывает, оценивает или закрывает задачи. CX Codex +1 ★ 571звёзд репо 05-review Скилл 05-review проводит статическое код-ревью дифа или плана перед отправкой изменений в репозиторий и выносит вердикт. CX Codex +1 ★ 571звёзд репо 01-brainstorm Скилл 01-brainstorm помогает прояснить сырую идею вопросами и оформить её в краткий бриф. Запускайте его, когда запрос расплывчатый или хочется вместе обдумать варианты. CX Codex +1 ★ 571звёзд репо 02-project-memory Скилл 02-project-memory сканирует архитектуру и договорённости репозитория, формирует базу контекста и подключает её к инструментам ИИ. Помогает при первом запуске или аудите расхождений. CX Codex +1 ★ 571звёзд репо 07-epic Скилл 07-epic помогает оформить или пересмотреть Epic для продуктового бэклога. Запускайте его, когда нужно описать ожидаемый результат, проверить готовность или сохранить Epic. CX Codex +1 ★ 571звёзд репо 09-defect Скилл 09-defect ведёт дефект от замеченного расхождения в продукте до записи в бэклог: сбор, оценка, финализация. CX Codex +1 ★ 571звёзд репо 06-agent-generate Скилл 06-agent-generate генерирует конфигурации агентов и субагентов под форматы поддерживаемых ИИ-инструментов проекта по описанию роли. CX Codex +1 ★ 571звёзд репо

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

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