AI Foundations: Start Here
Four short series explaining how these systems actually work — what the model is doing, what your coding tool is doing around it, how to work with it day to day, and how to ship it in your own product. Which one to read depends on what surprised you.
This page exists because two posts went out that named a whole layer nobody had written down, and the people who said they could not follow them were right.
Start from what surprised you
Pick the line that sounds like your week. Each goes straight to the post that answers it. Each of those four also opens by naming what it assumes — usually one earlier post — so you will know within a paragraph whether to read that one first. Start where the question is; back up only when the post tells you to.
- It said something confidently wrong → Why It Sounds Certain When It’s Wrong
- It forgot something I told it → The Context Window Is the Entire Memory
- It did something I did not expect → What Actually Happens When You Press Enter
- I do not know what MCP is → MCP, Explained Without the Spec
If none of those is it, the four tracks below are sorted by who they are for, not by difficulty. Read the one that matches you and stop.
Track 1 — what the model is doing
For any engineer who uses AI and has never looked inside. Assumes you can code and have used a chat assistant; nothing else. It is the broadest entry point, and the other three tracks lean on it.
- What a Model Actually Is — tokens, one guess at a time, and why it never looks anything up.
- Why It Sounds Certain When It’s Wrong — hallucination as the mechanism working as designed, plus what temperature does.
- The Context Window Is the Entire Memory — stateless model, whole conversation resent every turn, and what “it forgot” means.
- How It Learned to Follow Instructions — pretraining versus post-training, and why a system prompt works at all.
- Embeddings, and Why Retrieval Beats Memorising — vectors by hand, retrieval in thirty lines, then broken on purpose.
- Reading a Model Card Without Guessing — parameters, context length, price, speed, and benchmarks that mislead.
Track 2 — what your coding tool is doing
For developers using an AI coding tool daily who hit behaviour they cannot explain — the readers who got lost. Assumes track 1, or a willingness to follow its links. Each post explains the mechanism in general terms first, then shows the same thing concretely in Claude Code.
- What Actually Happens When You Press Enter — the loop end to end, in about forty lines you can run.
- A Tool Call Is a Request, Not an Action — the model never runs anything; your harness decides whether to honour it.
- MCP, Explained Without the Spec — what a server offers, which side your editor is on, what crosses the wire.
- Build a Small MCP Server and Watch the Wire — a hundred lines, two read-only tools, every message logged.
- What Can Go Wrong With an MCP Server — the attack classes the specification itself names, and what to check before installing one.
- Where the Context Comes From — your message is the smallest part of the request; compaction throws some of the rest away.
- Who Is Allowed to Do What — asking an agent not to, versus actually stopping it.
- How a Skill Gets Found and Loaded — the name and the description together are the trigger, and two similar ones fight.
- Subagents: Why Isolation Is the Point — a fresh context with a narrow brief; parallelism is the side effect.
- The Whole Thing, Annotated — one real session, first prompt to landed commits, every mechanism labelled where it fires.
Track 3 — using it well, day to day
For working developers, and the tech leads deciding whether this is worth it. Assumes nothing, and a non-engineer can follow it. Two posts:
- Is It Actually Making You Faster? — what to measure, what the numbers hide, and how to run the comparison honestly for two weeks.
- Rolling It Out to a Team — which configuration belongs to the repository rather than the person, who owns the shared skills, and the adoption failures that turn out to be social.
The track is short because most of its ground was already published, and those two link out to it rather than restate it. Already written:
- Making AI Coding Assistants Reliable: My Playbook — how to prompt, ground and correct it. The prompting technique lives here and is never re-explained elsewhere.
- Spec-Driven Development — writing the spec first, and how that differs from TDD and BDD when an agent does the typing.
- Learning to Build Software When AI Writes the Code — for anyone early in their career, and for whoever is reviewing their work.
- Claude Code Plugins: What I Actually Use — what to install, and what a plugin even is.
Track 4 — putting AI in your own product
For engineers shipping a feature with a model behind it. A different reader from the other three: not somebody using an AI tool on their work, but somebody putting a model inside something other people will use. Assumes tracks 1 and 2. It is the only track whose code you keep: an agent loop and an eval harness, both written by hand, both short enough to read in one sitting.
Four posts:
- Writing the Agent Loop Yourself — a step budget, an approval gate, reasoning printed each turn, and the four ways it actually went wrong.
- Knowing Whether It Works — twenty cases where the assertion is “good enough” rather than equality, and a real regression the suite catches.
- Making the Model Yours — and When Not To — a real fine-tune, before and after, and what happened when I tried to teach it a fact instead of a manner.
- Running It in Production — streaming, the two cost levers, a ceiling that trips, injection against a service, and what you may legally send.
The three guides — AI architecture, training, fine-tuning and evaluation and MLOps and production operations — are the breadth-first catalogues this track points into. They assume you already know the shape of the problem; these four posts are where you get it.
The reference pages
Three pages here are not rungs on any ladder. They are meant to sit open in a second tab while you read the rest.
- The AI Vocabulary: Seventy Terms That Unlock Everything Else — one sentence and one concrete example each, grouped by what you are trying to understand rather than alphabetically. Sendable on its own.
- Harness Engineering: The Words for the Layer Around the Model — the same job for the layer around the model: skill, hook, subagent, plugin, permission mode, organised by who pulls the trigger. Track 2 uses these words without redefining them.
- Running the Code in These Posts — the ten-minute setup for the seven posts that print numbers from a model on your own laptop. No GPU, no API key, one command.
What this series is not
It explains mechanisms and where they break. It is not a security assessment, not a compliance framework, and not legal advice. If you are making a deployment decision — whether a model may touch customer data, what has to be logged, who signs it off — start instead with NIST AI 600-1, the Generative AI Profile of the AI Risk Management Framework (July 2024), and with a CISO’s guide to agentic AI (Anthropic, July 2026) for the organisational version of the same question. Understanding the machine is a prerequisite for those conversations, not a substitute for them.
References and further reading
- The AI Vocabulary — open this the first time a word in any post here stops you. It is the only page in the series designed to be read out of order.
- Harness Engineering: The Words for the Layer Around the Model — one of the two posts whose readers asked for this series. Read it again after track 2 and it reads differently.
- Claude Code Plugins: What I Actually Use — the other one. It is a shopping list that assumes you know what the shop sells; track 2 is the shop.
- Making AI Coding Assistants Reliable: My Playbook — open this when you want technique rather than mechanism. Nothing in the four tracks repeats it.
- Spec-Driven Development: How It Differs from TDD and BDD, and How to Run It with AI Agents — open this for the workflow the tracks assume and never re-explain: how a spec, a plan and a task brief get an agent to build the thing you meant.
- Learning to Build Software When AI Writes the Code — open this if the person you are handing this map to is early in their career, or is the one reviewing the output.