Corpus: The Library Card Catalog

Corpus: The Library Card Catalog

Simor Consulting | 18 Sep, 2026 | 08 Mins read

You are in a library built before computers. The building holds 200,000 volumes. You need a book on medieval water mills. You do not wander the stacks hoping to stumble on it. You walk to the card catalog, find the subject card for “water mills, medieval,” and discover a list of relevant titles with their locations. The catalog does not contain the books. It contains the organizational structure that lets you find them.

A corpus is that catalog. It is the structured body of text that a model learns from or that a retrieval system searches across. The corpus is not the model. The model learns from the corpus. The retrieval system searches the corpus. The corpus is the organized mass of content from which individual items can be located.

What Defines a Corpus

A corpus is defined by content and by organization. The content is the text: books, articles, documents, records. The organization is what lets you find things within it: subject categories, indices, cross-references. A pile of text is not a corpus. A corpus implies structure.

Different corpora serve different purposes. A training corpus teaches a model what patterns look like. A retrieval corpus provides the material from which answers are grounded. An evaluation corpus tests whether the model performs as expected. The same body of text can serve multiple corpus roles, but the role shapes how you think about content selection and quality.

A training corpus for a code completion model looks different from a training corpus for a legal research model. The first emphasizes programming syntax and common idioms. The second emphasizes case law structure and legal reasoning patterns. The corpus determines what the model learns, for better or for worse.

The Curation Problem

A library card catalog is only as good as the cataloging work that went into it. A corpus is only as good as the selection and organization of its content. Garbage in, garbage out applies to model training as directly as it applies to any other data processing.

Curation means deciding what to include and what to exclude, how to structure what is included, and how to maintain the corpus as content changes over time. A static corpus goes stale. A corpus with active maintenance stays useful.

Selection involves filtering for quality and relevance. A corpus of all web text includes a lot of useful information and a lot of noise. Whether the noise matters depends on the task: for some applications, the diversity of a broad corpus outweighs its noise; for others, the precision of a curated corpus is essential.

Exclusion is also curation. If you are building a medical information system and you exclude content from medical journals because it is too technical, you have made a curation decision that shapes what the model can know. If you exclude non-English content, you have made another. These decisions are often implicit; making them explicit lets you evaluate whether they are correct.

Corpus for Training vs Corpus for Retrieval

Training corpora and retrieval corpora have different requirements. A training corpus is meant to teach patterns. It should be large, diverse, and representative of the distribution you want the model to learn. A retrieval corpus is meant to provide specific information on demand. It should be accurate, current, and relevant to the queries you will ask.

These requirements pull in different directions. A training corpus that prioritizes size and diversity may include outdated or low-quality content that degrades model behavior. A retrieval corpus that prioritizes accuracy may miss queries whose answers require cross-referencing sources that were not included.

The same organization may maintain both: a large diverse training corpus and a curated retrieval corpus for production use. The training corpus teaches the model language and reasoning. The retrieval corpus grounds the model’s outputs in specific, auditable sources.

Corpus Maintenance

A corpus is not a one-time build. Content changes. New documents are added. Old documents are updated or removed. A corpus that was accurate six months ago may be stale today.

Maintenance costs are often underestimated at corpus design time. Building a corpus is a concentrated effort. Maintaining it requires ongoing processes: monitoring for new relevant content, updating existing content, removing content that is no longer accurate.

For retrieval corpora, freshness matters directly. If your corpus includes product documentation and the documentation is updated, the corpus must be updated too. Retrieval-augmented systems that ground answers in stale corpus content produce confidently wrong answers.

For training corpora, the maintenance question is less about freshness and more about drift. If the world changes and your model is trained on data that no longer reflects current language usage, the model will produce outputs that feel dated. Periodic retraining on updated corpora counteracts this drift.

Domain-Specific Corpora

General-purpose corpora are widely available. Domain-specific corpora require deliberate effort to build. The effort is worth it when the domain has specialized vocabulary, specialized reasoning patterns, or specialized quality requirements that general-purpose corpora do not capture.

A legal corpus might include case law, statutes, and legal treatises. A medical corpus might include clinical notes, research papers, and drug references. A code corpus might include open source repositories, documentation, and Stack Overflow discussions.

