DEV Community

James Whitfield
James Whitfield

Posted on

Evidence-driven change: wiring training, risk, and docs into one calm event

In my role as a Senior Quality Engineer at a ~200-person Class II device shop, the loudest meetings used to be the ones after a change approval: engineers, product, QA — all arguing over who needed training, which version of a spec was controlling, and whether the new risk control had been verified.

We changed that by treating each approved change (or CAPA) as an evidence-driven event: update the controlled document, update the risk item, create required training, and collect proof — all as linked, reviewable artifacts. The room got calmer because the QMS did the heavy lifting; people just did the work and uploaded evidence.

Below is what we wired together, how we automated it, what actually made auditors happy, and the gotchas we learned the hard way.

Why this matters (standards and outcomes)

ISO 13485 and 21 CFR 820 both expect documented competence and controlled documents; MDR attention on technical documentation makes traceability even more important. Auditors want to see:

  • that training was assigned and completed for people performing regulated activities,
  • that the version of record for each procedure or specification is clear,
  • and that changes had risk controls implemented and verified.

If you make the change a single connected workflow — change → doc update → training → evidence → verification — you reduce manual handoffs, improve traceability, and reduce the “who signed off on this?” noise during audits.

What we wired (conceptual flow)

We deliberately kept the model simple and repeatable.

  • Trigger: Change or CAPA status moves to “Approved for Implementation”.
  • Doc control: The owning document(s) get a “change pending” flag and a draft version linked to the change record.
  • Risk: Any risk control items affected by the change are linked; if mitigation level changed, mark for verification.
  • Training: Auto-create role-based training tasks for impacted users, referencing the new doc version and a short checklist/quiz.
  • Evidence: Require attachments — completed checklist, screenshot of a test run, CSV of results, or signed attestation.
  • Verification: Once training and evidence are complete, the change implementation step is auto-eligible for closure; QA reviews the linked artifacts and approves final close.

Conceptually it’s one event with multiple artifact types connected to it — every artifact is auditable and time-stamped.

How we implemented it (practical automation patterns)

We used our QMS’ workflow engine + a small automation layer (serverless function) to orchestrate what the QMS UI doesn’t do natively.

High-level pattern:

  1. Webhook on change record state change (Approved → Implementation).
  2. Automation service queries the change record for impacted modules (docs, risk items, affected roles).
  3. Service creates:
    • Draft document tasks (if doc owner is different from change owner),
    • Training assignments for specific roles/groups (incl. due dates),
    • Risk verification tasks linked back to the change record.
  4. Each created task contains:
    • direct link to the draft/controlled document,
    • a short “what to do” checklist and minimal pass/fail criteria,
    • an evidence upload field (attachments become part of the change record).
  5. When all linked tasks are completed, the automation notes completion and notifies QA for final review.

Tips on implementation:

  • Use templates for training tasks (title, checklist, expected evidence) so assignments are consistent.
  • Assign by role, not person, where possible — avoids reassigning when people change teams.
  • Keep the required evidence atomic (e.g., “attach screenshot of device config and a signed checklist”) — auditors like clearly labeled artifacts.

What we needed to prove to auditors

During our last surveillance audit the auditor asked for:

  • Who was trained on the change, with dates and content referenced.
  • Version of the spec that was controlling at implementation.
  • Evidence that the risk control was implemented and verified.

Because our artifacts were linked to the change record, we could produce a single printout (or PDF export) that showed:

  • change record,
  • updated controlled doc version and link,
  • training completions with attachments,
  • risk verification notes and attachments.

That combined package is what made the room calm — auditors can follow the traceability chain without ten separate exports.

Gotchas and practical caveats

  • Scope creep: Don’t try to auto-assign training for every minor wording tweak. Define change categories that trigger full training vs. those that only require doc updates.
  • Evidence quality: You will get “evidence” that’s a screenshot of nothing. Give examples and minimal acceptable formats in the template.
  • SME bandwidth: Auto-created tasks can swamp SMEs. Stagger due dates or require role-based delegation.
  • Migration and metadata: If you’re migrating documents in bulk into a new QMS, preserve metadata (owner, revision history) so your automated links still make sense.
  • Reviewability and retention: Keep artifacts reviewable and immutable after closure. Audit trails must be intact.

Small implementation notes for engineers

  • Keep the automation stateless and idempotent — a webhook retry shouldn’t create duplicate tasks.
  • Name linked artifacts consistently (Change-1234: Training - Operators) so queries and exports are easy.
  • Use the QMS API to fetch “affected requirements” or impacted test cases when possible; if that isn’t available, maintain a small mapping table that relates doc IDs to roles and risk items.
  • Log everything for later troubleshooting — when someone says “I never got an assignment,” you want the trace.

The result (qualitative)

We didn’t eliminate meetings entirely, but the post-change reviews shifted from “what happened?” to “here is the evidence, here are the open items.” Fewer follow-ups, quicker closes, and a reproducible audit package. It also reduced the manual email pinging that formerly ate QA’s day.

I’d describe the change as moving from subjective memory (“I think I trained them”) to objective, evidence-driven closure that auditors and engineers both trust.

What’s your pattern for linking training, docs, and risk to a change or CAPA? Any automation tricks (webhook middleware, idempotency patterns, or evidence templates) that worked well in your shop?

Top comments (0)