Knowledge

Concepts and Guides on engineering with and for AI agents, by category.

AI Engineering

  • Agent

    Concept

    A model harnessed with tools, a system prompt and a context window that takes turns with a user: the unit you actually talk to.

  • Model

    Concept

    The parameters: a stateless next-token predictor that can't do anything agentic until it is harnessed.

  • Token

    Concept

    The atomic unit a model reads and writes; context window size, cost and latency are all counted in tokens.

Context Engineering

  • Clearing

    Concept

    Ending the current session and starting a fresh one with an empty context window.

  • Compaction

    Concept

    A handoff done in-memory: the session's history is summarised and the summary seeds a fresh session.

  • Context

    Concept

    The task-relevant information the agent has access to right now, as distinct from the context window and the session.

  • Context window

    Concept

    Everything the model sees on each model provider request: finite, model-specific, and the only surface through which it perceives anything.

  • Session

    Concept

    One bounded run of interaction with an agent; the session is what fills the context window.

  • Smart zone

    Concept

    The early, sharp part of a session, before growing context drifts the agent into a sloppier "dumb zone".

Harness Engineering

  • Harness

    Concept

    Everything around the model that turns it into an agent: tools, system prompt, context-window management, permissions, hooks.

  • Turn

    Concept

    One user message plus everything the agent does in response, up until it yields back to the user.

MCP & Tooling

  • Tool

    Concept

    A function the harness exposes for the agent to call, and the only way the agent perceives and acts on its environment.

  • Tool call

    Concept

    The model's output naming a tool and its arguments: structured text that the harness has to read and execute.