BlogWorkflows

Stop documenting your process. Run it.

Workflows · 3 min read

Every team has a written process; few run it the same way twice. When the workflow lives in the record itself — owned states, automatic hand-offs, locked history, send-backs that carry a reason — the right path becomes the easy one.

www.tebelis.ai/records
A process isn't a document beside the work — it's the states each record moves through, the people who own them, and the rules that move them.

The process lives in a document. The work doesn't.

Most organisations have a written process. An SOP, a quality manual, a laminated flowchart by the door. Everyone signed the training record; nobody runs it quite the same way. The forms get filled — but the steps around the forms live somewhere else. Who investigates this incident? Does a deviation need a quality assessment before anyone starts a corrective action? Who confirms the work order was actually done — the technician who closed it, or the person who raised it?

On paper, all of that is precise. In practice it's email threads, verbal hand-offs and "I thought you had it." That's not a documentation problem: the process is described in one place and performed in another, and the gap between the two is where records stall, skip a step, or get closed by someone who was never supposed to close them.

A workflow the system runs

In Tebelis the process isn't a document filed next to the form — it's part of the template. Each template carries its own workflow: the states a record moves through — say reported → under investigation → corrective action → verified → closed for a safety incident — which transitions are allowed from each state, and who owns each step.

Because the workflow is real, the system can enforce it:

  • Ownership is explicit. Each state is owned — by a person, a role, a group, or "whoever is named in the investigator field on this record." Only an owner can act at that step, so it's never ambiguous whose turn it is.
  • Hand-off is automatic. When a deviation is assessed and moves on to corrective action, the record lands in the next owner's tasks and they're notified. The baton is passed, not dropped.
  • The past locks. Fields captured at an earlier step freeze once the record moves on. A reviewer can't quietly rewrite what the person who reported the incident described; what the technician entered on the work order is exactly what the requester signs off.
  • Going back asks why. Send a record back a step — a corrective action rejected at verification, a work order bounced at sign-off — and the system requires a comment. The reason travels with the record, in its history, next to the state it came back from.
A documented process tells people what should happen. A workflow the system runs makes the right path the easy one: a record can only move the way you defined, to the people you chose, with the reasons attached.

You describe it; the agent wires it

You don't draw state machines. Tell the assistant "add a verification step owned by the maintenance supervisor, and require a comment if anything is sent back for rework" — or "a failed franchise audit escalates to the regional manager before re-inspection" — and it drafts the states, the transitions, the owners and the rules. You review and publish. Changing it later — a new approval, a different owner, an extra gate — is another sentence, not a project.

The process can evolve without rewriting history

Editing a template publishes a new version, and records already in flight keep the process they started under while new records pick up the change. An investigation opened last month finishes under last month's rules; this week's records follow the new ones. You can tighten the process on a Tuesday without invalidating everything mid-flight on Monday.

Where it fits

Setup gives you the structure (live in a day); capture gets clean data in (the fastest form); analysis gets answers out (from clipboard to insight). Workflow is what turns a pile of records into a process that actually runs — owned, ordered, auditable, carrying every incident, deviation and work order from raised to closed without anyone having to chase it.

See the agent do this in your own workspace.