Glossary
81 recurring concepts behind the writing. These are the same definitions that expand inline when you hover them in any essay.
- agent wallet
-
Payment infrastructure that issues spending authority to an autonomous software agent, with per-transaction limits and a machine-readable record of what it bought and why.
It closes the trust problem the corporate card left open: the authorisation and the purchase become the same event.
- AI employee
-
Software that is role-scoped, agentic, and accountable — it owns a task end to end, takes real actions, and logs every one to an auditable record.
The word "employee" is doing real work here: a role, a scope, and accountability for an outcome — not a chat window.
- AI-complete
-
A workflow where the AI owns the task end to end — it does the thing, rather than helping a person do the thing faster.
It is the only version that changes an institution’s capacity rather than its cycle time.
- answer surface
-
Any place a product puts an explanation in response to something you were reading: a side panel, a floating overlay, an AI summary above the search results.
They compete on how close the answer gets. The argument is that closeness was never the binding constraint.
- approval chain
-
The sequence of humans a routine request must pass through before it can proceed — each of whom is nominally checking it, and most of whom are signing it.
Its real cost is rarely the reviewers’ time. It is the days the request spends waiting.
- audit trail
-
A durable, ordered record of who did what, when, and on what authority — reconstructable after the fact by someone who was not there.
A system that writes one is more accountable than a reviewer who signs without reading; that is the whole of the accountability argument.
- Bounding box
-
A rectangle on the map defined by four coordinates (west, south, east, north), used to say "give me everything inside this area" when querying geographic data.
Approximate by nature — fine for ratios and composition, misleading for absolute counts near the edges.
- Building footprint
-
The outline of a building as seen from directly above — a polygon on a map, with no height information. The basic unit of every open buildings dataset.
Footprints are what satellites and volunteers can actually produce at scale; everything else (height, use, condition) has to be measured separately or estimated.
- BYOK
-
Bring Your Own Key — an architecture where the user supplies their own API credentials, so their queries go directly to the model provider and never accumulate on the tool’s servers.
If the record of what confused you is the most intimate data you produce, the only honest design is one that never holds it.
- CBD
-
Central Business District — Nairobi's dense commercial core around KICC, Times Tower and Kenyatta Avenue; the best-mapped square kilometers in the country.
It's where every dataset is richest — which makes it a misleading place to judge data coverage from.
- CBDC
-
Central bank digital currency — money issued directly by a central bank in digital form, as opposed to a bank deposit or a private token.
Every few months a new paper promises a CBDC will solve African financial inclusion. It is years of regulation away; the problem is not.
- Community Health Promoter
-
A trained, community-based health worker in Kenya’s national programme, responsible for a defined roster of households, monthly visits, referrals and data collection.
Roughly 100,000 of them are the state’s only routine contact with most households — and they report on paper.
- community-based organisation
-
A small, locally-run organisation operating in the community its members come from — the commonest form of civil society in Kenya, and the one least equipped for formal registration.
It is the organisation every compliance regime says it wants to include and every compliance form is designed to exclude.
- compliance checking
-
Reading a document against a fixed list of required provisions and reporting which are present, which are absent, and which are ambiguous — a matching problem, not a judgement one.
The distinction from legal reasoning is the whole point: one needs expert oversight to be trustworthy, the other is already reliable.
- compliance gap
-
The distance between what a regulation requires and what an ordinary regulated organisation can actually produce — measured in documents, not in intent.
Almost everyone reads it as evasion. It is nearly always capability.
- Constituency Development Fund
-
A share of national revenue allocated to each Kenyan constituency for local projects, administered through the MP’s office and a local committee.
It makes a constituency office a spending institution, not just a political one — and it is run, in most constituencies, out of a WhatsApp group.
- context-switch tax
-
The cost of leaving what you were doing and coming back to it — not the seconds spent away, but the reconstruction of where you were.
It is the quantity every answer-surface design is implicitly trading against, and almost none of them measure.
- dark pattern
-
An interface deliberately designed to push a user toward a choice they would not otherwise make — a decoy tier, a pre-ticked box, urgency that is not real.
Every one of them is an exploit against a human cognitive bias, which is why an agent buyer is immune by construction.
- devolution
-
Kenya’s 2010 constitutional transfer of major functions — health, water, local roads — from national government to 47 county governments.
It multiplied by 47 the number of institutions that need an operating layer, and none of them inherited one.
- digital transformation
-
The programme of making existing organisational processes faster and cheaper through technology, without changing what the processes are.
Most of what is now announced as AI transformation is this, renamed.
- Digital twin
-
A virtual model kept in live sync with one real physical thing — a term from NASA engineering, not 3D graphics. A city twin is only a twin if the data underneath is real and current.
Most things called digital twins are renderings. The rendering is the easy half.
- due diligence
-
The checks a funder runs on an organisation before releasing money — registration status, audited accounts, governance policies, banking history.
It has quietly become the binding regulator of Kenyan civil society, applying standards the state itself has never consistently enforced.
- epistemic data
-
The record of what you did not know — what you looked up, what you re-read, where your understanding ran out.
Location data says where your body was. Purchase data says what your wallet did. This says what your mind was doing.
- ERP
-
Enterprise Resource Planning — the large integrated systems organisations installed from the 1990s onward to run finance, procurement, HR and inventory in one place.
The canonical example of expensive, ubiquitous technology that digitised existing processes without changing any of them. The comparison is not flattering.
- expense report
-
The after-the-fact record an employee files to justify money already spent, reviewed by somebody who decides whether it was within policy.
It is a trust instrument wearing accounting clothes — which is why fixing the accounting has never made anybody like it more.
- extra life
-
A video-game convention: a stored additional attempt that lets a player continue after failing rather than restart from the beginning.
It is the affordance the original board deliberately withheld — there was one ascent, and the snakes were the point.
- first-fill
-
Filling a role an institution never managed to staff at all — as opposed to replacing an existing worker. The African case, not the Western one.
It is why the African case is not the Western one: nobody is displaced from a seat that was never filled.
- game of pure chance
-
A game whose outcome is settled entirely by a randomiser, with no decision available to the player at any point. Snakes and Ladders is the canonical example — you roll and you move.
It is why the game is unusual as a story about merit: nothing that happens to you on the board was earned.
- GeoParquet
-
A columnar file format for geographic data — Parquet with geometry columns — designed to be queried straight from cloud storage without downloading whole datasets.
It is why pulling 1.27M Nairobi buildings took minutes, not a 178GB download.
- GPRS
-
The oldest mobile data standard still in wide use — slow, high-latency, and what a field device in much of Kenya is actually connected to when it has any signal at all.
Software tested on office Wi-Fi and deployed onto GPRS fails in ways nobody wrote a ticket for.
- GTFS
-
General Transit Feed Specification — the open data format transit apps and Google Maps use to describe routes, stops and schedules.
Publishing Nairobi's matatu routes as GTFS (Digital Matatus, 2014) is the canonical local proof that opening civic data pays off downstream.
- Height confidence tier
-
Our label for how much to trust each building's height: Measured (real data), High (settlement pattern), Medium (distance + land-use estimate), or Low (bare fallback).
An estimate that carries its own uncertainty can be refined later, tier by tier; one that hides it just looks like data.
- human in the loop
-
A design in which a person must review or approve each instance of an automated process before it takes effect.
For genuinely rule-bound, high-volume work, this paper argues it buys a bottleneck and calls it a safeguard.
- hyperpigmentation
-
Patches of skin that darken after inflammation — a spot, a shave, a reaction — because the skin responds to injury by producing extra pigment.
In deep, melanin-rich skin the mark outlasts the thing that caused it by months, which is why a bad product recommendation is not a neutral experiment.
- in-place
-
An answer rendered at the point of confusion itself, displacing nothing — as opposed to one rendered nearby, which still moves your eyes, your cursor and your place.
The distinction between *closer* and *in place* is small on a screenshot and total in use.
- Informal settlement
-
A residential area developed outside formal planning and land-tenure systems — in Nairobi: Kibera, Mathare, Mukuru, Korogocho and others, housing a large share of the city.
They're systematically undercounted in volunteer map data, which means tools built on that data quietly leave them out.
- intimacy spectrum
-
The ordering this paper proposes for categories of personal data by how much they expose: what you did, then what you bought, then where you were, then what you did not understand.
It is the argument in one line — epistemic data sits at the far end, and it is the end nobody regulates.
- leapfrogging
-
Skipping a generation of infrastructure entirely rather than building a faster version of it — mobile money instead of branch banking, not better branches.
It only happens where the previous generation was absent enough that there was nothing to protect.
- library privacy
-
The professional norm, hard-won over a century, that what a person reads is nobody else’s business — enforced by librarians refusing to hand over borrowing records.
It is the only settled precedent for the question reading tools now raise, and it was settled in favour of not keeping the record at all.
- M-Pesa
-
Kenya's mobile-money network — the canonical example of leapfrogging a generation of infrastructure rather than building a faster version of it.
It is the local proof that the leapfrog is real — and the reason "wait for the regulator" is not a neutral default.
- marginalia
-
Notes written in the margins of a text, next to the passage they respond to — the oldest working comprehension layer, and the one the web dropped.
The margin put the annotation and the sentence in the same field of view. Every modern substitute puts them in different ones.
- Matatu
-
Nairobi's privately-operated minibus — the transit system roughly 3.5 million people ride daily, run as thousands of small businesses rather than one public agency.
Any Nairobi civic model that ignores matatus ignores how the city actually moves.
- melanin-rich skin
-
Skin with high melanin content — better protected from UV damage, and more likely to respond to irritation with lasting dark marks.
It behaves differently enough that formulations tested elsewhere are not merely less effective; they can be actively costly.
- meter reading
-
The monthly field task of recording each customer’s water or power consumption, which is what makes a bill possible at all.
It is the point where an institution’s data is actually created — and the point where offline failure turns into revenue loss.
- Moksha Patam
-
The Indian game Snakes and Ladders descends from, in which the squares were moral positions: ladders stood for virtues, snakes for vices, and the final square was liberation (moksha).
The board was originally an argument about how a life goes. The mechanic survived the journey into the nursery; the argument did not.
- needs assessment
-
A systematic survey of what a population says it lacks, normally commissioned, budgeted and run by an agency over months.
A Kenyan campaign performs one at national scale every five years, for free, and then throws it in a bin bag.
- NGO Co-ordination Board
-
The Kenyan regulator established under the NGO Co-ordination Act of 1990 to register and oversee non-governmental organisations, and the mechanism through which registration pressure was historically applied.
The threat used to be the regulator, and donor money was the protection. Both halves of that have now reversed.
- non-revenue water
-
Water a utility produces but never bills or collects on — the clearest measurable symptom of an institution operating blind.
It is the rare failure that is already measured in shillings, which makes it the easiest place to prove the layer pays for itself.
- offline-first
-
An architecture where the device holds the authoritative copy of its own work and syncs when a connection appears — rather than treating the network as always present and offline as an error state.
It is the difference between a field team that keeps working through a dead zone and one that goes back to paper.
- Once-only principle
-
The e-government rule that a citizen should never have to give the state the same fact twice — recorded once, a fact flows to every system that legitimately needs it.
It converts paperwork from five parallel processes into one event with consequences — the felt difference between digitized forms and digital government.
- operating blind
-
An institution that lacks the feedback loops to observe what it did yesterday or is doing today — it cannot correct its own drift.
It is a description of a condition, not an accusation — which is why more funding and better staff do not fix it.
- operating workforce
-
The next layer after visibility: AI employees that do an institution's routine, rules-bound work — not just show it.
Visibility tells an institution what is wrong. The operating workforce is what actually does something about it.
- Overpass API
-
OpenStreetMap's public query interface — ask it for every tagged building or road inside a bounding box and it returns the live map data.
It's how the v1 CBD scene was built, and it's free — but it only returns what volunteers have traced.
- Overture Maps
-
An open map-data project (Linux Foundation, backed by Amazon, Meta, Microsoft and TomTom) that merges OpenStreetMap, Google Open Buildings and Microsoft ML footprints into one deduplicated, freely usable dataset.
Using the merged layer instead of any single source is why Mathare's buildings appear on our map at all.
- payment rails
-
The underlying network money actually moves on — card networks, mobile money, correspondent banking, a blockchain — as distinct from the app you tap.
Most fintech competes on the interface. The 7% is charged by the rails underneath it.
- PBO Act
-
Kenya’s Public Benefit Organizations Act, No. 18 of 2013 — the statute that replaced the NGO Co-ordination Act as the framework for registering and regulating non-profits. It was passed in 2013 and brought into force more than a decade later.
Better legislation than what it replaced, on almost every measure. Registration rates barely moved. That gap is the subject of four papers here.
- PBOMaster
-
Flux’s compliance tool for Kenyan non-profits: it reads an organisation’s constitution against the PBO Act’s requirements and reports, clause by clause, what is missing.
It is the working example of the argument that the tractable half of legal AI is checking, not reasoning.
- personal operating layer
-
The missing-layer thesis pointed at an individual life: an intelligent, continuous record of what you're trying to do and how it's going — living in your messages, not an app to tend.
The same argument as the institutional one, pointed at a life: you cannot improve what you cannot see.
- polycentric governance
-
Elinor Ostrom’s term for a system with many semi-autonomous decision centres that overlap and check one another, rather than a single hierarchy.
It is the running example of a phrase you can half-know for years — the exact condition an in-place explainer exists for.
- PPADA
-
Kenya’s Public Procurement and Asset Disposal Act, 2015 — the statute governing how public bodies buy goods, works and services.
It assumes what is being bought can be fully specified in advance and compared on price. Software can be neither.
- ProcureBee
-
Flux's first AI employee — an autonomous procurement agent, scoped to the role where institutions lose the most and can verify the most.
Procurement was chosen first because it is where institutions lose the most and can verify the most.
- procurement agent
-
Software that evaluates suppliers, compares terms and executes a purchase on an organisation’s behalf, within limits set in advance.
When the buyer is an agent, the pricing page stops being persuasion and has to become data.
- provenance
-
The recorded history of a piece of data: where it came from, how it was derived, when, and by whom.
Two datasets that both say "measured" can disagree by seven metres. Provenance is what lets you find out which one to believe.
- public participation
-
The constitutionally required process by which Kenyan public bodies must consult citizens before making certain decisions, including county budgets and projects.
A legal obligation with no infrastructure behind it becomes a meeting that was held rather than a view that was recorded.
- purchasing card
-
A corporate card issued for a narrow category of low-value purchases, with limits set by policy rather than by transaction.
One of seventy years of partial answers to the same question: how do you authorise a specific purchase without checking every purchase afterwards?
- re-entry
-
The work of getting back into a sentence after leaving it — relocating your place, reloading the argument, recovering the thread you were holding.
It is the half of the lookup problem nobody ships against, because it is invisible in a demo.
- requisition
-
The internal document that starts a purchase — a formal request for something to be bought, raised before any supplier is approached.
In most county institutions it arrives as a handwritten note and leaves eleven weeks later as a purchase order.
- Riparian land
-
The legally-protected strip of land along a river or stream where construction is restricted because the river needs room to flood.
Construction on riparian land is a named cause of Nairobi's 2024 flood deaths — and exactly the kind of violation a live city model makes visible before the rains, not after.
- stablecoin
-
A digital token designed to hold a fixed value against a reference currency, usually the US dollar, so it can be used for payment rather than speculation.
It is the only settlement instrument available to an African institution today that does not require waiting for a regulator.
- sub-grant
-
A grant passed from one funded organisation to a smaller local one, which makes the larger organisation responsible for vetting the smaller.
It is the mechanism by which an international funder’s compliance checklist becomes a village organisation’s legal problem.
- sub-location
-
The smallest administrative unit in Kenya’s local hierarchy, below the ward — the level a serious campaign organises down to.
It is the resolution at which a campaign knows the country and at which no permanent institution does.
- tenderism
-
The political economy in which the tender itself — not the thing being tendered for — is the object of value, and the award is the transaction.
It explains why a procurement system keeps producing failed systems without anyone in it behaving irrationally.
- the missing layer
-
Flux's founding thesis: African institutions lack the operational data layer that would let them see their own functioning in real time.
Everything else in this series is a consequence of it: no operating layer, no feedback loop, no correction.
- Tile streaming
-
Serving a large map in small grid squares ("tiles") fetched on demand as the viewer pans, instead of loading everything at once. How every web map since Google Maps has worked.
It is the difference between a 68MB dataset being instant and being unusable in a browser.
- translation layer
-
The infrastructure that converts a rule as written into steps somebody without a lawyer can actually follow — TurboTax to the tax code, not a new tax code.
Its absence, not the quality of the law, is the recurring failure mode in African regulatory reform.
- trial-and-error tax
-
The money, time and visible skin damage spent discovering by experiment what a product should have been able to tell you.
It is paid almost entirely by the people the market never formulated for.
- Universal Health Coverage
-
The policy goal that everyone can use the health services they need without being pushed into financial hardship by paying for them.
It is the frame under which Kenya committed to the community health programme — a mandate issued without the instruments to run it.
- vendor capture
-
When a single supplier ends up holding operational control of public infrastructure the institution cannot do without — monopoly produced through procurement.
It is the predictable output of buying software as though it were furniture, not a story about bad suppliers.
- virtual card
-
A card number generated for a single merchant, amount or transaction, then discarded — spending authority scoped in advance instead of policed after the fact.
It is the closest the pre-agentic era got to giving software a wallet.
- workflow-native
-
Software designed around the whole job rather than around a step in it — so the unit of work is the outcome, not the document somebody still has to carry onward.
A chat window bolted onto an existing process is the opposite, and it is most of what has shipped.
- X-Road
-
Estonia's national data-exchange layer (launched 2001): each institution keeps its own records and answers queries from others peer-to-peer, with every query logged and visible to the citizen concerned.
It is the reference architecture for the invisible half of a real digital twin — institutions made mutually legible without a central superdatabase.