Keep the lesson for the next incident
Document export semantics
Write source population, filters, selected fields, ordering, snapshot or generation time, time zone, format, encoding, null and precision rules, and intended consumers. Name intentional omissions or transformations. Keep the contract close to the export definition so consumers can reconcile it accurately.
Retain fidelity fixtures
Keep compact cases for empty and boundary populations, pagination, duplicates, nulls, long text, delimiters, Unicode, dates, numbers, and source movement where relevant. Assert identifiers and parsed values, not only file size or row count. Preserve expected serialized examples.
Review recurrence and ownership
Assign owners for source selection, export mapping, serialization, and downstream reconciliation as needed. Review changed identifiers, fields, totals, and generation timing across representative runs. Reopen investigation for a new unexplained difference or a source or format change outside the contract.
What to carry forward
Close the learning record with export semantics, fidelity fixtures, owners, and a recurrence trigger for changed rows, values, totals, or timing. Preserve intentional limitations as contract text. The durable result is faster reconciliation based on an honest snapshot and serialization boundary.
Keep the decision with the work.
Use a Work Item in Aglet to record the problem, the evidence you have, and the next decision. Add an owner and priority, then keep updates in the discussion so the next person can follow the reasoning.
Create an account See the product workflow