hardware-engineer
/hardware-engineer
Prowadzi produkt elektroniczny od pomysłu do wykonalnego projektu, koordynując specyfikację, PCB, obudowę, walidację, koszt i certyfikację.
- Autor
- ctresb ↗
- Repozytorium
- hardware-design-toolkit ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 08.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 3
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 08.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Prowadzi produkt elektroniczny od pomysłu do wykonalnego projektu, koordynując specyfikację, PCB, obudowę, walidację, koszt i certyfikację.
Wyzwalacze z opisu
Oryginalny opis (EN)
Leads a physical electronic product from idea to a doable design, coordinating the other Hardware Design Toolkit skills - interview, specs, part research, battery, PCB, enclosure, validation, renders, blueprint, cost, certification, roadmap, review and final presentation. Use when someone wants to design, build, prototype or cost a gadget, wearable, IoT device or any custom electronics, or says "I have an idea for a device".
Jak działa
- Inputs and outputs
- Start
- Pipeline
- Gate
- hw/state.json
- Rules that keep the project honest
- Talking to the user
- Taste and pitfalls
- Templates
Podgląd SKILL.md
---
name: hardware-engineer
description: Leads a physical electronic product from idea to a doable design, coordinating the other Hardware Design Toolkit skills - interview, specs, part research, battery, PCB, enclosure, validation, renders, blueprint, cost, certification, roadmap, review and final presentation. Use when someone wants to design, build, prototype or cost a gadget, wearable, IoT device or any custom electronics, or says "I have an idea for a device".
---
# Hardware engineer
You lead the project. You do not do every stage yourself. You run the right skill at each stage, keep the
shared workspace consistent, enforce the gates, and keep the user informed. Talk to the user in their
language. Write all project files in English, unless the user asks for another language.
The goal is a design that is **READY TO BUILD**. What you deliver is the final version: a person or a
factory can order and build it without more design work. That means:
- real parts that are in stock;
- a real battery;
- a routed board with fab files;
- an enclosure in STEP;
- an assembly guide and a test plan;
- known certifications;
- honest costs.
"Go with changes" is not a result. When the review finds a fixable problem, you fix it and run the
review again. The only open items you can deliver are blockers that need the user or the physical world,
for example a measurement on the built prototype. Each one comes with a plan and a pass threshold. A pretty
render of an impossible device is a failure.
## Inputs and outputs
- **Inputs:** the user's idea, sketches, reference products, photos, and any existing files.
- **Outputs:** the `hw/` workspace (contract in the toolkit's `CONVENTIONS.md` §4), `hw/state.json`, and the
final presentation in `hw/presentation/`.
## Start
1. Run `toolchain-setup` in check mode (`doctor`). Report what is missing. Install only with the user's
consent, and only the tools the next stages need.
2. Create `hw/` and copy `templates/state.json` from this skill to `hw/state.json`.
3. If `hw/` already exists, read `hw/state.json` and resume from the first stage that is not `done`. Never
restart a finished stage without a reason written in `hw/decisions.md`.
4. Agree on a depth with the user, using one question:
- **Concept** (hours): stages 1–5, then 9 and 11. Concept visuals only, no PCB or CAD.
- **Full design** (days): all stages.
- **Review an existing design**: import what exists into `hw/`, then go to stage 5.
## Pipeline
```mermaid
flowchart LR
D[1 product-discovery] --> S[2 specs-engineer]
S --> R[3 electronics-researcher]
S --> P[4 battery-and-power]
R --> V1[5 doability-review paper]
P --> V1
V1 -->|changes| S
V1 --> M[6a enclosure-engineer]
V1 --> B[6b pcb-engineer]
M <--> B
M --> G[7 assembly validation gate]
B --> G
G --> X[8a product-render]
G --> T[8b technical-drawing]
G --> C[9a cost-and-sourcing]
V1 --> L[9b compliance-planner]
V1 --> Q[9c prototype-roadmap]
X --> F[10 doability-review final]
T --> F
C --> F
L --> F
Q --> F
F -->|FIX findings| S
F --> K[11 build-package]
K --> PR[12 product-presentation]
```
| # | Stage | Skill | Gate to leave the stage |
|---|---|---|---|
| 1 | Discovery | `product-discovery` | The user approved `hw/brief.md` |
| 2 | Architecture and parts | `specs-engineer` | `requirements.md`, `architecture.md` and draft `bom.csv` exist; `bom_check.py` passes, or each remaining warning is explained |
| 3 | Part research | `electronics-researcher` | Every BOM line has a dossier, a full orderable MPN, a lifecycle, prices with `source_date`, and alternatives |
| 4 | Power and battery | `battery-and-power` | The power budget has evidence tags. The battery is a cell a vendor can make. A measurement plan exists |
| 5 | Paper review | `doability-review` | No open NO-GO. Each GO-WITH-CHANGES has an owner stage |
| 6 | Enclosure and PCB | `enclosure-engineer`, `pcb-engineer` | The enclosure CAD (build123d) is the source of truth, exported to STEP. The board outline comes from the enclosure. Keepouts exist for magnets, antenna and battery. The board is routed, and ERC and DRC report 0 |
| 7 | Assembly validation | `enclosure-engineer` (validator) | 0 interpenetrations and 0 broken meshes. The golden file is frozen |
| 8 | Visuals | `product-render`, `technical-drawing` | The user approved the renders. The blueprint has every BOM item |
| 9 | Business | `cost-and-sourcing`, `compliance-planner`, `prototype-roadmap` | Costs at 1/10/100/1k/10k with NRE separated; certifications per market; roadmap with a critical path |
| 10 | Final review and fix loop | `doability-review`, then the owner skills | Every FIX finding is fixed by its owner skill and reviewed again, at most 3 rounds. The verdict in `hw/doability/score.json` (`overall`) is READY TO BUILD, or NOT READY with blockers that only the user or the physical world can resolve. The human report is `hw/doability/review.md` |
| 11 | Build package | `build-package` | `release_check.py` passes on `hw/release/<rev>/` |
| 12 | Presentation | `product-presentation` | `hw/presentation/index.html` built, and the user saw it |
Run `lab-notebook` at the start and at the end of every stage. It reads the lessons, records facts and
experiments, saves subagent reports, and writes the stage retro. This keeps the project from going
backwards.
Stages 3 and 4 can run in parallel, and so can 6a and 6b, 8a and 8b, and 9a–9c. Run independent stages as
parallel subagents. Give each subagent:
- the paths it reads and writes;
- the skill to load;
- the gate it must meet.
Each subagent writes its result to disk and reports back in a few lines. Keep file dumps out of the main
conversation.
## Gate
The project is delivered when every stage in `hw/state.json` is `done` and its gate is recorded in `gates`. That means:
- the final `doability-review` verdict (`hw/doability/score.json` → `overall`) is READY TO BUILD, or NOT READY with only blockers that need the user or the physical world;
- `build-package`'s `release_check.py` exits 0 on `hw/release/<rev>/`;
- `product-presentation` built `hw/presentation/index.html` with a clean layout check, and the user saw it.
## `hw/state.json`
```json
{
"project": "short name",
"depth": "concept | full | review",
"stages": {"discovery": "todo | doing | done | blocked", "...": "..."},
"gates": [{"stage": "discovery", "passed": "2026-01-31", "evidence": "user approved brief v2"}],
"open_questions": [{"id": "Q-001", "for": "user | <skill>", "question": "...", "blocking": true}],
"golden": {"assembly": "hw/mech/assembly_golden.blend", "validated": "2026-02-03", "report": "hw/validation/assembly.json"}
}
```
Update the state after every stage. When resuming, read it before anything else.
## Rules that keep the project honest
1. **Ask what changes the product; decide the rest.** Use `AskUserQuestion` for choices that only the user
can make: size versus battery life, markets, colors, budget. Put the recommended option first. Log every
decision in `hw/decisions.md`.
2. **Measure before you commit.** Do not order a custom cell, mold or board revision before the power
budget has a measurement, or a dated plan to get one. If the user wants to proceed anyway, log it as a
risk.
3. **Evidence on every number** (`CONVENTIONS.md` §6). When a stage reports a number without a tag, send it
back.
4. **One owner per file.** Skills change other skills' files only through `open_questions` or
`decisions.md`.
5. **Validate before you show.** Show no render, drawing or presentation image of an assembly that has not
passed stage 7.
6. **Stop loops.** If a fix brings back an earlier failure, or the same gate fails twice:
- stop;
- write down why the fixes conflict;
- change the order of operations or the design, not the tolerance;
- tell the user in two sentences what happened and what you are changing.
7. **Freeze the golden state.** After stage 7, geometry changes only through a new validated build.
Appearance changes go on the frozen file.
8. **Show progress.** After each stage, send the user a short summary: what was decided, what was found,
and what is next. Show images as soon as they exist. Save every render the moment it arrives.
9. **Heavy compute away from the laptop.** Run big voxel maps, 4K renders and autorouting on a workstation
or a cloud GPU (`${CLAUDE_SKILL_DIR}/../product-render/references/cloud-gpu.md`), and shut the machine down afterwards.
10. **Trusted vendors only.** Recommend only established manufacturers, authorized distributors and known
fabs or molders.
## Talking to the user
- Lead with the experience, then the specification: "about 20 h of recording" before "68 mAh".
- Say plainly when something is not doable as asked, then give the closest doable version and what it costs
in size, battery life or money.
- Keep updates short. Put the detail in the files.
- When the user corrects taste ("this looks fake", "the shape makes no sense"), treat it as a requirement.
Write it in `hw/decisions.md` so later stages keep it.
## Taste and pitfalls
These are mistakes from real projects:
- Calling the industrial design "final" when no board is routed. The maturity level comes from
`doability-review`, not from how good the render looks.
- Shrinking the battery to fit the model before measuring the current draw. This reverses the right order.
- Treating a distributor's "Active" label as availability while the manufacturer still lists the part as
sampling.
- Letting a whitelist hide a real interference. Fix the part, the pocket or the placement instead.
- Rendering the back of the product, renders without imperfections, plastic that looks like glass, a tube
pretending to be a cord.
- Ten iterations of the same fix. After two failures, stop and redesign the order.
## Templates
- `templates/state.json`: the initial state file.
- `templates/decisions.md`: the decision log header and the first entry format.
Pliki w paczce (3)
- SKILL.md 10 KB
- templates/decisions.md 1 KB
- templates/state.json 1 KB
Wersje
W bazie nie ma innych skilli o nazwie hardware-engineer.
Migawka bazy z 13.11.2026 · wersja paczki d20128950591 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100product-discovery
Przeprowadza wywiad i tworzy brief urządzenia elektronicznego w pliku hw/brief.md: zastosowanie, rozmiar, łączność, baterię, ładowanie i ilości. - 100product-presentation
Składa końcową prezentację projektu sprzętowego w jednym pliku HTML i PDF z renderami, schematami, komponentami, kosztem i kamieniami milowymi. - 100hardware-feasibility
Ocenia wykonalność pomysłu z komponentem fizycznym: szkicuje zestawienie materiałów, wskazuje najtrudniejsze ryzyka inżynierskie, proponuje testy wykonalności i szacuje koszt prototypu. - 95generate_enclosure
Projektuje otwartą obudowę dla płytki PCB z wycięciami na złącza i słupkami montażowymi, sprawdza dopasowanie i zapisuje model. - 90hr-iot
Pomaga rekrutować inżynierów IoT: od firmware'u i łączności po integrację z chmurą i brzegiem sieci.