AI Repo Setup

Prepare a repository so AI coding agents can navigate, implement, and verify changes with minimal friction.

Core philosophy: AI agents are new starters with no memory. Every session starts fresh. The codebase itself — not documentation — is the primary context. Only document what is undiscoverable and globally relevant.

Inputs to gather (if missing)

• One-sentence project description (what does this project do?)
• Functional requirements (what the system should do)
• Non-functional requirements (performance, security, scalability constraints)
• Business rules (domain logic, validation rules, constraints)
• External issue tracker (Linear, Jira, GitHub Issues, ClickUp, etc.) — if used by the team
• Behavioral preferences for agents (see step 4 for what to ask)

Workflow