hardware-tdd

Q: How do I install hardware-tdd?

Run npx skills add https://github.com/wedsamuel1230/embedded-engineering-skills --skill hardware-tdd in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/hardware-tdd/ (personal) or .claude/skills/hardware-tdd/ (project).

by wedsamuel1230Testing & QA

Use when planning tests for Arduino, ESP32, ESP32-S3, Pico, or Pico W firmware; deciding what can run off-target; using Wokwi or simulation; writing host fakes; or accepting a physical hardware feature without confusing compile proof with system proof.

Installs: 63
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/wedsamuel1230/embedded-engineering-skills --skill hardware-tdd

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads hardware-tdd automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Hardware TDD

Build the test ladder before claiming a feature is complete. Pure behavior can often be tested off-target; voltage, pin mux, timing under load, and physical assembly still require target evidence.

Intake

Record exact board/revision, framework/toolchain, hardware invariants, safety inhibits, simulator model, available instruments, test fixtures, and the proof stage required by the user.

Process

Turn requirements into observable behavior and safety invariants.
Write host tests for pure C/C++ logic using fakes for time, serial, sensors, and actuators. Keep hardware adapters thin.
Use Wokwi or another simulator only for peripherals and timing that its model actually represents; record model limitations.
Run an exact-board compile and static checks with the selected toolchain.
Create a one-change target checklist: power-off continuity, controlled power-up, input observation, output inhibit, reset/recovery, and logs.
Ask a physical gate for measurements, photos, or serial output. Do not infer target success from a host test or compile log.
Record failures as evidence and keep the next test bounded.

Test matrix

Layer	Example	Proves	Does not prove
Host	debounce/state/packet parser	deterministic logic	pin voltage or wiring
Simulation	modeled sensor/LED/UART	modeled interactions	regulator, clone, EMI, thermal behavior
Build	exact FQBN/environment	source and dependency compile	upload or behavior
Target	serial, meter, scope, photo	observed hardware behavior	field reliability unless loaded
System	integrated load/failure case	requirement under scenario	future deployment safety

Anti-rationalization

Shortcut	Response
"The unit test passed."	Keep all physical and system stages open.
"Wokwi matches the board."	List what the model omits and verify those items on hardware.
"The sketch compiled."	Require upload identity and target observations separately.
"The photo proves it works."	Require board identity, measurement context, and observed result.
"Mark it done and test later."	Keep the loop item blocked or `needs-review` until evidence exists.

Verification

Every requirement maps to a test, proof stage, and artifact path.
Host/simulation/build/target/system results are labeled separately.
Physical-only steps emit the concrete Physical gate format from embedded-project-loop.
Failed and unverified cases remain visible in the report.

Shared output contract

Use the shared Arduino skill contract: state assumptions, required tools and versions, implementation steps, tests/evidence by proof stage, known limitations, and recovery/security notes.

FAQ

What does the hardware-tdd skill do?

How do I install hardware-tdd?

Run npx skills add https://github.com/wedsamuel1230/embedded-engineering-skills --skill hardware-tdd in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/hardware-tdd/ (personal) or .claude/skills/hardware-tdd/ (project).

Which AI agents can use hardware-tdd?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is hardware-tdd safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains hardware-tdd?

It is published by wedsamuel1230 in wedsamuel1230/embedded-engineering-skills. It has 63 recorded installs.