Delete (most of) your docs

YouTube Shorts · YouTube

• Core claim: treating extensive documentation as an AI codebase’s “source of truth” is an anti-pattern — costs tokens and creates confusion when docs drift from the actual code.
• Advocates a code-centric approach: well-structured, well-named code should be the primary source AI agents read from, with docs trimmed to only what can’t be inferred from source.
• Consistent throughline with Matt’s /init/CLAUDE.md critiques (Feb 2026 videos) — the same “verbose generated context is a token tax” argument, now applied to project documentation generally.
• Takeaway: audit project docs for what AI agents actually need vs. what’s redundant with readable code, and delete the redundant majority.