Skip to content
Process Documentation

Best Practices for Writing Clear Work Instructions

Most work instructions fail the same way. Not because people ignore them, but because one ambiguous word left the wrong action on the table.

KC
Kai Chen
Engineering Lead at Haiku
June 24, 2025 · 13 min read
Best Practices for Writing Clear Work Instructions

A warehouse worker grabs the wrong package size. A lab technician adds the right chemical but the wrong amount because the measurement was buried three lines earlier. An assembler tightens the bracket before seating the gasket because the order was never written down.

In the debrief, the instruction gets read aloud, everyone nods, and the verdict lands on the person: they didn't read it carefully.

That verdict is almost always wrong. When you trace a repeatable execution error back to its source, you rarely find a careless operator. You find a sentence that could be read two ways, and a reader who picked the reading you didn't intend.

This guide focuses on that sentence-level craft. It complements our seven-step framework for building an SOP and our guide on how to write an SOP your ops team will follow, but stays one level lower: the writing decisions that make a single task impossible to misread.

Key takeaways

  • A work instruction is the atomic, do-this-exact-task layer that lives inside an SOP. Its only job is to make one step unambiguous.
  • Most repeatable execution errors are clarity defects the author owns (ambiguous verbs, compound steps, buried decisions), not attention failures you can blame on the reader.
  • Clarity is engineered one word at a time: one action per step, imperative verbs with an object and a completion criterion, decision points made explicit.
  • A static visual belongs anywhere language alone is fragile: a spatial relationship, an orientation, a "which one of these three." Annotate it, never just paste it.
  • The mistakes section is the payoff, not the filler. Each recurring failure mode maps to a specific writing move that fixes it.
Illustration

Difference between SOPs and work instructions

A standard operating procedure (SOP) defines a whole process: its purpose, its scope, who owns it, and the sequence of steps that get it done.

A work instruction is one of those steps written at execution resolution: the exact, do-this-now detail a person needs to perform a single task correctly, without asking anyone.

Put simply: the SOP says what the process is and who runs it. The work instruction says exactly how to do this one step so it cannot be misread. The SOP is the map; the work instruction is the turn.

That distinction is the whole reason this article exists. When teams say "our SOP writing is fine but people still make mistakes," they are usually looking at the process level and missing the sentence level.

The process can be flawless and the task can still fail, because the failure lives inside a single step that two people read differently.

Keep this boundary tight and everything downstream gets easier. Understanding the differences between SOPs, workflows, and process maps matters when you're designing a documentation system. Here, the only comparison that matters is the SOP and the instruction inside it.

Principles of clarity

Clarity is not a tone. It is a set of decisions you make word by word, and every one of them is about closing off a wrong reading before the reader can take it.

The goal is not to describe the task. It is to make the wrong action impossible to take by accident.

Five principles carry most of the weight.

One action per step.

A step should ask for exactly one observable thing. The moment a step contains an "and," you have created a place for the second half to get skipped under time pressure.

"Scan the bin label and confirm the SKU matches the pick list" is two steps wearing one number. Split it. Checklist design, the discipline behind aviation and surgical safety checklists, is built on the same rule: keep each item a single, discrete action, because compound items are the ones that get half-done.

Start every step with an unambiguous imperative verb.

"Verify," "check," and "ensure" feel like instructions but name no action. Verify how? Against what? Replace them with a verb the reader can physically perform and a criterion they can observe: not "verify the reagent is ready" but "confirm the buffer bottle reads 0.1 M and the seal is intact." A good imperative answers do what, to what, until what.

Make every decision explicit.

Anywhere the right action depends on a condition, the reader is making a decision, and if you didn't write the branch you left it to memory.

Write it as a visible if/then: "If the calibration reads outside ±0.5 °C, stop and tag the unit; otherwise continue to step 7." An implicit decision is the single most common source of "but I thought..." errors.

Specify the completion criterion.

Every step should tell the reader how to know it worked. Torque to 12 Nm, not "tighten firmly." Fill to the 250 mL line, not "fill the flask."

Vague end states are where two operators quietly diverge and both believe they followed the instruction.

Write for the least-experienced qualified reader.

Not the author, not the veteran, but the newest person who is allowed to do the task. If a term, an abbreviation, or an assumed sequence would stop them, it is a defect, whether or not the veteran ever notices it.

None of this is about writing more. Task documentation gets clearer as it gets tighter; fewer words, each one load-bearing.

