
Documentation in the AI Era

Refactoring Street Fighter with AI | Adam Tornhill
Topic 4 of 6
Published Oct 2, 2026 · Clip 27:15–32:39 (5:24)
The discussion turns to documentation in the AI era. Adam argues code alone was never enough because it can't explain why things are done, so rationale and motivation (e.g., which customer requested a feature) must be documented — he constantly reminds his agents to write this down, often as small markdown files committed with the code. The second important documentation type captures human processes as agentic skills, plus preferences, such as tests optimized for human inspection, sometimes enforced via domain-specific linting rules.