--- name: Electrobun Plugin Guide description: The master index for the electrobun-dev Claude Code plugin. Use when starting a new Electrobun project, unsure which skill or command to use, wanting a full overview of what the plugin provides, or onboarding to the plugin ecosystem. Lists all 15 skills, 13 commands, and 11 agents with when-to-use guidance and decision trees. version: 1.0.0 --- # 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 │ ├─ Add a quick feature to an existing view │ └─ /electrobun-feature │ ├─ 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-`. ### 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 ` | Quick 2-agent build: UI agent → RPC Contract Handoff → backend agent | | `/electrobun-sdlc ` | 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` |