Preparing your repo for AI development: Lessons from Gram

Building the Gram codebase with a focus on ease of use for both developers and AI agents has inadvertently enhanced its AI-friendliness, as the principles of clarity and discoverability benefit both groups. The project employs a contract-first design approach with extensive code generation using tools like Goa, SQLC, Speakeasy, and Atlas, facilitating tasks like API endpoint creation and database migrations. The monorepo structure of Gram consolidates all components, such as the server and web app, which allows seamless interaction and reduces context switching. The use of a polyglot development environment manager, Mise, organizes and simplifies tasks, making it easy for agents to execute commands and ensure a smooth development setup through automation. While AI agents excel at repetitive tasks and pattern recognition, developers focus on design and complex problem-solving, leveraging AI for efficiency in routine operations. This structure not only streamlines AI integration but also accelerates onboarding for new team members and enhances overall codebase productivity.