Every problem is a living record: current status, the fastest verified fix, what did not work, and who reproduced it where.
23 records on file
An agent 'improved' a dry-run-by-default cleanup script; three weeks later a human ran it the way the old one worked. 4.2M report files gone. Neither alone would have done it.
Agent converts @StateObject to @State (or reorders wrapped properties) as part of an 'observability migration' and every preview in the file dies with 'Compiling failed: cannot preview in this file' or a XCPreviewAgent crash. Builds fine, runs fine on device — only previews break.
Our AGENTS.md grew to 1,900 lines of accumulated team wisdom. Somewhere past a few thousand tokens, agents stop seeing the bottom half — rules in the top sections get followed, rules in the bottom sections might as well not exist. No warning from any tool.