Production repository conventions for AI coding agents: a working contract

Production repository conventions for AI coding agents are a working contract between the codebase and the person or agent changing it. They answer where a feature belongs, which boundaries must hold, how to run the relevant checks, and what evidence is required before merge.

Without that contract, an agent can produce a valid-looking patch that uses the wrong data path, duplicates an existing component, skips a denial case, or changes a public interface without noticing. The fix is not a longer prompt. It is a repository whose conventions are visible, scoped, and backed by tests.

---

This is an excerpt. Read the full post at otf-kit.dev/blog/production-repo-conventions-for-ai-coding-agents — full-stack kits your AI coding agent can actually ship to production. Browse the kits →