Skip to main content

Glossary

Use this page when you want to return to a word from the Book. Each entry gives its meaning and a reading link. The lessons introduce the ideas in context, so you can continue reading without memorising this page.

Agent​

A program that can read your files, write new code, edit existing code, and run commands on a computer — on its own, in a sequence, often without asking you to approve every step, depending on its permission settings.

First met on the Welcome page. An agent can help with code and design. The person accepting the work remains responsible for the result.

Agent Skill​

A set of instructions kept in one folder that an AI agent reads when a task calls for it, so it handles that job the same way every time instead of improvising a new approach each attempt.

First met on the Welcome page. A skill is written once and reused, which is what separates it from a prompt you type fresh each time.

Agentic AI​

AI that does not only answer, but plans its steps and uses tools, such as searching, running a program or sending a message, to finish a job.

First met on the Welcome page. Building agentic AI of your own is one of the five skills this book teaches.

AI-native​

In this book, working with AI in four ways: using AI, building AI, building for AI (such as MCP servers), and adding AI to software that is not AI itself.

First met in the Thesis. Elsewhere the word often means something narrower, such as a company built around AI from its first day. This book uses the broader meaning.

Blast radius​

How much can break, and how far the damage reaches, if a change goes wrong.

First met in the Thesis.

Code Literacy​

The ability to read and judge code, whoever or whatever wrote it: reading the decisions and the evidence behind it, and the actual lines when needed, well enough to verify it and own it.

First met in the Thesis. This book uses Code Literacy for judging the decisions and evidence alongside the code itself.

Database​

An organised store of information that a program can search, add to and change, such as a shop's list of customers and their orders.

First met in the Thesis.

Framework​

A ready-made structure of code for building one kind of software, such as a website or a server, so you don't start from nothing. React and Django are well-known examples.

First met in the Thesis.

JavaScript​

The programming language that runs inside every web browser. It makes web pages interactive, and it can also run on servers.

First met in the Thesis.

MCP server​

A small program that gives an AI agent an ability it does not have on its own — reading your files, searching a database, sending a message — through one agreed connection. The agent asks, and the server does the work and answers.

First met on the Welcome page. MCP stands for Model Context Protocol, the standard that connection follows, so a tool written for one agent works with another.

Python​

A popular programming language known for its clear, readable style. It is widely used for AI, data work, automation and the servers behind websites.

First met on the Welcome page.

Software architecture​

The big decisions about how a piece of software is structured: its main parts, how they connect, and where its data lives. They are the decisions that are expensive to change later.

First met in the Thesis. Think of it as the house plan, drawn before the first brick.

Solution​

A real person's problem, solved. In this book, a solution can be an AI agent, or something with no AI inside it, such as a website, built with the help of AI agents.

First met on the Welcome page.

Spec-driven development (SDD)​

A way of organising software development around a written specification that guides implementation and stays a reference as the work changes. Current AI-assisted approaches use it to guide both people and coding tools.

First met in the Thesis. Different SDD approaches can include review, security and risk assessment. This book's Spec-Driven Engineering makes intent, enforced boundaries, verification and ownership explicit; those duties are not exclusive to its name.

Specification (spec)​

A written statement of what you want built and what shouldn't change, agreed before you start.

First met in the Thesis.

Spec-Driven Engineering​

The discipline in which the engineer specifies intent and boundaries, the AI implements within them, and a human verifies before taking ownership.

First met on the Welcome page. Spec-Driven Engineering is this book's name for the method defined above. It is the technical side of solving a problem, and it starts from understanding the problem.

Technical debt​

The future cost of a shortcut taken today: work that has to be redone later, usually with extra effort, because something was built quickly or with only a partial understanding.

First met in the Thesis. The engineer Ward Cunningham coined the term, comparing first-draft code to borrowing money: a little debt speeds you up, as long as you pay it back soon.

Vibe coding​

Building software entirely through iterative AI prompts without understanding the underlying code. Coined by Andrej Karpathy, February 2025; named Collins Dictionary's Word of the Year for 2025.

First met in the Thesis. The term is not ours — it is credited to whoever coined it wherever it appears.

Vibe decisioning​

Making the decisions around software blindly: by feel, or by accepting whatever the AI chose without checking it or knowing what will follow. It matters most at the higher levels of engineering: AI agents, the cloud, and the structure of whole systems.

First met in the Thesis. I arrived at this term independently, and later learned that the analyst David Pidsley had used it earlier, in May 2025, for building decision models by prompting AI. A decision model describes choices, the information they need and the rules for making them. This book uses the term in the wider sense above.

Program​

A set of instructions a computer can carry out.

Read it in Software: instructions that do useful work.

Software​

Programs and the information used with them to carry out work on a computer.

Read it in Software: instructions that do useful work.

Hardware​

The physical parts of a computer system.

Read it in Software: instructions that do useful work.

Data​

Information that a program stores or works with.

Read it in Software: instructions that do useful work.

Input​

Information supplied to a program.

Read it in Software: instructions that do useful work.

Output​

A result produced by a program.

Read it in Software: instructions that do useful work.

Algorithm​

A step-by-step method for solving a problem.

Read it in Software: instructions that do useful work.

Binary​

A representation using two values or symbols, commonly written as 0 and 1.

Read it in Binary and languages: make instructions readable.

Bit​

A binary digit with one of two values, usually 0 or 1.

Read it in Binary and languages: make instructions readable.

Machine code​

Instructions encoded in a form a particular processor can execute.

Read it in Binary and languages: make instructions readable.

Assembly language​

A programming language with readable names for operations closely related to processor instructions.

Read it in Binary and languages: make instructions readable.

