The cursorrules and CLAUDE.md setup I use for every AI product I build

Context

AI 기반 제품 개발 시작 시마다 Cursor 규칙 설정, CLAUDE.md 작성, 에이전트 동작 구성에 1시간이 소요되었다. 이 반복적인 설정 작업으로 인해 AI 코딩 세션이 매번 컨텍스트 없이 시작되어 모델이 기존 컨벤션을 무시하고 이미 결정된 사항을 재작성하는 문제가 발생했다.

Technical Solution

• .cursorrules 파일 도입: React + TypeScript 엄격 모드 컨벤션, AI 컴포넌트 패턴(스트리밍, 도구 호출, 로딩 상태), Tailwind 클래스 정렬 규칙, 파일 네이밍 및 폴더 구조, useEffect 데이터 페칭 금지 및 any 타입 제거 규칙을 단일 파일에 명시
• CLAUDE.md 파일 도입: 애플리케이션의 기능, 기술 스택, 파일 구조, 수정하면 안 되는 부분을 정의하여 Claude가 매 세션 시작 전에 읽도록 설정
• AGENTS.md 파일 도입: 멀티 에이전트 워크플로우 실행 시 각 에이전트의 역할과 경계, 코드베이스의 어느 부분을 소유하는지 명시
• 3개 파일을 프로젝트 루트에 배치하고 스택 참조를 프로젝트 설정에 맞게 조정하여 즉시 적용

Key Takeaway

AI 코딩 도구의 생산성은 매 세션마다 프롬프트를 반복하는 것이 아니라 프로젝트 루트에 기계 판독 가능한 컨텍스트 파일을 배치하는 것으로 극대화될 수 있다.