Data quality Rule agents

A rule is the smallest agent.

A quality rule in Lima is a sentence that says what to check, where and when. Saved, it becomes a rule agent: it runs on its schedule over its scope, produces findings with evidence, and may propose or apply a fix according to the level of autonomy it has earned.

ONE SENTENCE IN“Lead time must be 1 to 180 daysfor active plant materials,checked nightly.”typed by the steward · tested on live rows before it is savedTHE THREADWHATlead time between 1 and 180WHEREMARC where status = activeWHENnightly 02:00 · and on changeONE RULE AGENTlead-time-range · plant materialsautonomy L1 · proposescope42,318 rows in 14 plantsguardconfidence ≥ 0.9 · four eyes on writesescalationplanning CoE screeneval38 golden cases · 97% passFindings → tickets with the evidence snapshot → a proposed fix → the decision → the write-back with its acknowledgementthe same eight blocks describe every agent: mission · scope · directives · tools · trigger · guards · escalation · eval
One sentence becomes a rule thread with a what, a where and a when, and runs as one rule agent with a scope, guards, an escalation route and an evaluation.
3
parts of a rule thread: what, where, when
product
8
blocks every agent shares
product
95%
pass rate on golden cases required before an agent may act with approval
product
0
rows written during a dry run
product
From sentence to agent

Five steps, each visible on screen

Write the sentence“Lead time must be 1 to 180 days for active plant materials, checked nightly.” Plain words; the platform reads the what, the where and the when from it and shows what it understood.

The sentence form is deliberate. The people who know what a correct record looks like are stewards, planners and controllers, and a sentence is the form they already use. The platform's job is to turn the sentence into a testable thread and to show its reading back, so a misunderstanding is caught before the rule runs.

The dry run is the second safeguard. Every rule is executed against live rows with writing disabled before it is saved, so the steward sees the rows it would flag. A threshold that is too tight or a scope that is too wide shows up as a number that looks wrong, and the sentence is adjusted on the spot.

Rules written this way are the same rules the rules page describes at three levels: column rules on one field, row rules across a record, business rules over totals and across tables. What this page adds is how each of them lives as an agent.

The eight blocks

Every agent, from a one-line rule to a correction service, is described the same way

This is what makes the fleet manageable: one register, one detail page, one set of registers behind them.

BlockWhat it holdsFor the lead-time rule
MissionWhat the agent is for, in a sentenceKeep lead times of active plant materials inside 1 to 180 days
ScopeThe tables, rows and fields it may look atPlant materials, status active, 14 plants, 42,318 rows
DirectivesThe testable rules it appliesLead time between 1 and 180; a value of 0 is a finding, a blank is a completeness finding
ToolsWhat it may call, each with a mode: read, propose, writeRead the table; propose a value from the supplier's quoted lead time; write through the released material interface
TriggerWhen it runs: interval, calendar, event or on requestNightly 02:00 and on change of the field
GuardsHard checks on every proposed actionConfidence at least 0.9; 500 writes a day; four eyes on writes
EscalationThe screen and the people a finding goes to for a decisionThe planning centre of excellence review screen, hop SLA 24 hours
EvalGolden test cases replayed against the agent, with the pass rate38 cases; 97% pass; last run this morning
Rules as a fleet

Thousands of small agents, managed like one

A domain with forty fields and ten plants has hundreds of rule instances. They stay manageable because they share the eight blocks and are minted from packs.

A rule pack is a bundle of rule templates that is stamped across a scope: three templates across fourteen plants mint forty-two rule instances in one action, each with its own findings and its own acceptance rate. A local edit to one instance is tracked as drift and shown at the next publish of the pack, so a plant's exception is visible to the pack owner. The configuration page covers packs in full.

The register shows the fleet by domain, by level, by acceptance rate and by last run. A rule whose findings are always rejected is a candidate for rewriting; a rule whose proposals are always accepted is a candidate for promotion. Both are visible from the register itself.

Rule agents · materials · 14 plants27 agents4 at L3acceptance 89%
rulelevelscopefindings (7d)acceptedlast run
lead-time-rangeL242,3181,20497%02:00
moq-positiveL342,3188899%02:00
planner-assignedL142,3182,91071%02:00
uom-validL361,00412100%on change
gross-weight-presentL138,1105,40258%02:00
Terms on this page

Rule threadOne rule bound to a place and a schedule: what, where, when.
DirectiveA testable plain-language rule inside an agent.
Dry runExecution against live rows with writing disabled; the agent narrates what it would do.
EvalGolden test cases replayed against an agent; the pass rate gates promotion.
RegisterThe list page of all agents of one kind, with the same actions as the detail page.
DriftA pack-managed rule instance edited by hand; tracked and shown at every publish.
Questions

Can a rule call an outside service?

Through a tool grant: verification services, registries and the platform's own match engine are tools with a mode (read, propose, write) granted per agent. The verification page lists the services.

What happens when two rules disagree?

A finding carries the rule that raised it, so two findings on one field are shown together on the ticket. Where two agents propose different values, the case goes to a person, or to a weighted arbitration inside a spread the owner has set.

Who may write a rule?

Anyone with the steward role on the domain writes and dry-runs; saving a rule that writes to a source needs the domain owner's stamp, because the write-back is a change to a system of record.

How is the sentence understood?

The reading is shown back as the three parts of the thread before anything is saved, and the dry run shows the rows it selects. Where the sentence is ambiguous the platform asks one question, in the same screen.

See quality run on your own domain

Bring one domain and two systems. In a week the sources are profiled, the ten costliest fields are under rules, the first corrections are written back with their acknowledgements and the publish gate is on.