A finished 3D model and a clean drawing set feel like the end of the job, but on the shop floor they’re really just the starting point. I’ve watched plenty of talented engineers hand off a beautiful assembly and then get blindsided by a phone call three days later because the technician built it wrong, or built it right but in an order that made the last bolt impossible to reach. Writing work instructions is the unglamorous bridge between “the design is correct” and “the machine actually gets built correctly, the same way, every single time.” Over twenty years of stationing at manufacturers as an external mechanical designer, I’ve come to treat instruction writing as a design discipline in its own right, not an afterthought for someone else to handle. This article walks through how I approach it.
- Start From the Assembly Sequence, Not the BOM
- Photographs and Renders Beat Text Every Time
- Torque Values and Fastener Callouts Need Their Own Table
- Write for the Worst-Case Reader, Not the Best-Case One
- Build in Verification Steps, Not Just Assembly Steps
- Version Control and Change Traceability Matter as Much as Content
- Field-Test the Instructions Before You Release Them
Start From the Assembly Sequence, Not the BOM
The most common mistake I see is writing instructions in BOM order — top to bottom, part number after part number — instead of build order. A bill of materials tells you what exists; it says nothing about what has to happen first. On a conveyor transfer unit I designed early in my career, I handed the technician a parts list and a drawing and assumed the sequence was obvious. It wasn’t. He installed the drive motor before threading the timing belt through the frame, which meant the whole motor bracket had to come back off. That was an hour of rework on a unit we were building fifty of.
Since then I always work out the sequence myself, on the actual 3D model, before I write a word. I hide and show subassemblies in the CAD tree to simulate the build order, checking at each step whether tools can physically reach the fasteners and whether anything installed earlier blocks anything installed later. I pay particular attention to “point of no return” steps — operations like riveting, welding, or applying thread-locker that can’t be undone — and make sure everything that needs to be checked or adjusted happens before that point, not after.
Photographs and Renders Beat Text Every Time
Early in my career I wrote instructions the way I’d write a specification: dense paragraphs of prose. “Insert the M6x20 socket head cap screw into the upper mounting hole of the bracket and torque to 8 N·m.” Technically correct, and almost useless on a noisy shop floor where someone is reading it with gloves on. What actually works is a photo or an isometric render of the subassembly at that exact step, with an arrow pointing at the hole and the torque value written right next to it in large text.
I now build my instructions around a simple rule: every step gets one image and one line of text, never the reverse. If a step needs more than one sentence to describe, it’s usually a sign that the step should be split into two. On a semiconductor handling fixture I documented a few years back, I went through six revisions of the instruction set before the technicians stopped asking clarifying questions, and every revision was driven by watching someone actually use the previous version and hesitate.
Torque Values and Fastener Callouts Need Their Own Table
Fastener information gets lost when it’s buried inline in step-by-step text, so I always pull it into a standalone table that sits at the top of the document or on a reference sheet nearby. This does two things: it gives the technician a single place to check a torque value without hunting through pages, and it forces me as the designer to actually confirm every torque spec before I release the document, rather than writing “torque appropriately” and moving on.
| Fastener | Location | Torque | Thread Locker |
|---|---|---|---|
| M6x20 SHCS | Upper bracket mount (x4) | 8 N·m | None |
| M8x25 SHCS | Base plate to frame (x6) | 20 N·m | Loctite 243 |
| M4x12 SHCS | Sensor bracket (x2) | 1.5 N·m | None |
I learned to be this explicit the hard way. On a robot end-effector project, a subcontractor over-torqued a set of M4 screws into an aluminum housing because the instructions just said “tighten securely,” and the threads stripped on three units before anyone flagged it. Since then, if a fastener goes into aluminum, plastic, or anything with a low shear strength, I don’t just give a torque number — I add a warning line and, where it matters, specify a torque wrench class.
Write for the Worst-Case Reader, Not the Best-Case One
It’s tempting to write instructions assuming the person reading them has your level of context: they know the machine’s purpose, they’ve seen similar assemblies before, they’ll fill in gaps sensibly. In practice, instructions get used by whoever is available that shift, which might be a new hire on their second week, or a technician at an offshore contract manufacturer who has never seen this product line and doesn’t share your first language. I try to write and lay out instructions so that someone with zero prior context on the specific machine could still follow them correctly, using nothing but symbols, arrows, numbers, and short imperative phrases.
That means minimizing jargon, spelling out abbreviations the first time they appear, and never assuming a reader will infer orientation. “Install the bracket” is ambiguous; “install the bracket with the tapped holes facing up, as shown” is not. I also avoid relying on color alone to distinguish parts or steps, since printed instructions on a shop floor are frequently photocopied in black and white, and color-blind technicians exist on every line I’ve worked with.
Build in Verification Steps, Not Just Assembly Steps
Instructions that only tell someone how to put parts together miss half the job. I always insert explicit checkpoints: “confirm the shaft rotates freely by hand before proceeding,” “measure gap X at this point and confirm it is within 0.5–1.0 mm,” “verify LED indicator is lit before closing the enclosure.” These checkpoints catch problems while they’re still cheap to fix — before the next subassembly buries the mistake.
On a packaging line gripper mechanism, I added a checkpoint requiring the technician to manually cycle the jaw mechanism ten times and confirm no binding before the cover panel went on. That single step caught a batch of out-of-spec bushings that would otherwise have shipped inside a sealed housing, only to fail during commissioning at the customer site where opening the unit back up would have cost far more time and credibility. Verification steps are cheap to write and expensive to skip.
Version Control and Change Traceability Matter as Much as Content
Work instructions are not static documents; they get revised every time a design change, a supplier substitution, or a field failure teaches you something. I’ve seen too many shop floors where an old revision was still taped to a workstation months after the drawing had changed, because nobody had a formal process for pulling outdated instructions when a new one was released. Every instruction sheet I write carries a revision number, a date, and a one-line change summary at the top, and I insist on a process where the previous revision is physically removed from the floor the moment the new one goes up, not just added alongside it.
I also keep a change log that ties each revision back to the reason it happened — a specific engineering change order, a specific defect report, a specific supplier change. This has saved me more than once during audits, particularly on projects governed by customer quality systems, where being able to show exactly why an instruction changed and when is as important as the instruction itself.
Field-Test the Instructions Before You Release Them
The single highest-value habit I’ve developed is refusing to release a first-off instruction set without watching someone build from it who wasn’t involved in writing it. I stand nearby, say nothing unless asked, and take notes on every hesitation, every step they re-read, every moment they reach for a part that isn’t the one I intended next. Every one of those hesitations is a defect in the document, not in the reader.
On a large machine frame assembly with roughly 140 steps, this field test caught eleven separate points of confusion that I, as the person who designed the assembly, could never have spotted on my own — because I already knew what came next. Since adopting this habit as a non-negotiable step before release, first-build rework on new instruction sets has dropped dramatically across every project I’ve been directly responsible for. Good work instructions aren’t written at a desk; they’re written at a desk and then corrected on the floor.



コメント