AI Onboarding Guide

Track 2

Intermediate

For engineers who can ship. This track opens the box: how the model works inside, how to retrieve well, how to give it tools, and how to tell whether your last change helped.

11 sections 20 to 30 hours Prerequisite: beginner track and Python
How to work through this

Each section ends with something to build. Build it. This track does not work as reading, because the lessons that matter are the ones you only hit when your own retrieval returns garbage or your own agent loops forever.

1

Transformers and attention

How a word picks up its context, and where the cost curve comes from.
Intermediate

Attention is the mechanism that made modern language models possible. The problem it solves: to represent a word properly you need to know which other words it relates to. In "the server rejected the request because it was stale", the token for it is meaningless until you know it refers to the request.

Attention handles that by having every token score every other token, producing a weight for how much to read from each. Each token is then rebuilt as a weighted blend of the others, so it absorbs the context it needs. Stack that operation dozens of times with different learned weights, and you get a transformer.

Why it matters here

This explains the cost curve you will run into. Every token attends to every other token, so the work grows with the square of the sequence length. That is the real reason long context is expensive, why chunking strategy matters in retrieval, and why the recursive approaches on the advanced track exist at all.

2

Build a small one

Type out a working language model from an empty file.
Intermediate

There is a point at which reading about transformers stops paying and typing one out starts. Karpathy builds a working character-level language model from an empty file in two hours, explaining every line. Do it by typing along, not by watching.

What you get from this is not the ability to train production models. It is that the architecture stops being a diagram and becomes code you have debugged, which changes how you reason about everything downstream.

Pick one

If you only have one evening, watch the Deep Dive. It covers pretraining, post-training and why models behave as they do, and it is the better use of three hours. The build-along is for when you want the architecture in your fingers.

3

Embeddings and vector search

Meaning as coordinates, and the places where that idea breaks.
Intermediate

An embedding converts a piece of text into a fixed-length list of numbers positioned so that things with similar meaning sit near each other. "Cancel my subscription" and "how do I unsubscribe" end up close together despite sharing one word. A vector database stores millions of those and finds the nearest ones fast.

The thing to understand is what "near" means, because it is nearness in meaning as judged by the embedding model, and that model has its own opinions. Negation often barely moves a vector, so "the deploy succeeded" and "the deploy did not succeed" can look similar. Numbers, dates and identifiers embed badly. These are not edge cases, they are Tuesday.

Build this

Embed about five hundred chunks of our own documentation, store them, and query it with twenty questions you already know the answers to. Count how many return the right chunk in the top three. That number, not a vibe, is your retrieval quality, and you now have a baseline.

4

Retrieval that works

Chunking, hybrid search and reranking, in order of how much they help.
Intermediate

The beginner version of RAG works in a demo and disappoints in production. The gap is almost never the model. It is chunking, hybrid search and reranking, in that order of impact.

  • Chunking. Splitting every 500 characters cuts sentences in half and separates a heading from the rule underneath it. Split on structure: headings, sections, function boundaries. Keep the heading with the body.
  • Hybrid search. Vectors are bad at exact terms. Someone searching for an error code or a product name wants a keyword match. Run both keyword and vector search and merge the results.
  • Reranking. Retrieve twenty candidates cheaply, then have a smaller model score each one against the question and keep the best four. This is usually the single largest quality jump available.
  • Give the model the source. Pass the document name and section with each chunk so it can cite, and so you can tell where a wrong answer came from.
  • ArticleIntroducing contextual retrieval Anthropic. Prepending a short generated summary to each chunk before embedding, and what it does to failure rates.
  • CourseRAG evaluation Hugging Face cookbook. How to score a retrieval pipeline instead of guessing.
5

Prompt, retrieve or fine-tune

Work down the list and stop as soon as something works.
Intermediate

This question comes up in every project and the answer is usually the cheapest option on the list. Work down it in order and stop as soon as something works.

ProblemReach forWhy
It does not follow the format or tone you wantBetter prompt, with examplesMinutes to try. Fixes this most of the time.
It does not know facts specific to usRetrievalFacts change. Retrieval updates when the document updates, with no retraining.
It needs to do things, not just answerTools and a loopSee tools and MCP.
It cannot hold the task in one callDecomposition, or a harnessSee the advanced track.
You need a specialised output style at scale, cheaply, and have thousands of good examplesFine-tuningTeaches behaviour and format, not facts. Expensive to maintain, and it goes stale.
Common expensive mistake

Fine-tuning to teach the model facts. It does not reliably work, the facts go out of date the moment you finish, and you have replaced a document edit with a training run. If the answer lives in a document, retrieve the document.

6

Tools and MCP

A tool is an interface written in words. Here is how to write one well.
Intermediate

A tool is a function you describe to the model in words, so that it can ask for it by name with arguments. The description is the interface, and writing it is a genuine design task: the model has your description and nothing else, no source to read and no colleague to ask.

