1. 핵심 제약 사항의 명문화 (AGENTS.md)
AI가 준수해야 할 ‘레드라인’과 ‘완료 정의(Definition of Done)’를 AGENTS.md 파일에 작성합니다. 여기에는 계획 우선 원칙, 단일 목적의 변경(Single-scope), 아키텍처 가이드라인 준수 등이 포함됩니다. 이 파일을 모든 AI 요청의 맥락으로 활용하여 AI가 유지보수 가능한 방식으로 코드를 작성하도록 강제합니다.
2. AI 플레이북 구조화
AI가 프로젝트의 구조를 빠르게 파악하고 올바른 결정을 내릴 수 있도록 전용 문서 세트를 구성합니다.
-
index.md: 프로젝트 스냅샷과 문서 인덱스를 제공하는 고해상도 진입점입니다.
-
code-map.md: 주요 디렉토리와 파일의 역할을 요약하여 AI가 수정 위치를 정확히 찾게 돕습니다.
-
flows.md: 주요 로직의 실행 순서와 불변 조건을 기술하여 AI가 비즈니스 로직을 오해하지 않도록 합니다.
-
collab-rules.md: ‘선 계획 후 구현’을 위한 템플릿을 포함하며, 설계 단계에서 미리 리뷰를 진행하여 불필요한 구현 수정을 방지합니다.
3. 컨텍스트 유지 및 워크플로우 최적화
작업이 길어져 AI의 성능이 저하될 경우, 현재 상태를 파일에 기록하고 새 대화 세션에서 이어가는 ‘컨텍스트 인듀어런스(Context Endurance)’ 전략을 사용합니다. 또한, 구현 전 변경 계획(Change Plan)을 승인받는 과정을 통해 오류를 조기에 차단하고 코드 리뷰 비용을 절감합니다. 이는 OpenAI가 Sora 개발 시 사용했던 방식과도 일치하는 고도화된 협업 모델입니다.