embedded-workbench plugin
Your embedded firmware toolkit in Claude Code | Claude Code 嵌入式固件工具箱 — battle-tested on real Cortex-M projects.
How to install the embedded-workbench plugin
Run both commands inside Claude Code. The first adds the marketplace once; the second installs the plugin.
/plugin marketplace add AmethystLuna/embedded-workbench
/plugin install embedded-workbench@embedded-workbench-devWhat's inside embedded-workbench
13 parts read from the plugin's own files.
Agents 4
Call as @agent-embedded-workbench:name- @agent-embedded-workbench:architecture-stewardopus
Architecture planning, design packages, work breakdown, module ownership, state models, recovery paths, cross-module coordination.
- @agent-embedded-workbench:design-reviewersonnet
Design document reviewer — verifies every claim against codebase facts, checks mechanism feasibility, finds root causes of errors, and delivers structured findings by severity.
- @agent-embedded-workbench:execution-workersonnet
Concrete implementation, targeted code edit, focused investigation, test run, build run, narrow module task, delegated coding slice.
- @agent-embedded-workbench:quality-coordinatorsonnet
Code review, quality gates, implementation review, risk check, test coverage check, coordination between plan and execution, bug regression review.
Skills 8
Claude loads it when the task matches- c-cpp-dev
Use when writing, reviewing, or refactoring C/C++ code, especially on 32-bit ARM embedded targets. NOT for formatting-only changes, simple file reads, non-embedded C/C++ (desktop/server), or C#/Java despite the 'C' in the name.
- debug-methodology
Use when debugging embedded firmware issues — analyzing crash logs, investigating state machine lockups, tracing sensor/signal anomalies, or performing structured root-cause analysis after a crash has been located. For fault-register and stack-frame triage, load hardfault-triage first.
- embedded-firmware-dev
Use when writing or reviewing embedded C firmware, FreeRTOS tasks, ISR handlers, NVM/flash storage, or sensor driver state machines. NOT for documentation-only RTOS references, conceptual RTOS discussions, or bare-metal projects without an RTOS or sensor subsystem.
- embedded-workbench
Use when starting any non-trivial coding task — loads risk-proportional workflows, engineering policies, and principles for embedded C/C++ firmware development. NOT for trivial single-line fixes, formatting-only changes, or read-only queries.
- fact-check
Use when reviewing design documents, architecture specs, technical proposals, or plans that make claims about API names, file paths, enum values, counts, or mechanism feasibility — a lightweight claim-by-claim check against the codebase with evidence. Built into embedded-workbench as the fallback when the full dsh-model-everything plugin (or its predecessor logicprobe) is not installed. NOT for state machines, protocol/retry logic, or 'always'/'never' behavioral claims that need executable model verification — those require dsh-model-everything (or logicprobe).
- hardfault-triage
Use when triaging processor exception crashes — HardFault, MemManage, BusFault, UsageFault, data/prefetch abort, illegal instruction, or watchdog timeout. Covers fault-register interpretation, stack-frame extraction, PC-to-source resolution, and root-cause classification.
- keil-mdk-build
Use when building, flashing, or packaging firmware with Keil MDK (UV4 CLI, ARMCLANG), analyzing .map files for ROM/RAM optimization and memory budget, or diagnosing Keil-specific build failures. NOT for non-Keil build systems (Makefile, CMake, IAR, GCC-only). For crash triage see hardfault-triage.
- state-machine-design
Use when reviewing or fixing async protocols, retries, ACK/NACK handling, pending flags, timeout logic, or state-machine lockups in embedded firmware. NOT for generic network protocol design (TCP/HTTP/MQTT) unless targeting embedded firmware stack.
Hooks 1
Runs on these events- SessionStartcommand
startup|clear|compact
Using embedded-workbench in Claude Code
Ask for an agent by name:
@agent-embedded-workbench:architecture-steward
@agent-embedded-workbench:design-reviewerSkills need no command. Claude reads them when your request matches what they describe.
Update, turn off or remove
- Update the plugin (shell)
- claude plugin update embedded-workbench@embedded-workbench-dev
- Refresh the marketplace
- /plugin marketplace update embedded-workbench-dev
- Turn it off for now
- /plugin disable embedded-workbench@embedded-workbench-dev
- Remove it
- /plugin uninstall embedded-workbench@embedded-workbench-dev
Skills in embedded-workbench
- debug-methodologyAmethystLuna/embedded-workbench
Use when debugging embedded firmware issues — analyzing crash logs, investigating state machine lockups, tracing sensor/signal anomalies, or performing structured root-cause analysis after a crash has been located. For fault-register and stack-frame triage, load hardfault-triage first.
2 files32stars - embedded-firmware-devAmethystLuna/embedded-workbench
Use when writing or reviewing embedded C firmware, FreeRTOS tasks, ISR handlers, NVM/flash storage, or sensor driver state machines. NOT for documentation-only RTOS references, conceptual RTOS discussions, or bare-metal projects without an RTOS or sensor subsystem.
4 files32stars - embedded-workbenchAmethystLuna/embedded-workbench
Use when starting any non-trivial coding task — loads risk-proportional workflows, engineering policies, and principles for embedded C/C++ firmware development. NOT for trivial single-line fixes, formatting-only changes, or read-only queries.
14 files32stars - c-cpp-devAmethystLuna/embedded-workbench
Use when writing, reviewing, or refactoring C/C++ code, especially on 32-bit ARM embedded targets. NOT for formatting-only changes, simple file reads, non-embedded C/C++ (desktop/server), or C#/Java despite the 'C' in the name.
32stars - hardfault-triageAmethystLuna/embedded-workbench
Use when triaging processor exception crashes — HardFault, MemManage, BusFault, UsageFault, data/prefetch abort, illegal instruction, or watchdog timeout. Covers fault-register interpretation, stack-frame extraction, PC-to-source resolution, and root-cause classification.
32stars - keil-mdk-buildAmethystLuna/embedded-workbench
Use when building, flashing, or packaging firmware with Keil MDK (UV4 CLI, ARMCLANG), analyzing .map files for ROM/RAM optimization and memory budget, or diagnosing Keil-specific build failures. NOT for non-Keil build systems (Makefile, CMake, IAR, GCC-only). For crash triage see hardfault-triage.
32stars - state-machine-designAmethystLuna/embedded-workbench
Use when reviewing or fixing async protocols, retries, ACK/NACK handling, pending flags, timeout logic, or state-machine lockups in embedded firmware. NOT for generic network protocol design (TCP/HTTP/MQTT) unless targeting embedded firmware stack.
32stars - fact-checkAmethystLuna/embedded-workbench
Use when reviewing design documents, architecture specs, technical proposals, or plans that make claims about API names, file paths, enum values, counts, or mechanism feasibility — a lightweight claim-by-claim check against the codebase with evidence. Built into embedded-workbench as the fallback when the full dsh-model-everything plugin (or its predecessor logicprobe) is not installed. NOT for state machines, protocol/retry logic, or 'always'/'never' behavioral claims that need executable model verification — those require dsh-model-everything (or logicprobe).
32stars
embedded-workbench plugin questions
How do I install the embedded-workbench plugin?
In Claude Code run /plugin marketplace add AmethystLuna/embedded-workbench, then /plugin install embedded-workbench@embedded-workbench-dev.
What does the embedded-workbench plugin include?
embedded-workbench bundles 4 agents, 8 skills, hooks.
Which agents come with embedded-workbench?
architecture-steward, design-reviewer, execution-worker, quality-coordinator. Call one with @agent-embedded-workbench:architecture-steward.
How do I update or remove the embedded-workbench plugin?
Update it with claude plugin update embedded-workbench@embedded-workbench-dev in your shell, or from the Installed tab of /plugin. Remove it with /plugin uninstall embedded-workbench@embedded-workbench-dev.
What license is the embedded-workbench plugin under?
MIT, as stated in the plugin's manifest.