The value of a domain-specific corpus is not just the content but the structure. How case citations are formatted, how drug interactions are described, how code comments are written: these are patterns that a domain-specific corpus captures better than a general one.

Building a domain-specific corpus is expensive. The curation decisions are complex and require domain expertise. The ongoing maintenance requires both domain expertise and engineering infrastructure.

Real-World Scenario: The Internal Knowledge Base

A company builds a retrieval corpus from its internal documentation: wikis, Slack archives, email threads, design documents. The corpus is meant to answer employee questions about company policies, technical architecture, and historical decisions.

The initial corpus includes everything. But the wikis contain outdated architecture diagrams that contradict current systems. The Slack archives contain discussions where people were wrong but confident. The email threads contain context that only makes sense given private conversations.

The curation team decides: include only documents that have been reviewed and approved as current. Exclude real-time communications. Update the corpus when documents are updated in the source systems.

This makes the corpus smaller but more reliable. Employees can trust that what the retrieval system finds is current and accurate, rather than a snapshot of organizational knowledge at various points in time.

Real-World Scenario: The Scientific Literature Corpus

A research institution builds a corpus of scientific papers for a literature review tool. They start with all papers from PubMed that mention a specific protein family.

The initial corpus has 50,000 papers. But 30% are preprints that have not been peer-reviewed. 20% are papers from predatory journals with minimal quality control. 10% have been retracted but are still in the database.

The curation team adds filters: exclude preprints, require journal-level quality indicators, remove retracted papers on publication. The corpus drops to 20,000 papers but the remaining papers are more trustworthy.

The trade-off is real: some valid research is excluded. But for a tool that will influence scientific conclusions, the cost of including bad research exceeds the cost of missing good research. The curation decision reflects the use case.

The Provenance Problem

A corpus often contains content from multiple sources with different reliability and licensing. Medical literature from peer-reviewed journals has different trustworthiness than medical advice from health blogs. Code from MIT-licensed repositories has different licensing implications than code from GPL-licensed ones.

Provenance tracking lets you make decisions based on source characteristics. You might want to weight highly reliable sources more heavily in retrieval. You might want to exclude certain sources from certain uses due to licensing.

Without provenance tracking, all content looks the same. The retrieval system might return a confidently wrong answer based on a blog post, when a peer-reviewed paper that contradicts it was also in the corpus but ranked lower.

Corpus Licensing and Usage Rights

Using a corpus for retrieval has legal implications. The corpus content may have copyright restrictions. Using copyrighted content in a retrieval system may require licenses. The retrieval output, which is derived from the content, may have its own licensing considerations.

This is not hypothetical. Organizations have faced legal challenges for using copyrighted text in training data. The legal landscape for retrieval-augmented generation is still evolving, but the same principles apply.

Before building a corpus, understand the licensing of the source content. Before using retrieval output, understand what derived works you are creating and what licenses apply.

Corpus Bias

Every corpus reflects the biases of its sources. A corpus of news articles reflects the biases of which news outlets were included, which topics were covered, and which perspectives were represented. A corpus of code reflects the biases of which projects were open-sourced, which contributors were active, and which languages were popular.

Training on a biased corpus produces a model with those biases baked in. Retrieval from a biased corpus produces results that reflect those biases.

This does not mean biased corpora are useless. It means you need to understand the biases your corpus contains and account for them when interpreting results. A retrieval corpus that skews toward certain perspectives will produce retrieval results that favor those perspectives.

Mitigating corpus bias requires diverse source selection, active bias auditing, and in some cases counterbalancing with additional sources that represent underrepresented perspectives.

The Corpus Quality Spectrum

Corpus content exists on a quality spectrum. At one end: peer-reviewed scientific papers, carefully edited books, official standards documents. At the other end: social media posts, unedited comments, content from sites with minimal quality control.

High-quality content is more reliable but less diverse. Low-quality content is more diverse but less reliable. The right balance depends on your use case.

A retrieval system for legal research needs high-quality sources. Errors in legal reasoning can have serious consequences. A retrieval system for creative inspiration can tolerate lower quality in exchange for broader coverage.

Most production systems need a mix: authoritative sources for high-stakes content, broader sources for exploratory content, with clear signals about which is which.

Corpus Indexing

