Make the structured instruction reusable across procedure and workflow views. Keep the narrative that people need to understand and govern the work.
Keep what cannot be reduced to a form.
Purpose, scope, responsibilities, rationale, escalation, and work performed outside the system still need clear guidance. Human judgment does not disappear just because a workflow has a required field.
Decide which parts are derived from structured content and which are authored narrative. Make that distinction clear to authors and reviewers so a generated view does not imply coverage of responsibilities it does not actually describe.
- Structured: required identity, accepted range, sequence, and review gate
- Narrative: purpose, scope, rationale, and responsibilities
- Referenced: external methods, source requirements, and supporting documents
Show the instruction where the decision happens.
An operator should be able to see the relevant instruction and its approved revision from the corresponding step. Required observations and confirmations should be close to the action that records them.
For example, a receipt may require material identity, supplier lot, quantity, container checks, and evidence of review. The workflow can guide those entries while the readable procedure explains the broader receiving responsibilities.
Be precise about what the system enforces.
Displaying “verify container integrity” is different from requiring a confirmation before receipt. Requiring a confirmation is different again from independently establishing that the container is intact.
Describe the control accurately. The system can require a field, check a value, enforce a sequence, or restrict an action. Some facts still depend on an observation made by a qualified person or an appropriately verified instrument.
- Instruction: tells the person what is required
- Control: checks the configured condition before an action
- Evidence: records the observation, source, and decision
Approve the change across its consequences.
When the shared instruction changes, review both the readable procedure and the workflow behavior it drives. Identify related verification and training that may need attention.
Approve the relevant sources and activation plan before the new version governs work. Preserve the source revision used by earlier executions, and make any decision about in-flight work explicit. This is how shared content reduces duplication without turning change into an invisible side effect.
- Which content is structured, which is narrative, and who owns each?
- Can the operator retrieve the approved source from the step?
- Have we tested the blocked path as well as the expected path?