Glossary β 70+ Terms, AβZ
Filter this page with the search box above. Each term: one exam-precise sentence, plus context where it matters.
A
- 4D Framework (AI Fluency) β Anthropic's human-side framework: Delegation (hand over vs keep), Description (communicate intent), Discernment (judge output), Diligence (responsibility); each D maps to concrete machinery in this guide (see the AI Fluency Bridge page).
- Agent β a system where the model dynamically directs its own process and tool use in a loop, versus a workflow's predefined path.
- Agent loop β gather context β model decides β execute tools β append results β repeat until a terminal condition.
- Agent SDK (Claude Agent SDK) β the Claude Code engine (loop, tool execution, permissions, subagents, MCP, hooks) as a Python/TS library for building your own agent services; sits between the raw Claude API and Claude Code itself.
additionalProperties: falseβ JSON-Schema setting making a schema closed; invented fields fail validation instead of passing silently.- Allowlist (tool/permission) β explicit enumeration of permitted tools/commands; the deterministic alternative to trusting instructions.
- Artifacts of orchestration β plans, task lists, and summaries a coordinator uses to manage subagents.
- Audit trail β append-only record of every decision, tool call, and gate verdict; the substrate for "explainable, auditable, replayable."
B
- Batch API β asynchronous bulk processing at ~50% cost with hours-scale turnaround; the answer for offline volume (evals, backfills).
- Budget (harness) β hard ceilings on turns/tokens/cost/wall-clock whose breach is a terminal state, not a warning.
C
cache_controlβ API marker placing prompt-cache breakpoints; everything before it must be byte-identical to hit.- Checkpointing β persisting agent state each step so restarts resume rather than replay side effects.
- Chain of thought (CoT) β asking the model to show a step-by-step rationale before its answer; for genuinely hard reasoning prefer extended thinking (the Claude API's
thinkingparameter) β treat any visible "reasoning" text as a rationale, not guaranteed inner thought. CLAUDE.mdβ Claude Code's memory file; project scope is checked into git and shared, user scope (~/.claude/CLAUDE.md) is personal; more specific scopes win.- Claude API (Anthropic's Messages endpoint) β the HTTPS service (
POST api.anthropic.com/v1/messages) carrying the model calls in this guide; stateless for your conversation (the full history travels in themessagesarray each call). Distinct from tool backends (your DB, GitHub β called by your harness) and entry points (the webhook/UI a task arrives through). Also served via Amazon Bedrock (AWS) and Vertex AI (Google Cloud) with the same harness code. Every request field: Messages API Spec. - Claude API response β the JSON the Claude API returns per call:
id/type/role/model,content(an array oftext/tool_useblocks β never a string),stop_reason(branch on it first),stop_sequence, andusage(token counts + prompt-cache counters). Append the assistant message verbatim to the messages array before the next call. Field-by-field: Messages API Spec. - Closed schema β a JSON Schema with
additionalProperties: false; seeadditionalProperties. - Claude Code β Anthropic's agentic coding tool (CLI/IDE) whose configuration surface (memory, skills, hooks, settings, MCP) is Domain 2.
- Compaction β summarizing conversation history to reclaim context window (
/compact). - Confused deputy β a privileged intermediary (tool/server) tricked into misusing its authority; mitigated with least-privilege credentials.
- Context engineering β curating what enters the window per call: retrieval, compaction, isolation, caching, ordering.
- Context isolation β giving heavy work its own window (subagents) so the main context stays clean.
- Context window β the token budget for everything (system, tools, history, docs, output reservation); commonly 200K β check the current model's spec; larger tiers exist.
DβE
- Decision as data β the model returns typed choices (
tool_use, schema-bound JSON); deterministic code executes them. - Elicitation (MCP) β a server requesting additional input from the user through the client.
- Escalation β first-class terminal path handing a case to a human with a context packet.
- Evaluatorβoptimizer β generator + critic loop; use when clear evaluation criteria exist.
- Evals β programmatic quality gates (golden sets, judges, assertions) run on every prompt/model change.
- Extended thinking β API-enabled internal reasoning with a token budget for genuinely hard tasks; incompatible with prefilling.
FβH
- Few-shot / multishot β 3β5 diverse in-prompt examples; format mirrors matter more than instructions.
- Golden set β fixed eval scenarios with deterministic assertions on behavior (tools called, gates fired, terminal state).
- Graceful degradation β planned fallback ladder: primary model β fallback β template β honest failure; never silent.
- Headless mode β
claude -p: Claude Code with nobody at the terminal; machine-readable output,--allowedToolsas the gate,--max-turnsas the budget; how agents run in CI (continuous integration). - Guardrail β a deterministic check the model cannot bypass by wording (schema, allowlist, arithmetic bound).
- Harness β the deterministic code around the model: builds prompts, executes tools, applies gates, owns the loop.
- Hooks (Claude Code) β shell commands on lifecycle events (
PreToolUse,PostToolUse,Stopβ¦) that can observe, block (exit code 2, on supported events like PreToolUse), or run side effects (e.g. auto-format after a write); deterministic, unlike prompt instructions. - Host / Client / Server (MCP) β the LLM app / its per-connection connector (1:1, stateful) / the capability provider.
- Human-in-the-loop (HITL) β deterministic approval gate before high-risk actions; silence never equals approval.
- Hub-and-spoke β multi-agent topology where all coordination flows through the coordinator.
IβL
- Idempotency β retried operations produce the same effect once (keys + effects ledgers at the tool layer).
- Interaction modes (automation Β· augmentation Β· agency) β AI performs a defined task / AI as iterative thinking partner / AI acting independently under standing rules you configured; a maturity ladder for the same task.
- Indirect prompt injection β adversarial instructions arriving through tool results, documents, or MCP metadata rather than the user.
is_error(tool_result) β flag returning tool failure to the model so it can adapt; preferable to harness exceptions.- JSON Schema β the declarative language describing a JSON shape (
properties,required,type,enum,additionalProperties). A portable document: the same schema appears in a tool'sinput_schema(shapes the model's arguments), native structured-output config (where supported), and your harness's validator. - JSON-RPC 2.0 β the request/response JSON message format MCP uses over its transports (a method name + params in, a matching result or error out).
- LLM-as-judge β grading outputs with a separately validated judge model (often a different family, to reduce self-bias); calibrate the judge against human-labeled examples β judge agreement is a signal, not proof.
- Least privilege β every tool/server/token gets the minimum scope required.
MβO
- max_tokens β mandatory per-call output ceiling, enforced by the Claude API; reserves its allowance from the context window; hitting it =
stop_reason: max_tokens(incomplete β never parse as complete); bounds size only, never shape. - messages array β the whole conversation, oldest-first, resent in every request (the Claude API is stateless); new turns appended at the end: the assistant's response verbatim, then your tool_result in a user-role message;
system/toolsstay outside as the cacheable prefix. - MCP (Model Context Protocol) β open standard turning NΓM integrations into N+M via hosts, clients, and servers exposing tools/resources/prompts.
.mcp.jsonβ project-scoped MCP config, checked into git, env-interpolated secrets.- Model tiering β cheap/fast models for classification, frontier for reasoning, different family for judging.
- Multi-agent system β coordinator + specialized subagents; buys context isolation and parallelism at cost/latency price.
- Orchestratorβworkers β the coordinator decomposes dynamically, delegates, synthesizes.
PβR
- Parallel tool use β multiple
tool_useblocks in one response; return onetool_resultper id. - Pearson VUE β the certification's proctored delivery platform.
- Permission precedence β enterprise policy > CLI flags > local project > shared project > user settings.
- Prefill β starting the assistant turn (e.g.,
{) to force format; not combinable with extended thinking, and model-dependent on newer models β check current docs. - Prompt caching β reusing a byte-identical static prefix across calls; ~90% input-cost reduction on hits; order-sensitive.
- Prompt chaining β sequential calls with programmatic checks between steps.
- Prompt injection β adversarial text steering the model; defended in three layers (bound input β quarantine β deterministic output gates).
- Prompts (MCP primitive) β user-controlled templates a server exposes.
- Quarantine (input) β wrapping untrusted text in tags with a standing treat-as-data rule.
- Rate limiting (429) / Overloaded (529) β HTTP status codes the Claude API returns instead of a normal response: 429 = your throughput ceiling hit, 529 = Anthropic's side temporarily saturated; both β exponential backoff + jitter, respect
retry-after. - Resources (MCP primitive) β application-controlled, URI-addressed context/data.
- Routing (workflow) β classify then dispatch to specialized handling.
S
- Sampling (MCP) β a server requesting an LLM completion from the client's model.
- Scenario-based exam β CCAR-F's format: question clusters under system-description contexts.
- Skills (Claude Code) β folder-based reusable expertise (
SKILL.md+ resources). βModel-invokedβ = model-chosen: it matches your request against the skillβsdescriptionand selects it (or you type/name); Claude Code executes β loads the file, runs bundled scripts. - Slash command β user-invoked prompt template in
.claude/commands/with$ARGUMENTS. - stdio / Streamable HTTP β MCP transports: a local child process the host talks to over standard input/output, vs a remote networked service (SSE β Server-Sent Events β is the legacy remote transport).
- Stop reason β why generation ended (
end_turn,tool_use,max_tokens,stop_sequence,refusal); a closed set emitted by the Claude API; the harness's branch variable. - Streaming (SSE) β incremental token delivery; UX + stall detection.
- Structured output ladder β prompted JSON β prefill (legacy/model-dependent) β schema-as-forced-tool β native structured outputs /
stricttool inputs (where supported β the strongest shape guarantee) β validate + repair regardless. - Subagent (Claude Code) β a scoped worker with its own context window, system prompt, and tool policy.
- System prompt β the authoritative role/constraint channel, set via the
systemparameter; cache it.
TβX
- Token / token counting β a subword piece of Claude's own vocabulary (English β ΒΎ word; code denser); count exactly and free with
POST /v1/messages/count_tokens(same body ascreate, no generation), reuse the lastusage, or estimatechars/4for pre-flight β nevertiktoken, never a model call. - Temperature β sampling randomness; low for extraction/deterministic tasks, higher for ideation.
- Token β the billing and budget unit (~3β4 characters of English); everything is measured in it.
- Tool poisoning β malicious MCP tool descriptions/results carrying injected instructions; mitigated by vetting, pinning, least privilege.
tool_choiceβauto/any/ forced specific tool /none; forcing a schema-tool is the structured-output move.- Tool-use handshake β the model DECIDES and WRITES (
tool_useis JSON it authored β a request, not an action); your code EXECUTES (the dispatcher is the only place a tool runs);tools/tool_choicetravel youβAPI,tool_useAPIβyou,tool_resultyouβAPI. The API executes only Anthropic-defined server tools. - Tool registry β where the tool list lives: the Claude API stores nothing between calls (tools[] is resent per request, made cheap by prompt caching), so definitions live in your code (definitions + implementations side by side), a central catalog with per-agent allowlists, or MCP servers discovered at runtime.
tool_useβ the Claude API's signal that the model wants a tool executed: astop_reasonvalue AND content block(s) carrying the toolname, JSONinput, and anid(e.g.toolu_01A) the Claude API generates; echo that id back astool_use_id.tool_resultβ the harness's reply to atool_userequest, sent in a user-role message; must echo the Claude-API-generated id astool_use_id(one result per request, matched by id);is_error: truereports failures the model can react to.- Tools (MCP primitive) β model-controlled executable actions (= the model holds the INITIATIVE to invoke; the SERVER executes β the handshake never changes).
- Trust boundary β the line where code/data you control ends and something you don't begins; every guardrail sits on one (input β harness, model output β execution, tool results β model context).
- Trajectory evaluation β judging the agent's path (tools, order, gates) not just its final answer.
- Workflow β LLM steps orchestrated through predefined code paths; prefer over agents when the path is known.
- Worktree isolation β separate git worktrees so parallel agents can't collide on files.
- XML tags β the Anthropic-recommended delimiter convention for separating instructions, data, examples, and output sections; they guide the model strongly but are not a parser or security boundary.