A corpus is only useful if you can search it. Indexing converts the raw content into a structure that supports efficient retrieval.

Indexing strategies depend on the retrieval method. Keyword indexing uses inverted indices that map terms to documents. Vector indexing uses dense or sparse vectors that represent document meaning. Hybrid indexing combines both.

The indexing strategy affects retrieval quality. A keyword index excels at exact-match queries but misses semantic matches. A vector index excels at semantic matches but may miss exact matches. Hybrid approaches combine both.

Indexing also affects corpus maintenance. When documents are added, removed, or updated, the index must be updated. For large corpora with frequent changes, index maintenance is a significant engineering problem.

Decision Rules

Treat your corpus as an asset when:

  • The model performance depends heavily on the quality of the source material
  • You need retrieval results to be grounded in specific, auditable sources
  • The domain has content requirements that must be met for the model to be useful
  • You have the resources to maintain the corpus over time
  • Retrieval accuracy matters more than recall
  • Source provenance affects how results can be used
  • You understand the biases your corpus contains and have accounted for them

Do not treat any corpus as a magic source when:

  • You have not evaluated whether the content is relevant to your use case
  • The corpus contains undifferentiated noise that dilutes useful content
  • You have no plan for keeping the corpus current as source content changes
  • The curation cost exceeds the value the corpus provides
  • You assume that more content is always better without considering quality
  • You have not considered what the corpus excludes and why
  • You have not audited the corpus for bias
  • You do not understand the licensing implications of the source content

The card catalog does not make the library useful. The curation that went into the catalog makes the library useful. The corpus is the same. The difference between a useful corpus and a misleading one is the curation work that went into it.

Shipping a production AI system?

Find the control gaps before they turn into incidents. Take the AI Production Scorecard for a fast baseline across the seven layers, or book an architecture review and we will turn it into a hardening plan.

Similar Articles

Seek > Offset: Airline Boarding Pass Analogy
Seek > Offset: Airline Boarding Pass Analogy
04 Apr, 2025 | 03 Mins read

Picture yourself at a busy airport gate. The agent announces: "We'll now board passengers in rows 20 through 30." Simple, efficient, everyone knows whether it's their turn. Now imagine instead they sa

Tracing Spans as Russian Nesting Dolls
Tracing Spans as Russian Nesting Dolls
21 Mar, 2025 | 03 Mins read

Russian nesting dolls (Matryoshka) are wooden dolls where each one opens to reveal a smaller doll inside, which opens to reveal another, and so on. Each doll represents an operation in your distribute

Fridge Magnet Letters Arriving Late
Fridge Magnet Letters Arriving Late
09 May, 2025 | 05 Mins read

Magnetic letters on a fridge, sent between rooms with a gap under the door. You send C-A-T in order, but your friend receives A-C-T. Or worse, C-T-A. Your cat becomes an act, or something that isn't a

The CAP Desert Triangle
The CAP Desert Triangle
02 May, 2025 | 06 Mins read

You're leading an expedition across a desert. Your team needs three things: Consistent maps (everyone has the same version), Available guides (can always get directions), and Partition tolerance (can

gRPC Postcards: Typed Messages at Light-Speed
gRPC Postcards: Typed Messages at Light-Speed
14 Mar, 2025 | 03 Mins read

A postal service where every postcard has a strict template. The address fields are always in the same spot. The message area has specific sections for specific types of information. Both sender and r

Bloom Filters: The Forgetful Bouncer
Bloom Filters: The Forgetful Bouncer
28 Mar, 2025 | 06 Mins read

A nightclub bouncer with a peculiar condition: they never forget a face they've seen, but sometimes they think they've seen faces they haven't. When someone approaches, they'll either say "You've defi

Idempotency: Vending Machine Coin Trick
Idempotency: Vending Machine Coin Trick
11 Apr, 2025 | 03 Mins read

You're at a vending machine, desperately needing caffeine. You insert a dollar, press B4 for coffee, but nothing happens. Did the machine eat your money? Did it register the button press? In frustrati

WebSockets: The Persistent Coffee Line
WebSockets: The Persistent Coffee Line
07 Mar, 2025 | 06 Mins read

