# 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](https://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 →](https://otf-kit.dev)*