| name | stop-rudder-dev-maintainer |
| description | Use when the user explicitly asks to stop, restart, kill, or clean Rudder repo-local pnpm dev processes or local dev runtime residue, including “把 pnpm dev 停了”, “重启 dev”, or “清掉 dev 残留”. |
Stop Rudder Dev Maintainer
Keep Rudder local dev runtime maintenance tight and safe.
The job is usually simple:
- identify the current Rudder dev runtime processes
- stop them gracefully
- confirm whether anything was actually running
Do not broaden that into generic process cleanup for the whole machine.
Port ownership alone is never sufficient evidence that a process belongs to
this checkout.
Fast Applicability Check
Before doing any process or port investigation, classify the user's current
task:
- Use the full workflow when the task is about the repo-local development
runtime, such as stopping or restarting
pnpm dev.
- If the task is mainly about production/local-prod data, packaged Desktop,
organizations, database cleanup, backups, migrations, or API maintenance,
this skill is not the main workflow. Do not spend time inspecting broad
process lists for those tasks.
- If the user explicitly included this skill as a safety preflight for a
non-dev task, run only the bundled script once, report whether it found a
pnpm dev runtime, and move on.
Packaged Desktop, pnpm prod, pnpm rudder run, and embedded Postgres owned by
/Applications/Rudder.app are out of scope. Leave them running unless the user
explicitly asks to stop the production/local-prod runtime.
If the bundled script cannot prove that a process is a dev entrypoint for the
current checkout, leave it running. Do not compensate with a manual kill
based on a port, process name, or repo working directory alone.
Scope
This skill is only for the current Rudder checkout.
It is designed around the repo-root development flow:
pnpm dev
That flow launches scripts/dev-shell.mjs, which in turn manages the local dev runner and desktop shell.
The dev shell must discard any inherited prod_local runtime identity before
startup, and the dev runner must refuse to take over a runtime owned by
Desktop, CLI, or a standalone server. If either invariant fails, stop and fix
the startup path; do not use this skill's stop script as a workaround.
The dev runner must also refuse to start against the protected prod_local /
default target even when no production runtime is currently healthy.
Default Workflow
1. Use the bundled script first
From the repo root:
bash .agents/skills/maintainer/stop-rudder-dev-maintainer/scripts/stop_rudder_dev.sh
Preview only:
bash .agents/skills/maintainer/stop-rudder-dev-maintainer/scripts/stop_rudder_dev.sh --dry-run
If the script prints No matching Rudder dev processes found., stop the skill
workflow there unless the user's request is specifically to diagnose why dev is
still running. Do not follow with broad ps, lsof, or app-process searches
just because another Rudder process exists.
2. What the script should target
The script is allowed to stop only repo-local Rudder dev processes such as:
- the root
pnpm dev / scripts/dev-shell.mjs process
scripts/dev-runner.mjs- the desktop dev Electron process for this repo
- repo-local Rudder dev helper processes that belong to the same runtime
It must not kill unrelated pnpm, node, vite, or Electron work from other repos.
It must not stop packaged Desktop or local production runtime processes.
It targets verified dev entrypoints and lets their graceful shutdown handlers
stop owned children; it does not recursively signal every descendant PID.
3. Verification
After stopping processes, verify with focused checks:
bash .agents/skills/maintainer/stop-rudder-dev-maintainer/scripts/stop_rudder_dev.sh --dry-run
Use the verification to distinguish these cases clearly:
- nothing was running
- Rudder dev was running and is now stopped
- some targeted processes survived graceful shutdown
Run these verification checks after the script stops something or reports
survivors. For a simple "nothing was running" result, the script output is
enough unless the user asked for a deeper diagnosis.
lsof may be used as read-only diagnostic context, but never turn a listener
PID into a stop target unless the bundled script independently verifies it as
the current checkout's dev entrypoint.
Escalation Rules
- Prefer graceful shutdown with
SIGTERM.
- If the bundled script reports survivors, show the exact survivors before using a hard kill.
- Use
--force only when the user explicitly wants a hard stop or when graceful shutdown already failed and the user still wants everything down.
- Never use
pkill pnpm, killall node, or similarly broad commands.
Restart Requests
If the user asks to restart dev:
- stop the current Rudder dev runtime with the bundled script
- verify that the old runtime is gone
- start the requested dev command
- report the new process state
Do not assume restart means "kill every local development process".
Report Format
Reply briefly with:
- whether a running Rudder dev runtime was found
- which process groups were stopped
- whether anything survived graceful shutdown
Example:
已停止当前 Rudder `pnpm dev` 运行时。
关闭了 `scripts/dev-shell.mjs` 和其子进程，`3100` 端口当前没有监听。