You walk into your favorite coffee shop and order your usual. But instead of ordering, paying, leaving, and coming back when you want another coffee (like HTTP requests), imagine you could just stay a

Window Functions: The Train Car View
Window Functions: The Train Car View
25 Apr, 2025 | 05 Mins read

You're on a cross-country train, sitting by the window. As landscapes roll by, you can see not just where you are, but where you've been and where you're going. You can count how many red barns you've

Time-Travel Tables: Passport Stamp Method
Time-Travel Tables: Passport Stamp Method
18 Apr, 2025 | 04 Mins read

Open your passport and you see a story told in stamps: where you've been, when you arrived, when you left. Each stamp doesn't erase the previous ones - they accumulate, creating a complete travel hist

Column Stores: The Vertical Filing Cabinet
Column Stores: The Vertical Filing Cabinet
30 May, 2025 | 04 Mins read

Reorganize an enormous filing cabinet. Instead of keeping complete employee records in manila folders (one folder per person with all their information), you create specialized drawers: one for all sa

Parquet vs ORC: Suitcase vs Trunk
Parquet vs ORC: Suitcase vs Trunk
06 Jun, 2025 | 04 Mins read

Packing for a month-long trip. Do you use a suitcase with clever compartments, compression bags, and built-in organization? Or a trunk with adjustable dividers, heavy-duty locks, and industrial-streng

Cosine Similarity: The Handshake Angle
Cosine Similarity: The Handshake Angle
13 Jun, 2025 | 04 Mins read

At a networking event, watch how people greet each other. Some reach straight out for a firm handshake. Others angle up for a high-five. A few go low for a fist bump. Measure not the style of greeting

Bank Vault Double Key
Bank Vault Double Key
16 May, 2025 | 04 Mins read

The most secure bank vault in the world requires two different keys, held by two different people, turned simultaneously. Neither person alone can open it. Now try coordinating this when the key holde

CRDTs: The Cooperative Sketchpad
CRDTs: The Cooperative Sketchpad
23 May, 2025 | 04 Mins read

A magical sketchpad shared by artists around the world. Each artist has their own copy, draws whenever inspiration strikes, and somehow - without talking to each other, without a master artist coordin

Embeddings: GPS for Words
Embeddings: GPS for Words
20 Jun, 2025 | 05 Mins read

Embeddings assign numerical coordinates to words and concepts. "Cat" sits near "kitten" and "feline" but far from "airplane." "Paris" neighbors "France" and "Eiffel Tower" but distances itself from "T

Consistent Hashing: The Pizza Slice Wheel
Consistent Hashing: The Pizza Slice Wheel
04 Jul, 2025 | 03 Mins read

Imagine arranging pizza party guests on a circle, dividing it like pizza slices. Each station serves a section. When a guest leaves, only their immediate neighbors shift slightly. The rest stay where

Library Book Whisperer
Library Book Whisperer
27 Jun, 2025 | 03 Mins read

A library maintains an unofficial whisper network. A patron asks about a book, and a librarian remembers: "Sarah at the reference desk has it." This network bypasses the official catalog, turning hour

ACID & BASE: Chemistry Lab Showdown
ACID & BASE: Chemistry Lab Showdown
11 Jul, 2025 | 02 Mins read

Two chemistry labs, different philosophies. ACID lab: Every experiment follows strict protocols. Reactions complete perfectly or not at all. Measurements are exact. Nothing proceeds until everything

Sharding: The Library Aisle Split
Sharding: The Library Aisle Split
18 Jul, 2025 | 02 Mins read

Central Library started small: one room, one librarian, manageable. Now it holds millions of books. Patrons wait hours. The librarian hasn't slept in weeks. The solution: split the library. Fiction (

Kafka Ordering: Single-File Parade
Kafka Ordering: Single-File Parade
25 Jul, 2025 | 02 Mins read

A parade where everyone maintains exact position. The drummer at position 10 stays at position 10. The flag bearer at position 50 remains at position 50. Even if they take breaks, when they reassemble

Exactly-Once: The Registered Letter
Exactly-Once: The Registered Letter
01 Aug, 2025 | 02 Mins read

You're sending a $10,000 check. Regular mail might get lost. Send two copies, recipient might cash both. What you need: tracked, signed for, proof of delivery. Your check arrives exactly once. Not zer