Formatting tips

Once the sentences are clear, formatting decides whether the reader can find the right one at the moment they need it. Good employee guides are built to be scanned under load, not read start to finish in a quiet room.

  • Number sequential steps; bullet everything that has no order. Numbers promise sequence. Using them for a non-ordered list teaches readers to distrust your numbering, and then they stop trusting the order where it actually matters.
  • One step per line, verb first. A wall of prose hides the action. When the first word of every line is the thing to do, the eye finds it without parsing a sentence.
  • Put warnings and cautions before the step, never after. A safety note that appears below the action has already failed; the reader does the thing, then reads why they shouldn't have. The caution has to arrive before the hand moves.
  • Use one name per object, every time. If it is the "intake valve" in step 3, it is not the "inlet" in step 8. Synonyms feel like good writing and read like two different parts. Consistent terminology is not a style preference in task documentation; it is a safety feature.
  • Chunk and leave whitespace. Group steps into short labeled stages. Dense pages get skimmed, and skimming is where steps get skipped.

Formatting choices also decide how long an instruction survives. Screens get redesigned, panels get relabeled, buttons move. Instructions that hard-code the current interface rot on the next release.

Build them the way we describe in instruction templates built to survive interface changes, anchored to what the step accomplishes and the stable landmarks around it, so a UI refresh doesn't silently turn every screenshot into a lie.

Visual documentation

Some things do not survive being written down. Orientation, spatial relationships, "which of these three near-identical connectors". The moment the reader has to reconstruct a picture from a paragraph, you have made the step fragile. That is exactly where a visual earns its place.

Use static visuals such as annotated screenshots, callouts, cropped reference photos, and simple diagrams wherever language alone is doing work it is bad at.

The principle is narrow on purpose: a visual is there to remove an ambiguity, not to decorate the page. So annotate it.

A raw screenshot says "somewhere on this screen." An arrow, a highlight, and a one-line caption say "here, this, because." An unannotated image is not visual documentation; it is a picture you left for the reader to interpret.

Two rules keep visuals honest:

  • Crop to the decision. Show the part of the panel or the part of the assembly the step is about, not the whole workstation. The more you show, the more the reader has to search.
  • A stale visual is worse than none. A screenshot of an old UI or a photo of the previous jig actively teaches the wrong action, and it does it with the authority of an image. Keeping visuals current is the hidden cost of visual documentation, and the reason capture matters.

Re-shooting a step by hand runs a tradeoff we have measured across documentation work: 90–120 minutes to rewrite and re-illustrate a procedure by hand versus 8–15 minutes to recapture it. If your visuals are expensive to refresh, they will go stale, and stale is the failure mode.

