Working Surfacelink · 28 Sep · 04
04
Three figures seen from behind, the backs of their heads showing, stand at a tall shelf of shared binders, each binder hung with a plain tag, and one of them lifts a worn page out while a small robot at a reading desk below studies another binder before starting work, the whole scene drawn with wide empty margins on every side.
Atlassian

Introducing CAFE(S): A framework for defining AI context quality

Brian Houck · 24 September 2026

Company story · agents · artifacts · Agent context files

Read the original
Takeaway

Brian Houck of the developer-research firm DX defines five qualities of the instructions AI agents read, and argues that each shared instruction file needs a team that owns it.

Summary

AI agents act on the context they are given: the instructions, specifications and documents they read before they work. Brian Houck, a Distinguished Scientist at the developer-productivity research firm DX, wrote on Atlassian's blog about what makes that context good. He and four co-authors of a paper in the journal ACM Queue define five qualities: clarity, actionability, fidelity (being true and current), efficiency and security.

Key points
  • Poor context once cost a developer a question to a colleague. It can now cost money, legal liability and security, as when Air Canada was held liable for a promise its chatbot made.
  • Shared context files that many agents read should be reviewed like code, with more review the more widely a file is reused.
  • Important context should have an owner and a review schedule, and the owner should be a team: "Ownership should follow teams rather than individuals, so context survives reorgs."
  • Untrusted input should be kept apart from instructions. The authors cite a crafted email that made Microsoft 365 Copilot, Microsoft's AI assistant, leak internal documents.
Implication

A product team whose agents read shared design or product files can assign each file to a team and review changes to it like code. The authors write about engineering context, and the application to design and product files is an inference and is not their claim.

Suggested actions
Product

Assign each context file that agents read to an owning team rather than to one person, so that the file keeps an owner through a reorganisation.

Design

Give every design-system file that AI agents read a named owning team, and review changes to a file more carefully the more screens depend on it.

Derived by Working Surface from the article. Source line: Ownership should follow teams rather than individuals, so context survives reorgs.

Source issue

28 September 2026: when agents build, people keep the first screen, the review, the files agents read and the whole product.