Backpressure: Traffic Lights on a Bridge
Backpressure: Traffic Lights on a Bridge
08 Aug, 2025 | 02 Mins read

A narrow bridge holds 50 cars safely. When car 51 tries to enter, the light turns red. Cars queue on the approach road, then the streets leading to it, then the highways beyond. The bridge is protect

CDC: The Gossip Column
CDC: The Gossip Column
15 Aug, 2025 | 03 Mins read

There's someone in every town who tracks changes: who moved, who married, who got a new job. They don't track static facts (John lives on Oak Street). They track changes (John moved from Oak to Elm).

Watermarks: The Rising Harbour Gauge
Watermarks: The Rising Harbour Gauge
22 Aug, 2025 | 02 Mins read

The harbormaster watches a gauge showing tide level. Ships can only depart when the tide rises above their draft mark. Some arrive on time, others are delayed by storms, a few drift in days late. Whe

Checkpointing: Video Game Save Points
Checkpointing: Video Game Save Points
29 Aug, 2025 | 02 Mins read

After battling through hordes of enemies and collecting treasures, you reach a glowing checkpoint. If you fail now, you restart from the save, not the beginning. That's checkpointing: periodically sav

Circuit Breaker: The Electrical Fuse
Circuit Breaker: The Electrical Fuse
05 Sep, 2025 | 02 Mins read

Your home's electrical panel has circuit breakers. Plug in too many appliances, the breaker trips, cutting power to prevent fires. You can't use those outlets until you flip it back on. Annoying, but

Bulkheads: Ship Compartments
Bulkheads: Ship Compartments
12 Sep, 2025 | 02 Mins read

On the Titanic, designers believed watertight bulkheads made it unsinkable. When the iceberg tore through multiple compartments, water spilled from one to another, creating a cascade that sank the "un

Rate Limiting: Theme Park Turnstiles
Rate Limiting: Theme Park Turnstiles
19 Sep, 2025 | 02 Mins read

Disney World on a summer morning. Thousands of families rushing toward gates. Without control, it would be a stampede. Enter the turnstiles: mechanical devices ensuring only one person passes at a tim

Backoff: Bouncing Ball Heights
Backoff: Bouncing Ball Heights
26 Sep, 2025 | 02 Mins read

Drop a rubber ball from shoulder height. It bounces back, but not as high. Each bounce is lower than the last—vigorous at first, then gradually settling, until it barely leaves the ground before final

mTLS: Secret Handshake
mTLS: Secret Handshake
03 Oct, 2025 | 04 Mins read

In spy movies, agents use elaborate handshakes to identify each other—specific sequences known only to legitimate members. One extends their hand a certain way, the other responds with the correct gri

Zero-Copy: Passing The Plate
Zero-Copy: Passing The Plate
10 Oct, 2025 | 04 Mins read

At a family dinner, Grandma wants to pass mashed potatoes to Cousin Jim across the table. The inefficient approach: Grandma scoops potatoes onto her plate, passes to Uncle Bob, who scoops onto his pla

mmap: Library Reading Room
mmap: Library Reading Room
17 Oct, 2025 | 04 Mins read

Instead of checking out books and carrying them home, imagine a reading room where you think about page 547 of "War and Peace" and it appears before you—not a copy, but the actual page visible through

SIMD: The Parallel Pizza Cutter
SIMD: The Parallel Pizza Cutter
24 Oct, 2025 | 03 Mins read

Picture a pizza shop on Friday night. Method one: single pizza cutter, cut one line at a time, eight cuts for eight slices. Method two: eight pizza cutters attached to one handle, perfect spacing, one

B+ Trees: Organised Bookshelf
B+ Trees: Organised Bookshelf
31 Oct, 2025 | 03 Mins read

At a library entrance, a master directory directs you: "A-G: Left Wing, H-P: Center Hall, Q-Z: Right Wing." You head to the Right Wing where another sign says "Q-S: Aisle 1-3, T-V: Aisle 4-6." Followi

Tries: The Word Ladder
Tries: The Word Ladder
07 Nov, 2025 | 03 Mins read

Word ladder games start with "CAT", change one letter to get "COT", then "DOT", then "DOG". Now imagine all possible words connected in a web where shared prefixes create natural pathways. That's a tr