The Model Context Protocol is an open standard for exposing tools and data to any AI application, so you write a server once and every MCP-aware client can use it. It is the reason a tool you build for Claude Code also works elsewhere.

What makes a tool good

Few tools, not many. Names that say what they do. Arguments that are hard to get wrong. Errors that explain the fix rather than returning a stack trace. Responses that are already trimmed to what is needed, because every tool result costs context. Exposing sixty tools is how you spend fifty thousand tokens before the conversation starts.

7

Context engineering

What should occupy the window on this call, answered again every turn.
Intermediate

Prompt engineering asks what to write. Context engineering asks what should occupy the window on this call, and it has to be answered again on every single turn as files are read, tools return and the conversation grows. It is the discipline that replaces prompt engineering once a system has more than one turn.

The goal is the smallest set of high-signal tokens that gets the outcome you want. That is harder than it sounds, because the instinct is always to add: one more instruction, one more example, the whole file instead of the function. Every addition dilutes everything else.

The failures to recognise

Poisoning: a wrong fact enters the context and gets treated as true for the rest of the session. Distraction: so much material that the instruction is lost in it. Confusion: tools or documents that are irrelevant to this task but influence the answer anyway. Clash: two parts of the context contradict each other and the model picks one, usually the more recent.

8

Agents, properly

Build the loop, read the log, and meet the problems no prompt will fix.
Intermediate

You met the loop on the beginner track. Here you build one and meet its real problems: it calls the same tool forever, it declares success without checking, it burns the context window on tool output, and it fails on step fourteen with no record of steps one to thirteen.

None of those are model problems and none are fixed by a better prompt. They are fixed by the code around the model, which is why the advanced track is mostly about that code.

Build this

Write an agent with exactly three tools, a hard step ceiling, and a log of every call and result. Give it a task that needs five or six steps. Then read the log. The log is the lesson, and nearly everyone is surprised by what their agent actually did.

9

Claude Code as a system

CLAUDE.md, skills, hooks and subagents, in the order they pay off.
Intermediate

On the beginner track you used Claude Code. Here you configure it, which means treating it as a harness you shape rather than a chat window you talk to. Four mechanisms, roughly in the order they pay off.

MechanismWhat it is for
CLAUDE.mdStanding instructions read at the start of every session: commands, conventions, the traps in this codebase.
SkillsA repeatable workflow packaged under a name, so /review-pr means the same thing for everyone on the team.
HooksShell commands that fire around actions. Format after every edit, run the linter before a commit. Deterministic, so it does not depend on the model remembering.
SubagentsSeparate contexts for separate jobs, so a long search does not fill the window your main task needs.
10

Knowledge graphs for real

When a graph earns its cost, and when it is just more to maintain.
Intermediate

Vector search finds passages that resemble your question. It cannot answer a question about how things connect, because the connection is not in any single passage. That is what a graph is for, and the two are complements rather than competitors.

When a graph earns its cost

Use one when answers require following relationships across several records, when the same entity appears under different names in different systems, or when you need to show how you reached an answer. Skip it when the answer sits inside a single document, which is most of the time. A graph is real work to build and keep current.

  • CourseNeo4j GraphAcademy Free. Graph Data Modeling Fundamentals, then Building Knowledge Graphs with LLMs.
11

Benchmarking and evals

Twenty real cases you run beats two hundred you plan to write.
Intermediate

A benchmark is a fixed set of tasks with known answers, used to compare two things. An eval is the same idea applied to your own system, and it is the difference between engineering and guessing. Without one, every change is a vibe and every regression is discovered by a user.

Start embarrassingly small. Twenty real cases with known good answers, in a file, scored by a script you can run in a minute. Twenty cases you actually run beats two hundred you plan to write.

Reading public benchmarks

Treat published scores as weak evidence. Benchmarks leak into training data over time. The harness around the model changes the number as much as the model does, so two scores are only comparable when the scaffolding was the same. And a score on someone else's tasks says little about yours. Public benchmarks are for shortlisting candidates. Your eval decides.

  • GuideDemystifying evals for AI agents Anthropic. The most practical thing written on this.
  • LeaderboardSWE-bench Real GitHub issues, judged by whether the test suite passes. The standard for coding agents.
  • LeaderboardArena Formerly LMArena. Blind human preference between two models. Measures what people like, which is not the same as what is correct.
  • LeaderboardTerminal-Bench Agents doing real terminal work.

Finish line

Six things that should be true before you move to the next track.
  • You can explain attention without using the word attention.
  • You have a retrieval pipeline over our documents with a measured hit rate, and you know which chunking change moved it.
  • You have written an MCP tool that someone else on the team has used.
  • You can name the four context failure modes and point at one in a log.
  • You have built a three-tool agent with a step ceiling, and read its log end to end.
  • You have an eval file with at least twenty real cases, and a script that scores it.
Next

The advanced track is about the code around the model: harness and loop engineering, orchestration, GraphRAG, recursive language models, and evaluation that resists gaming.

Maintained by the AI team. Corrections and additions are welcome as pull requests.