Static images are the right tool for a spatial or single-frame ambiguity. When the ambiguity is motion (a drag, a sequence of clicks, a timing you can't freeze), that is where a moving medium takes over.

We cover when moving to video documentation makes a step clearer and, for screen-based tasks specifically, capturing a screen-based task as a recording in their own guides. For everything a still frame can hold, keep it a still frame: it loads instantly, it prints, and the reader can hold their place.

Examples

The fastest way to internalize the craft is to read a muddy instruction next to its clear rewrite. Same task, same reader: only the ambiguity removed.

Warehouse pick-and-pack.

Muddy: "Pick the item and pack it for shipping."

Clear:

1. Read the pick list quantity and unit (each vs. case). 2. Scan the bin label. Confirm the SKU on screen matches the pick list. 3. Count the exact quantity in the listed unit into the tote. 4. If the bin quantity is short, tap Short-pick and stop; do not substitute. 5. Place the tote on the pack bench; do not seal until the pack scan confirms the count.

The muddy version hides three separate decisions inside a single sentence: unit, match, and what to do when the bin is short.

Lab reagent prep.

Muddy: "Prepare the buffer and check it before use."

Clear:

1. Confirm the buffer bottle label reads 0.1 M phosphate and the seal is intact. 2. Measure 250 mL into a clean graduated cylinder, read at the meniscus. 3. Measure the pH. If it reads outside 7.2–7.6, discard and prepare a fresh batch. 4. Label the cylinder with the date and your initials before moving to the bench.

"Check it" named no action and no criterion. The rewrite says what to measure, what range is acceptable, and exactly what to do when it isn't.

Equipment assembly.

Muddy: "Attach the bracket and tighten the bolts."

Clear:

1. Seat the gasket in the groove first; confirm it sits flat with no gap. 2. Position the bracket so the arrow stamp points toward the motor. 3. Hand-thread all four bolts before tightening any. 4. Torque the bolts to 12 Nm in a diagonal (star) sequence.

The muddy version left out order, orientation, and the completion criterion: the exact three things that produce a rework when they go unstated.

This is the difference between task documentation that describes a task and task documentation that governs it.

Mistakes to avoid

These are the recurring ways instructions break. Each one is a defect the author can fix, and each maps to a move you have now seen.

  • The compound step. Two or more actions under one number. Under time pressure the reader completes the first and moves on. Fix: one action per step, always.
  • The empty verb. "Verify," "ensure," "check," "make sure": instructions that name a feeling, not an action. Fix: a physical imperative plus an observable criterion.
  • The implicit decision. A step whose correct action depends on a condition you never wrote down, so the reader supplies it from memory. Fix: a visible if/then branch at the fork.
  • The buried warning. A caution that appears after the action it was meant to prevent. Fix: move it above the step.
  • The synonym drift. The same object called three names across a procedure, read as three parts. Fix: one name per object, enforced.
  • The stale visual. An old screenshot or an outdated photo that teaches the wrong action with the confidence of an image. Fix: capture over hand-illustration, so refreshing is cheap enough to actually happen.
  • The blame reflex. The most expensive mistake of all: closing a defect as "operator error" and coaching the reader instead of fixing the sentence. If the same step trips different people, the instruction is the variable, not the people. Fix the instruction, not the operator.

The through-line: every one of these is a clarity defect with a named owner and a named fix. That is the reframe this whole article rests on. Ambiguity, not effort, is what breaks task execution.

Make every step impossible to misread

You cannot make a task go faster by writing a better sentence. You can make it go right the first time, which is almost always the thing you were actually after.

Clear work instructions don't come from writing more; they come from writing tighter. One action per step, verbs a reader can perform, decisions dragged into the open, and a visual wherever words are too fragile to hold the shape of the thing.

Hold onto the principle underneath all of it. A step that can be read two ways will be read both ways. Clarity is not a courtesy you extend to the reader. It is the part of the job that decides whether the task gets done.

FAQ

What is the difference between an SOP and a work instruction?

An SOP defines a whole process: its purpose, scope, owner, and sequence of steps. A work instruction is one of those steps written at execution resolution: the exact detail a person needs to do a single task correctly without asking. The SOP is the map; the work instruction is the turn.

How do you write clear work instructions?

Write one action per step, start each step with an imperative verb that has an object and a completion criterion, make every conditional decision an explicit if/then, and add a visual wherever language alone is fragile. Then test it against the newest person allowed to do the task: if anything stops them, it's a defect.

What makes a work instruction unclear?

Usually one of a few defects: compound steps that hide a second action, empty verbs like "verify" or "ensure" that name no observable action, decisions the reader has to supply from memory, and end states with no measurable criterion. These read fine to the author and split two readers apart.

How detailed should a work instruction be?

Detailed enough that the least-experienced qualified reader can execute the step without asking a question, and no more. Every word should be load-bearing: specify units, criteria, order, and orientation, but cut anything that doesn't remove an ambiguity. Tighter is clearer.

Should work instructions include pictures?

Include a static visual wherever words are doing something they're bad at: spatial relationships, orientation, or telling near-identical items apart. Always annotate it to point at the exact decision, crop it tight, and keep it current, since a stale image teaches the wrong action with the authority of a photo.

How often should you update work instructions?

Whenever the task, the tool, or the interface it references changes, and immediately when a step is traced to a repeated error. The practical constraint is cost: if refreshing a visual is expensive, it won't happen, which is why instructions built on captured, easily-regenerated steps stay accurate and hand-illustrated ones drift.

What's the best format for work instructions?

Numbered sequential steps, one action per line, verb first, warnings above the action they prevent, one consistent name per object, and short labeled stages with whitespace so the page can be scanned under load. Build it on a template anchored to what each step accomplishes, so it survives the next interface change.

KC
Kai Chen
Engineering Lead at Haiku

Kai builds the capture and AI infrastructure at Haiku. He cares deeply about making complex systems legible to the people who use them.

Work InstructionsProcess DocumentationSOPsTechnical Writing

Never miss a story

Join over 50,000 working professionals who read Haiku Resources every week.

Ready to write your first haiku?

No credit card. No sales pitch.