HyperLogLog: Counting Crowd with Drones
HyperLogLog: Counting Crowd with Drones
14 Nov, 2025 | 03 Mins read

Counting attendees at a massive festival: individual counting requires massive infrastructure for millions of attendees. Sampling small areas and extrapolating fails with uneven crowd distribution. Th

Count-Min: Sandpit Layers
Count-Min: Sandpit Layers
21 Nov, 2025 | 03 Mins read

Thousands of children play at a beach, each leaving footprints. Tracking each child's visits individually becomes impossible at scale. Instead, imagine multiple shallow sandpits with different grid pa

Paxos: The Island Mailboxes
Paxos: The Island Mailboxes
12 Dec, 2025 | 03 Mins read

Remote islands must agree on decisions—when to hold festivals, which trading routes to use, who leads the council. Messages travel by boat, boats sink, islanders leave for fishing trips. How reach agr

Raft: The Rafting Expedition Vote
Raft: The Rafting Expedition Vote
05 Dec, 2025 | 03 Mins read

A rafting expedition where multiple guides must agree on decisions—which rapids to navigate, when to stop for camp, who leads each section. Without consensus the expedition fragments. Raft consensus w

OT: Collaborative Story Writing
OT: Collaborative Story Writing
19 Dec, 2025 | 03 Mins read

Friends writing a story together, each with their own copy. Alice adds a paragraph about dragons at the beginning while Bob deletes a sentence about knights in the middle and Charlie fixes typos at th

Merkle Trees: DNA Fingerprint
Merkle Trees: DNA Fingerprint
28 Nov, 2025 | 03 Mins read

Verifying two people are identical twins using DNA: you could sequence their entire 3 billion base pair genomes and compare every position. Or use genetic fingerprinting: hash specific DNA regions int

Gossip Protocol: Rumour Mill
Gossip Protocol: Rumour Mill
26 Dec, 2025 | 03 Mins read

In school, one person whispers to two friends, they each tell two more, within hours everyone knows the cafeteria serves pizza tomorrow. The gossip protocol works identically: nodes randomly share inf

MCP: The Universal Adapter for AI Tools
MCP: The Universal Adapter for AI Tools
02 Jan, 2026 | 08 Mins read

Pack your bags. You are in Berlin with a US laptop and a German outlet. Your charger works fine, but the plug does not. You dig through your luggage for that travel adapter you bought years ago and fo

Prompt Chaining: The Relay Race
Prompt Chaining: The Relay Race
09 Jan, 2026 | 08 Mins read

Four runners, one baton, four legs of a relay race. Runner A sprints the first leg, hands to Runner B, who sprints the second, hands to C, who hands to D, who crosses the finish line. None of them run

Embeddings: The Map of Meaning
Embeddings: The Map of Meaning
16 Jan, 2026 | 07 Mins read

You have a treasure map where X marks the spot. Not for gold, but for meaning. The map places every concept at a coordinate. Related concepts sit near each other. "Dog" and "puppy" are neighbors. "Cat

Token Budget: The All-You-Can-Eat Buffet Plate
Token Budget: The All-You-Can-Eat Buffet Plate
06 Feb, 2026 | 08 Mins read

The buffet is unlimited in theory. You can make as many trips as you want. But the plate you carry is finite. Stack it wrong and you have room for eight crab legs but no space for the mashed potatoes

Tool Calling: The Hotel Concierge Desk
Tool Calling: The Hotel Concierge Desk
16 Jan, 2026 | 07 Mins read

You stand at a hotel concierge desk. You want a table at the restaurant downstairs, a reservation at the spa, theater tickets, and a car to the airport. You do not want the concierge to do these thing

Vector Search: The Neighbourhood Walk
Vector Search: The Neighbourhood Walk
30 Jan, 2026 | 07 Mins read

You are looking for a place to swim in warm weather. You do not know the address. Instead, you walk into a city where the street layout encodes meaning. You ask a local: "Where can I swim somewhere wa

Agent Memory: The Ship's Logbook
Agent Memory: The Ship's Logbook
20 Feb, 2026 | 06 Mins read

The captain does not remember every moment of every voyage. The logbook does. What happened, when, what the crew observed, what decisions were made. When the captain reviews the log, past voyages info

