| name | electron-debug |
| description | Debug Electron desktop issues across renderer, preload, main process, and Go app-server. |
| trigger-condition | Use for desktop crashes, stale IPC, app-server mismatches, or Electron dev restart problems. |
| allowed-tools | ["read_file","grep","glob","bash"] |
| required-context | ["desktop process state","changed main or preload files","app-server PID","failing IPC channel"] |
| examples | ["white screen after IPC change","stale go run cache","debug panel visibility"] |
| verification-checklist | ["correct process restarted","IPC handler exists","production debug controls remain hidden"] |
| progressive-disclosure | Inspect process state before assuming source changes reached the running desktop. |
Electron Debug
Debug the running stack, not only the source tree.
- Determine whether the bug is renderer, preload, main process, or app-server.
- Check for stale Electron main processes and stale
go run app-server binaries.
- Verify IPC channels are registered on both preload and main sides.
- Restart the full stack when main process code changed.
- Keep production debug UI gated behind debug controls.
When runtime behavior contradicts source, treat the live process as the ground truth.