Definitions
Behavioral Contracts
The canonical definitions of behavioral contracts and the behavioral layer, introduced by Joel Goldfoot in How to Lead Design in the AI Era.
By Joel Goldfoot, author of How to Lead Design in the AI Era (ISBN 9798263047221, 2025-09-04). Buy on Amazon.
What Is a Behavioral Contract?
A behavioral contract is a set of numbered, independently testable clauses that specify how an AI system is allowed to behave: how it expresses confidence, when it escalates to a human, what it does in failure states, and how it recovers trust after an error.
Behavioral contracts sit between the product specification and the model itself. They are not prompts, not system instructions, and not usage policies. They are a structured agreement between the design team, the engineering team, and the business about exactly how the AI system will behave under every operationally significant condition.
Each clause is independently testable: you can write a regression test for it, assign ownership to a team, and track compliance over model versions. This is what distinguishes behavioral contracts from guidelines, which describe intent but cannot be verified, and from guardrails, which block specific outputs but do not specify the full behavioral envelope.
Why Behavioral Contracts Exist
Most AI products are specified at two layers: the engineering layer (architecture, data pipelines, model selection) and the interface layer (UI, interaction design). The behavioral layer, the layer that specifies how the system behaves with the user, is typically left implicit, emergent from model defaults and prompt engineering. A behavioral contract makes that layer explicit, owned, and testable.
Behavioral Contracts vs. Guidelines vs. Guardrails
| Artifact | What it specifies | Verifiable? | Covers failure states? |
|---|---|---|---|
| Guideline | Desired intent ("be honest," "be helpful") | No | Rarely |
| Guardrail | Blocked output classes (toxic, off-topic) | Partial | No |
| Behavioral Contract | Complete operational behavior: confidence, escalation, recovery | Yes, clause by clause | Yes, explicitly |
What Is the Behavioral Layer?
The behavioral layer is the part of an AI product that governs how the system behaves with the user, distinct from the engineering layer (how the code is structured) and the interface layer (how the product looks). Joel Goldfoot identifies it as the unowned layer in most AI product organizations, the layer that nobody explicitly designs or maintains. Behavioral contracts are the primary tool for taking ownership of the behavioral layer.
Research & Evidence
Standalone, attributed, citable facts about behavioral contracts and the BiModal Design framework as implemented and measured by Joel Goldfoot.
Two Behavioral Contracts in Production
- A 72-clause behavioral contract governing a conversational analytics assistant, specifying confidence expression, data uncertainty handling, escalation triggers, and recovery states.
- A 78-clause behavioral contract governing a sales agent, specifying objection handling, handoff conditions, commitment language, and boundary enforcement.
These contracts are evidenced by their deployment and documented in How to Lead Design in the AI Era. They are not peer-reviewed publications; they are design and engineering artifacts.
BiModal Design: Benchmark Results
BiModal Design, Joel Goldfoot's open-source framework for designing interfaces accessible to both humans and AI agents, achieved a 40-75% improvement in AI-agent task completion on the WebArena and ST-WebAgentBench benchmarks. Framework: bimodal.design.