Sentry CEO: keep design docs in the repo — agents need the intent

zeeg · x · 2026-11-22

Sentry CEO David Cramer (@zeeg) says he refuses to move design documentation out of the repository: "Agents need intent."

The attached screenshot shows his AI tool Junior in action: before adding a createGoogleSlides feature, the agent asks whether to add a rule to design/google.md (presentations created by Junior belong to the requester, while Junior's account stays an editor so it can keep building), with a human confirming the exact wording. It's a practical example of persisting design intent as in-repo docs that agents follow.

Original post →

More from coding & agent

coding & agent channel →