개발자가 Seed File(마크다운 기반 프로젝트 컨텍스트 문서)을 AI 채팅 세션 시작 시 붙여넣어 수정 횟수 3~5회 → 첫 응답부터 사용 가능 수준으로 단축

Context

Large Language Model은 대화 세션 간 상태를 저장하지 않으며, 각 세션마다 고정 크기의 컨텍스트 윈도우로 시작한다. 개발자가 AI 어시스턴트에게 기술 작업을 요청할 때마다 프로젝트 스택, 코딩 컨벤션, 아키텍처 결정사항을 반복 설명해야 한다.

Technical Solution

• Seed File 형식 정의: 프로젝트 루트에 SEED.md 파일 생성 (300단어 이하)
• Seed File 구조 표준화: Stack(2~3줄) + Patterns(3~5줄) + Current Work(1~2줄) + Rules(2~3줄)
• 세션 시작 프로토콜: AI 채팅 첫 메시지에 Seed File 전체 붙여넣기 후 실제 작업 요청 진행
• Seed File 내용 원칙: 기술 스택·설계 결정·프로젝트별 규칙만 포함, 일반 상식(JavaScript 중괄호 문법 등) 제외
• 구체적 내용 우선: "We use Prisma" 대신 "Prisma with explicit select (no implicit relation loading)"처럼 결정사항 기술
• 버전 관리: 아키텍처 변경 시 Seed File을 동일 커밋에서 업데이트
• 도구별 확장 경로: 수동 복사(Seed File) → API 자동화(System Prompt) → 대규모 코드베이스(RAG)

Impact

Seed File 도입 전: 세션당 처음 3~5개 메시지에서 "app router 사용", "정수 센트 단위", "useEffect 금지" 등 반복 수정 필요. Seed File 도입 후: 첫 번째 응답부터 대부분 사용 가능 수준. 월 단위로 수 시간의 상호작용 시간 절감.

Key Takeaway

개발 워크플로우에서 AI 도구의 유용성은 암묵적 기억(내장 메모리)보다 명시적 컨텍스트(문서화) 제공에 의존한다. 프로젝트별 기술 결정사항을 구조화된 형식으로 명문화하면 AI-인간 협업의 첫 응답 품질이 대폭 개선된다.