Compiler​

Software that translates program code into another form, such as machine code or bytecode.

Read it in Binary and languages: make instructions readable.

Interpreter​

Software that executes instructions expressed in a programming language, sometimes after translation into an intermediate form.

Read it in Binary and languages: make instructions readable.

File​

A named item stored on a computer, containing text or other information.

Read it in Files, editors and terminals: find where the work runs.

Folder​

A container for files and other folders; also called a directory.

Read it in Files, editors and terminals: find where the work runs.

Path​

A location description that software uses to find a file or folder.

Read it in Files, editors and terminals: find where the work runs.

Editor​

An application for viewing and changing text.

Read it in Files, editors and terminals: find where the work runs.

IDE​

An application that combines a code editor with development tools.

Read it in Files, editors and terminals: find where the work runs.

Terminal​

An interface for sending text to programs and reading their replies.

Read it in Files, editors and terminals: find where the work runs.

Shell​

A program that reads commands, starts other programs and reports results.

Read it in Files, editors and terminals: find where the work runs.

CLI​

A command-line interface: a way to operate software using text commands.

Read it in Files, editors and terminals: find where the work runs.

Operating system​

Software that manages a computer's hardware and resources.

Read it in Files, editors and terminals: find where the work runs.

Code​

Written program text.

Read it in Binary and languages: make instructions readable.

Variable​

A name used to refer to a value; assignment can change what that name refers to.

Read it in Read Python: follow names, values and results.

Comment​

A note in program text intended for a person reading it.

Read it in Read Python: follow names, values and results.

Data type​

The kind of a value, which determines the operations supported for it.

Read it in Read Python: follow names, values and results.

Frontend​

The part of an application that presents its interface and handles user interaction.

Read it in Frontend and APIs: follow one request.

API​

An agreed interface through which software parts request data or operations from one another.

Read it in Frontend and APIs: follow one request.

Browser​

An application that opens and displays web pages.

Read it in Frontend and APIs: follow one request.

Client​

Software acting as the requester of a service.

Read it in Frontend and APIs: follow one request.

Server​

Software providing a service to clients, or the computer running that software.

Read it in Frontend and APIs: follow one request.

Request​

A message asking software to perform an operation or provide information.

Read it in Frontend and APIs: follow one request.

Response​

The answering message to a request, containing a result or a failure indication.

Read it in Frontend and APIs: follow one request.

Backend​

The part of an application that provides data and services behind its user interface.

Read it in Backend and data: check the rule behind the screen.

Persistence​

Retaining information so that it remains available later.

Read it in Backend and data: check the rule behind the screen.

Authentication​

Checking a claim about who or what an entity is.

Read it in Backend and data: check the rule behind the screen.

Authorization​

Checking whether an entity may perform a requested action.

Read it in Backend and data: check the rule behind the screen.

Validation​

Checking whether supplied information follows the required rules.

Read it in Backend and data: check the rule behind the screen.

Deployment​

Placing software in the environment where it will be used.

Read it in Backend and data: check the rule behind the screen.

Dependency​

Something a software part needs from another part.

Read it in Architecture and debt: see the cost of a choice.

Test​

A check using a defined input or situation and an expected result.

Read it in Architecture and debt: see the cost of a choice.

Processor​

The part of a computer that carries out instructions.

Read it in Binary and languages: make instructions readable.

Assembler​

The program that translates assembly language into the machine code of one specific processor family.

Read it in Binary and languages: make instructions readable.

CPython​

A program for running Python instructions, with a compiler and an interpreter.

Read it in Binary and languages: make instructions readable.

Bytecode​

A translated form of program instructions that other software executes.

Read it in Binary and languages: make instructions readable.

Integer​

A whole-number value.

Read it in Read Python: follow names, values and results.

Float​

A number type whose stored value can approximate a supplied decimal value.

Read it in Read Python: follow names, values and results.

String​

A text value, written inside quotation marks in these Python examples.

Read it in Read Python: follow names, values and results.

Boolean​

A value with one of two truth states; Python writes them as True and False.

Read it in Read Python: follow names, values and results.

Syntax​

The rules for writing valid program text.

Read it in Read Python: follow names, values and results.

Interface​

An agreed way to use or communicate with something.

Read it in Frontend and APIs: follow one request.

HTML​

The language used to describe a web page's content and structure.

Read it in Frontend and APIs: follow one request.

CSS​

The language used to describe the appearance of web content.

Read it in Frontend and APIs: follow one request.

HTTP​

Agreed rules for many web requests and responses.

Read it in Frontend and APIs: follow one request.

HTTPS​

HTTP over a connection that scrambles information between client and server, so others watching the connection cannot read it.

Read it in Backend and data: check the rule behind the screen.

Version​

An identifiable state of a piece of work.

Read it in Architecture and debt: see the cost of a choice.

Code completion​

Suggestions an editor offers for the next characters or lines while you type; you choose whether to accept each one.

Read it in AI coding agents: know what can act and what can change.

Least privilege​

Giving a person or program only the access it needs for its task, and no more.

Read it in AI coding agents: know what can act and what can change.

AI slop​

Low-quality content produced with AI, often in large amounts. In software, it describes poor AI-generated code. Being unchecked is a risk; quality still has to be judged.

Read it in Vibe coding and Code Literacy: read what you receive.

Requirement​

A statement that a piece of work must satisfy. Some requirements say what the work must do; others say what it must never do.

Read it in Specifications and design: decide what the build must do.

Acceptance criteria​

Checks, written before the work is done, that pair a situation with its expected result and decide whether the finished work is accepted.

Read it in Specifications and design: decide what the build must do.