Built AI-first · Chapter 4 of 9

The Three-File Architecture

Context, Skills, Routines. What is true, how we do a thing, and when it runs. Every AI-first organisation we have built or examined comes down to these three, whatever they are called locally — and the discipline that makes them work is refusing to let them mix.

This is the least exciting chapter in the series and the one that decides whether any of the others hold. Mixed-together context, method and schedule is the swamp that every stalled AI programme is standing in.

The claim

Three files, because they change on three different clocks

A fact changes when the world changes — a price rises, a policy is superseded, a client's scope moves. A method changes when you get better at it, which is on your schedule and nobody else's. A cadence changes when the calendar or the organisation changes, which is rarer than both.

Put all three in one prompt, one document or one assistant configuration and every change to any of them risks the other two. You cannot improve the method without stepping around the facts. You cannot update a fact without hunting for every place it was embedded. And you cannot tell, afterwards, whether a bad result came from a stale fact, a weak method or a run that never happened.

Keeping them apart is not tidiness. It is the only way to diagnose a failure after it happens.

The three

What each file is, and what it must contain

File one

Context

What is true here.

Facts, settled decisions, constraints and voice — the library from chapter three. Read before anything is drafted, cited when anything is produced.

Must carry
A claim, a source, an as-of date, an owner, a status.
Changes when
The world changes, or somebody decides something.
Failure it causes
Confidently wrong output. The answer was well-made and the input was stale.

File two

Skills

How we do a particular thing, well, every time.

A written procedure: what it takes in, the steps, the checks it must pass, and what it refuses to do. Not a prompt — a method, of the kind you would hand a competent new colleague.

Must carry
Inputs, steps, the quality checks, the refusals, and a worked example.
Changes when
You learn something. Improve it once and everyone who calls it improves.
Failure it causes
Inconsistent quality. The same request answered three ways by three people.

File three

Routines

When it runs, who owns it, and who is owed the result.

The standing cadence. Weekly, monthly, on a trigger — plus the part everyone omits: what it means when the routine did not run.

Must carry
A cadence, an owner, a recipient, and a definition of "did not happen".
Changes when
The calendar or the organisation changes. Rarely, and deliberately.
Failure it causes
Silent absence. Nothing was wrong; nothing happened, and nobody noticed.
The third failure is the one organisations are worst at. A wrong answer announces itself eventually. A routine that quietly stopped produces no output to be wrong, so the first sign is a missed deadline weeks later. Our own dashboard treats a scheduled run that did not report as a flag rather than an absence, precisely because silence is the failure mode that hides.

The test

One question sorts anything into the right file

Take any sentence in your current prompts, playbooks or assistant configuration and ask what kind of thing could go wrong with it.

If it could be…It belongs in…
True or falseContext. "Our standard payment term is thirty days." Either it is or it is not, and the answer has a date on it.
Done well or badlySkills. "Write the renewal note." There is no true or false here — there is competent and incompetent, and the difference is written down as steps and checks.
On time or lateRoutines. "Every Friday, before noon." Nothing about this is a fact or a method. It is a commitment with an owner and a recipient.

Run it across one existing prompt and the usual result is three or four sentences that each belong somewhere different, currently welded together. Separating them is often the first hour of real work in an AI programme, and it is the hour that makes the next fifty tractable.

Why it compounds

The separation is what lets everything else accumulate

● Code red · welded together

Every improvement is local

A better way of writing the renewal note is trapped inside the prompt where it was discovered, alongside that prompt's copy of the pricing and its own idea of when to run. Nobody else benefits. When pricing changes, six prompts contain the old number and five of them get updated.

● Code green · kept apart

Every improvement is global

The method improves once and every agent calling it improves. The price changes in one entry and everything downstream is immediately correct. The cadence moves without touching either. This is the structural reason an AI-first organisation gets better over time and a retrofitted one plateaus.

It also makes the next two chapters possible. An agent, in the sense we mean it, is a named job that holds skills and reads context on a routine — so the three files are the parts an agent is assembled from. And autonomy, in chapter eight, is granted to a routine rather than to an agent, which you cannot do at all if the routine is not a separable thing.

In your world

Where the three already exist, unlabelled

None of this is new to any of these organisations. All four already run on context, method and cadence; what is missing is that any of it is written where something other than a person can read it.

Fire & EMS agencies

Policy, SOG, and the training calendar

The policy guide is context, the standard operating guideline is a skill, and the drill and testing calendar is a routine. The vocabulary already exists — it is one of the few sectors where these three are genuinely distinct documents, which is a real head start.

Small cities & civic

Code, procedure, and the meeting cycle

Municipal code and adopted resolutions are context, the clerk's procedures are skills, and the council cycle is the most unforgiving routine in local government. The gap is usually that the procedures live with the clerk rather than on paper.

Trades & field service

The price book, the way you do it, and the follow-up

The price book is context and often the only one of the three written down. How you scope a job is a skill living in the owner's head, and the follow-up cadence is a routine that mostly does not exist — which is the same finding as chapter two.

Professional services

The engagement, the method, and the weekly

Scope and commitments are context, your delivery method is a skill you probably believe is unwriteable, and the weekly client rhythm is a routine. Writing the method down is the hard one and the one that makes the practice sellable.

What we will not claim

The boundary on this chapter

Where this sits

Next: what turns three files into a team

Context, skills and routines are the materials. Chapter five is about the two roles that turn a drawer of them into a system that compounds — and the fact that most agent teams are missing both.

ITMedic · Green IT Consulting, LLC · Snoqualmie, WA · (425) 242-3378
Built AI-first, chapter 4 of 9 — written from our own build. The agents draft; a human sends.