AI가 더 쉽게 이해할 수 있는 폴더 구조는 뭘까?

발행 3 months ago

4 min read

AI의 코딩 실력을 탓하기 전에, 당신의 폴더 구조가 AI를 길을 잃게 만들고 있지는 않은지 확인해 보세요.

Cursor, ClaudeCode 등 AI 코딩 도구를 활용하며 대규모 프로젝트를 관리하는 개발자

·역할 기반(lib/screens, lib/models)보다는 기능 기반(features/auth) 구조가 AI의 탐색 비용을 획기적으로 줄여준다.

·파일 이름에 기능 접두사를 붙이고(auth_screen.dart), core/ 폴더는 최소화하여 의존성 혼란을 방지해야 한다.

·각 기능 폴더에 짧은 README.md를 배치하면 AI가 폴더의 목적과 진입점을 훨씬 빠르게 파악한다.

@jmaru