Messages that keep their meaning across teams and systems.
Make sense of connected systems.
Practical field notes on communication, applied AI and data. Understand a design choice, examine its tradeoffs and find the next useful question.
Browse the libraryMeaning travels through the whole system. Good interfaces make each handoff visible.
Topics
Six connected fields, sixty focused notes.
Retrieval and evaluation before another layer of automation.
Reliable paths from a source record to a useful dataset.
Measurements that support a decision and expose uncertainty.
Clear ownership, traceable changes and proportionate access.
Interfaces and recovery plans that survive ordinary failures.
Start with a useful question
What must a message preserve? What makes an AI answer testable? Which measurement changes a decision?
An event needs more than a payload. Its identity, origin and creation time let a receiver interpret it without guessing which application produced it. Keep these shared fields separate from the business data so that transport changes do not alter their meaning.
Message designA retrieval system does not usually pass an entire document to a language model. It selects smaller pieces. The boundary of each piece affects whether a retrieved passage still contains the definitions, qualifications and context needed to answer a question.
RetrievalA metric is a rule for counting or calculating, not merely a label on a dashboard. People can use the same name for different populations, time windows or exclusions. A written definition makes comparisons possible and reduces arguments that are really about meaning.
Measurement