저장소(repository)가 소프트웨어 시스템을 설명하지 못해서 실수하는 거거든요

AI 에이전트가 코드를 못 읽어서 실수하는 게 아니에요. 저장소(repository)가 소프트웨어 시스템을 설명하지 못해서 실수하는 거거든요.

예를 들어 auth.ts랑 billing.ts 두 파일이 있을 때, AI 입장에서는 그냥 텍스트 두 개예요. 근데 현업에서는 완전히 달라요. 하나는 데모 경로일 수도 있고, 다른 하나는 결제·고객 신뢰·컴플라이언스가 걸린 핵심 파일일 수 있는데, 코드만 봐서는 그 차이를 알 수가 없어요.

이 글이 제안하는 건 '워크스페이스'라는 개념이에요. 단순히 큰 폴더가 아니라, 소유권·의존성·정책·검증 경로처럼 단일 소스 파일에는 없는 정보를 담는 운영 경계 레이어예요. AI가 진짜 프로덕션 변경을 안전하게 하려면, 코드 읽기 능력보다 이 컨텍스트 레이어가 먼저 필요해요.