electrobun-dev Plugin Guide
Complete reference for the electrobun-dev Claude Code plugin. All resources are available via the
Skill
tool (skills), slash commands (commands), or agent dispatch (agents).
Quick Start Decision Tree
What do I want to do?
│
├─ Start a brand-new Electrobun app
│ └─ /electrobun-init → then /electrobun-setup
│
├─ Build a complete new feature (with tests + docs)
│ └─ /electrobun-sdlc <feature description>
│
├─ Add a quick feature to an existing view
│ └─ /electrobun-feature <description>
│
├─ Wire up RPC between bun and renderer
│ └─ /electrobun-rpc
│
├─ Add a new window or manage windows
│ └─ /electrobun-window
│
├─ Add application menus or tray
│ └─ /electrobun-menu
│
├─ Add WebGPU / GPU rendering
│ └─ /electrobun-wgpu
│
├─ Run or write tests
│ └─ /electrobun-test
│
├─ Build and package the app
│ └─ /electrobun-build
│
├─ Publish a release and set up updates
│ └─ /electrobun-release
│
├─ Check where I am in the pipeline
│ └─ /electrobun-workflow
│
├─ Align an existing project with plugin standards
│ └─ /electrobun-align
│
├─ Something is broken / debugging
│ └─ electrobun-debugger agent
│
└─ Understand what the plugin provides
└─ (you're already here)
Skills Reference (15 skills)
Skills are invoked via the
Skill
tool. They load context and rules for a domain.
Foundation
| Skill | Load When |
|---|
electrobun
| Any Electrobun project work — BrowserWindow, BrowserView, events, app lifecycle, menus, tray |
electrobun-config
| Editing electrobun.config.ts
or looking up any config field |
electrobun-rpc
| Wiring RPC between bun process and renderer |
electrobun-platform
| Building for multiple OS targets, platform-specific behavior, artifact naming |
Development Lifecycle
| Skill | Load When |
|---|
electrobun-init
| Scaffolding a new project, choosing a template |
electrobun-dev
| Running dev server, hot reload, opening devtools |
electrobun-workflow
| Checking pipeline status, understanding the INIT→DEV→BUILD→RELEASE flow |
electrobun-build
| Building for distribution, code signing, CI/CD matrix |
electrobun-release
| Publishing releases, auto-update configuration, Updater API |
Specialized
| Skill | Load When |
|---|
electrobun-webgpu
| Native GPU rendering, WGSL shaders, Dawn, WGPU buffer management |
electrobun-testing
| Writing defineTest()
test cases, Kitchen Sink test framework |
electrobun-kitchen-sink
| Working with the Kitchen Sink reference app, UI map, test automation |
Agent Orchestration
| Skill | Load When |
|---|
electrobun-sdlc
| Running the full 8-stage SDLC pipeline, understanding stage handoffs |
electrobun-teams
| Using CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
, orchestrating UI + backend agents |
Integration
| Skill | Load When |
|---|
electrobun-milady
| Submitting PRs to milady-ai/milady, understanding trust scoring + review system |
Commands Reference (13 commands)
Commands are slash commands invoked as
/electrobun-<name>
.
Project Lifecycle
| Command | What it does |
|---|
/electrobun-init
| Interactive template picker (19 templates) → scaffolds new project |
/electrobun-setup
| Run after init — creates CI/CD, test scaffold, docs, CLAUDE.md, gitignore, release workflow for a production-ready project |
/electrobun-workflow
| Shows pipeline status: which stage you're in, what's done, what's next |
Feature Development
| Command | What it does |
|---|
/electrobun-feature <desc>
| Quick 2-agent build: UI agent → RPC Contract Handoff → backend agent |
/electrobun-sdlc <desc>
| Full 8-stage pipeline: researcher → architect → planner → dev squad → QA → tests → alignment → docs |
/electrobun-rpc
| RPC setup wizard: schema authoring, handler wiring, shared type file |
/electrobun-window
| Window creation wizard: BrowserWindow options, sizing, positioning, title bar |
/electrobun-menu
| Application menu / context menu / tray menu builder |
/electrobun-wgpu
| WebGPU feature builder: shader setup, render loop, buffer management |
Quality & Testing
| Command | What it does |
|---|
/electrobun-test
| 5-option menu: run by name, run all automated, write new test, manifest ops, coverage |
/electrobun-align
| Alignment wizard for existing projects: scans, backs up, prompts per change, repairs drift |
Release
| Command | What it does |
|---|
/electrobun-build
| Guided build: env picker, signing prereqs, version confirm, artifact summary |
/electrobun-release
| Full release: version bump, signing check, channel select, build, upload, verify |
Agents Reference (11 agents)
Agents are dispatched by commands or orchestrators — not invoked directly by users.
SDLC Pipeline Agents (Stages 1–8)
| Stage | Agent | Role |
|---|
| 1 | electrobun-researcher
| Codebase scan, API surface mapping, risk identification |
| 2 | electrobun-architect
| Architecture spec, blast radius analysis, RPC flow, config skeleton |
| 3 | electrobun-planner
| Atomic TDD task plans, agent assignments, sanity checks |
| 4a | electrobun-ui-agent
| Renderer files, HTML/CSS, Electroview RPC, produces RPC Contract Handoff |
| 4b | electrobun-backend-agent
| Bun-side wiring, BrowserView.defineRPC, config updates |
| 5 | electrobun-qa-engineer
| Spec compliance audit, blast radius check, BLOCKER/IMPORTANT/MINOR report |
| 6 | electrobun-test-writer
| Golden-outcome tests (Kitchen Sink defineTest or vitest) |
| 7 | electrobun-alignment-agent
| Fix QA findings in priority order, cleanup, blast radius correction |
| 8 | electrobun-docs-agent
| Mintlify docs, regression tests, mark plan COMPLETE |
Specialist Agents
| Agent | Use When |
|---|
electrobun-debugger
| Something is broken — build failure, RPC timeout, blank window, GPU crash |
electrobun-kitchen-agent
| Automating Kitchen Sink tests, reading UI map, running test suites |
Plugin File Layout
~/.claude/plugins/electrobun-dev/
├── skills/
│ ├── electrobun/ ← Core patterns
│ ├── electrobun-build/ ← Build system + CI/CD
│ ├── electrobun-config/ ← Config reference
│ ├── electrobun-dev/ ← Dev server
│ ├── electrobun-guide/ ← This file (master index)
│ ├── electrobun-init/ ← Templates
│ ├── electrobun-kitchen-sink/ ← Kitchen Sink reference
│ ├── electrobun-milady/ ← milady integration
│ ├── electrobun-platform/ ← Cross-platform
│ ├── electrobun-release/ ← Release + Updater
│ ├── electrobun-rpc/ ← RPC system
│ ├── electrobun-sdlc/ ← 8-stage pipeline
│ ├── electrobun-teams/ ← Agent teams
│ ├── electrobun-testing/ ← defineTest framework
│ ├── electrobun-webgpu/ ← GPU rendering
│ └── electrobun-workflow/ ← Pipeline map
├── commands/
│ ├── electrobun-align.md ← Alignment wizard
│ ├── electrobun-build.md ← Build wizard
│ ├── electrobun-feature.md ← Quick 2-agent feature
│ ├── electrobun-init.md ← Template picker
│ ├── electrobun-menu.md ← Menu builder
│ ├── electrobun-release.md ← Release wizard
│ ├── electrobun-rpc.md ← RPC wizard
│ ├── electrobun-sdlc.md ← Full SDLC
│ ├── electrobun-setup.md ← Project setup
│ ├── electrobun-test.md ← Test runner
│ ├── electrobun-wgpu.md ← WebGPU builder
│ ├── electrobun-window.md ← Window wizard
│ └── electrobun-workflow.md ← Pipeline status
└── agents/
├── electrobun-alignment-agent.md
├── electrobun-architect.md
├── electrobun-backend-agent.md
├── electrobun-debugger.md
├── electrobun-docs-agent.md
├── electrobun-kitchen-agent.md
├── electrobun-planner.md
├── electrobun-qa-engineer.md
├── electrobun-researcher.md
├── electrobun-test-writer.md
└── electrobun-ui-agent.md
Workflow Map
NEW PROJECT
/electrobun-init → Pick template, scaffold
/electrobun-setup → CI/CD, docs, tests, CLAUDE.md
DEVELOPMENT
/electrobun-dev → Run dev server
/electrobun-feature → Quick feature (2-agent)
/electrobun-sdlc → Full feature (8-stage)
/electrobun-rpc → Wire RPC
/electrobun-window → Add window
/electrobun-menu → Add menus
/electrobun-wgpu → Add GPU rendering
QUALITY
/electrobun-test → Run/write tests
/electrobun-align → Repair drift
BUILD & RELEASE
/electrobun-build → Package for distribution
/electrobun-release → Publish + update server
STATUS CHECK
/electrobun-workflow → Where am I in the pipeline?
Common Skill Combinations
| Goal | Load These Skills |
|---|
| "I'm starting a new feature" | electrobun
+ electrobun-rpc
|
| "I'm setting up builds" | electrobun-build
+ electrobun-config
|
| "I'm releasing" | electrobun-release
+ electrobun-platform
|
| "I'm debugging" | electrobun
+ electrobun-debugger
agent |
| "I'm writing tests" | electrobun-testing
+ electrobun-kitchen-sink
|
| "I'm building GPU features" | electrobun-webgpu
+ electrobun-config
|
| "I'm contributing to milady" | electrobun-milady
+ electrobun-sdlc
|
| "I'm setting up CI/CD" | electrobun-build
+ electrobun-release
+ electrobun-platform
|