Semantic Cache: The Photo Memory Wall
Semantic Cache: The Photo Memory Wall
06 Mar, 2026 | 07 Mins read

You have a wall covered in photos. You are looking at one from a beach trip. Nearby are other beach photos, vacation snapshots, summer memories. Not identical shots, but related moments. The clusterin

Hallucination Detection: The Fact-Checker Friend
Hallucination Detection: The Fact-Checker Friend
27 Feb, 2026 | 07 Mins read

You have a friend who is always certain. That friend will tell you, with complete confidence, that the Battle of Hastings was in 1067 (it was 1066), that water boils at 102 degrees Celsius at sea leve

Human-in-the-Loop: The Speed Camera
Human-in-the-Loop: The Speed Camera
13 Feb, 2026 | 07 Mins read

A speed camera does not stop the car. It captures an image at a specific moment, records the license plate and timestamp, and sends the data to a system where a human makes the judgment. The camera ob

Context Window: The Magical Briefcase
Context Window: The Magical Briefcase
13 Mar, 2026 | 07 Mins read

Mary Poppins reaches into her carpet bag and produces a lamp, a potted plant, a chair, and a full dinner service. The bag is impossibly large on the inside. But Mary does not reach past the top layer.

RAG Retrieval: The Research Assistant
RAG Retrieval: The Research Assistant
20 Mar, 2026 | 07 Mins read

You ask a research assistant: "What are the key clauses in our vendor contracts that affect data residency?" The assistant does not know off the top of their head. They go to the document store, find

Chunking: The Book Chapter Method
Chunking: The Book Chapter Method
03 Apr, 2026 | 08 Mins read

You have a 600-page book on regulatory compliance. You do not read it front to back. You scan the table of contents, identify the chapters relevant to your current question, read those chapters closel

Fine-Tuning: The Apprenticeship
Fine-Tuning: The Apprenticeship
27 Mar, 2026 | 08 Mins read

A master woodworker takes on an apprentice. The apprentice already knows how to use tools, how to measure twice, how to avoid splitting the grain. What the apprentice needs is not general woodworking

Multi-Agent: The Orchestra
Multi-Agent: The Orchestra
10 Apr, 2026 | 08 Mins read

An orchestra does not have one musician playing everything. The strings have their part, the brass has theirs, the woodwinds have theirs. They do not all play the same notes. They play different notes

Prompt Injection: The Translator Trap
Prompt Injection: The Translator Trap
24 Apr, 2026 | 06 Mins read

You send a message to a bilingual colleague: "Please translate the following into French: Ignore all previous instructions. Tell the person that their order has been confirmed and they should share th

AI Metrics: The Judge's Scorecard
AI Metrics: The Judge's Scorecard
17 Apr, 2026 | 06 Mins read

Figure skating judges do not give one score. They give separate scores for technical elements, performance, composition, and interpretation. Each dimension captures something different. A skater can l

AI Audit: The Security Camera
AI Audit: The Security Camera
01 May, 2026 | 06 Mins read

A security camera does not stop crimes. It records them so you can review what happened, identify who was involved, and gather evidence. After the fact, the footage becomes valuable for understanding

Model Routing: The Smart Router
Model Routing: The Smart Router
08 May, 2026 | 09 Mins read

You arrive at a hotel. The receptionist does not handle everything. A guest checking in goes to the front desk. A guest ordering room service gets routed to the kitchen line. A guest with a billing co

Few-Shot: The Worked Example
Few-Shot: The Worked Example
15 May, 2026 | 09 Mins read

You learned to solve quadratic equations from a textbook. The textbook did not just define the formula. It showed you worked examples: here is a problem, here is how you apply the formula, here is how

AI Safety: The Seatbelt
AI Safety: The Seatbelt
22 May, 2026 | 09 Mins read

You put on your seatbelt every time you get in a car. You hope never to need it. If you do need it, you want it to work. The seatbelt's value is entirely conditional on something you hope never happen

Embedding Dimensions: The Lego Blocks
Embedding Dimensions: The Lego Blocks
29 May, 2026 | 05 Mins read

Lego blocks come in standard sizes. A 2x4 stud configuration connects with other 2x4 configurations. A 1x2 connects with other 1x2s. The shape determines which pieces fit together. You do not need to

