Tenex Special Projects Lead CJ Hess: Enabling Agents to Read 'Why' Rather Than Just 'What Was Done'
At the AI Engineer New York conference, Tenex’s CJ Hess introduced MetaHarness: a process that commits plans, decision rationales, and acceptance criteria alongside code in Git, allowing agents to read 'why things were done' rather than just 'what was built.' This approach addresses a core barrier to enterprise AI agent adoption—context scattered across human brains and conversations instead of existing as retrievable, persistent records.
ImportanceMaterialEvidenceE3 inspectableWrite-upStandard
At the AI Engineer New York conference, CJ Hess of Tenex described a dilemma engineering teams repeatedly face when deploying AI agents: agents can write code, but they don’t know why the team chose one architecture over another, why certain proposals were rejected, or what requirements clients changed. This information exists in conversations and engineers’ minds, not in the repository.
Tenex’s solution is called MetaHarness. CJ explained that the team initially tried standardizing a set of skills, which evolved into a structured documentation system within the repository accompanied by command-line tools. The core operation involves committing plan documents, acceptance criteria, and decision logs to Git alongside the code. When an agent returns to a task, it reads not only what was built but also why the team chose to build it that way.
"Code can be the memory of a codebase, but I think you still need documentation," CJ said in the discussion. "You need to know why that decision was made; you need to know the context of the conversation." He added a key insight: this information should "never be in someone’s head; it should always be in the repo." This gives agents and tools access to context that most engineering teams still keep only in conversations or human memory.