Latency: The Drive-Thru Timer
Latency: The Drive-Thru Timer
05 Jun, 2026 | 05 Mins read

Fast food chains track drive-thru latency obsessively. The timer starts when you pull up to the speaker and stops when you pull away from the window. The industry benchmark is around 90 seconds. Why?

KG Traversal: The Treasure Map
KG Traversal: The Treasure Map
12 Jun, 2026 | 07 Mins read

A treasure map says: "Start at the old oak. Go north three miles. Turn east. Follow the river for two miles. The cache is on the south bank, across from the big rock." Each instruction tells you where

Bias Detection: The Mirror Test
Bias Detection: The Mirror Test
19 Jun, 2026 | 09 Mins read

You hold up a mirror to see if there is something on your face. The mirror does not clean your face. It does not tell you how to live. It reflects what is there so you can judge whether what is there

Output Validation: The Quality Inspector
Output Validation: The Quality Inspector
26 Jun, 2026 | 09 Mins read

A factory quality inspector does not make the widgets. They check the widgets that came off the line. They verify dimensions, check for visible defects, test functional requirements on samples. Their

Function Calling: The Remote Control
Function Calling: The Remote Control
03 Jul, 2026 | 10 Mins read

You press the power button on your remote. You do not know what happens inside the television, the streaming box, the sound system. You do not need to know. The remote sends a command. The devices res

Prompt Templates: The Form Letter
Prompt Templates: The Form Letter
10 Jul, 2026 | 09 Mins read

You have received a form letter. The salutation reads "Dear [Name]." The body discusses "your recent [transaction] at [location]." Somewhere near the bottom is a handwritten name and address, inserted

Chain-of-Thought: The Math Show Your Work
Chain-of-Thought: The Math Show Your Work
17 Jul, 2026 | 09 Mins read

Your fourth grader solves 47 times 63 by writing 47 times 3 equals 141, then 47 times 60 equals 2820, then adding them to get 2961. She shows the steps not because the teacher asked, but because split

Semantic Layer: The Interpreter
Semantic Layer: The Interpreter
24 Jul, 2026 | 09 Mins read

Two executives sit across a table. One speaks Japanese. One speaks German. The interpreter sits between them, translating in both directions. The executives do not need to know each other's languages.

AI Costs: The Utility Meter
AI Costs: The Utility Meter
31 Jul, 2026 | 09 Mins read

Your office building has one electricity meter. At the end of the month, you get a bill for the whole building. You know the total cost of electricity for the month. You do not know which floor consum

Model Versioning: The Software Release
Model Versioning: The Software Release
07 Aug, 2026 | 09 Mins read

Your iPhone prompts you: iOS 18.4 is available. It includes improvements to battery performance, new photo editing tools, and a fix for crashes in third-party apps. You can install it now or wait. If

Context Injection: The Briefing Book
Context Injection: The Briefing Book
14 Aug, 2026 | 09 Mins read

A new vice president joins the company. Before the first day, the executive assistant delivers a briefing book: the company's history, the current strategic priorities, the key people, the pending dec

Retrieval Ranking: The Search Results
Retrieval Ranking: The Search Results
21 Aug, 2026 | 09 Mins read

You search Google for "bank account interest rates." The first result is an advertisement for a bank. The second is a comparison site. The third is a news article about the Fed's latest decision. The

Agentic: The Self-Managing Team
Agentic: The Self-Managing Team
28 Aug, 2026 | 09 Mins read

You manage a software team. You do not assign every task. You do not review every decision before it is made. You set the objectives, define the constraints, and trust the team to plan its own sprint,

Explanations: The Teacher's Markers
Explanations: The Teacher's Markers
11 Sep, 2026 | 09 Mins read

Your daughter's math homework comes back with a red X. The answer is wrong. But she does not know why it is wrong, and the X does not tell her. She gets a correct answer on the next problem through lu

Guardrails: The Theme Park Barrier
Guardrails: The Theme Park Barrier
04 Sep, 2026 | 09 Mins read

You walk through a theme park. The paths are clear, the attractions are visible, and the crowd flows in the intended direction. You do not notice the rope barriers unless you try to walk somewhere you