AI 개발 에이전트 — 같은 설명 그만, 토큰 아끼는 세 가지 세팅
코덱스(Codex)·안티그래비티(Antigravity)·클로드 코드(Claude Code)로 앱을 만들 때, 새 채팅마다 같은 설명을 반복하지 않게 하는 세 가지 세팅입니다. 지침 파일, 새 채팅과 인수인계, 해결 기록을 찾아 쓰게 하기(RAG)와 옵시디언 연결까지 — 영상에 나온 문장을 그대로 복사해 쓰세요.
대상: 코덱스·안티그래비티·클로드 코드로 앱이나 프로그램을 만드는 분.
표시 — 🎬 영상 화면에 그대로 나온 문장 / ✍️ 영상 내용을 바로 쓸 수 있게 다듬은 문장.
한눈에 보기
문제 · 새 채팅마다 프로젝트를 다시 설명한다
1.자주 하는 설명은 지침 파일에 남긴다
쓰는 곳 · AGENTS.md·CLAUDE.md 등
문제 · 대화가 길어져 AI가 이미 실패한 방법을 다시 꺼낸다
2.일이 달라지면 새 채팅, 이어 갈 일은 인수인계서로 옮긴다
쓰는 곳 · 인수인계 요청문
문제 · 한 번 고친 오류를 다음에 또 처음부터 푼다
3.해결 과정을 기록하고, 필요할 때 찾아 쓰게 한다
쓰는 곳 · 옵시디언 같은 기록 보관함
1. 매번 하는 설명은 지침 파일에
새로 합류한 개발자에게 알려 줄 내용이라고 생각하면 됩니다. 지침은 두 군데로 나눕니다.
- 전역 지침 — 여러 프로젝트에 공통으로 적용할 기준
- 프로젝트 지침 — 그 앱의 작업 기준
전역 지침 예시
🎬 영상 화면에 그대로 나온 문장
프로젝트 지침 예시 (예약 앱)
🎬 영상 화면에 그대로 나온 문장
지침 파일 초안을 AI에게 맡기는 요청문
✍️ 영상 내용을 바로 쓸 수 있게 다듬은 문장
도구별 대표 지침 파일
- Codex
AGENTS.md- Claude Code
CLAUDE.md- Antigravity
AGENTS.md,GEMINI.md및 Rules
2. 일이 달라지면 새 채팅, 이어 갈 일은 인수인계
- 예약 오류를 고치던 채팅에서 관리자 화면 디자인까지 시작하면 서로 다른 일의 맥락(콘텍스트)이 섞입니다. 목적이 달라지면 새 채팅으로.
- 같은 문제를 잘 풀고 있는 중이면 그대로 이어 가도 됩니다. 새 채팅을 자주 여는 것 자체가 목적은 아닙니다.
- 같은 폴더에서 새 채팅을 열면 그 폴더의 지침은 그대로 이어집니다. 세부 작업만 나눠진다고 생각하면 됩니다.
인수인계를 맡기는 요청문 (하던 채팅에서)
🎬 영상 화면에 그대로 나온 문장
영상 시연에서 실제로 짧게 쓴 요청문도 같은 역할을 합니다.
영상 시연에서 쓴 짧은 요청문
🎬 영상 화면에 그대로 나온 문장
인수인계서에 들어가야 할 것 (예약 앱 예시)
🎬 영상 화면에 그대로 나온 문장
- 목표: 중복 예약 문제 해결
- 유지할 조건: 기존 로그인 흐름
- 변경한 파일: 실제 수정 파일 경로
- 이미 시도한 방법: 무엇을 했고 왜 해결되지 않았는지
- 테스트: 통과·실패·미실행 구분
- 다음 행동: 남아 있는 실패 사례 재현
새 채팅 첫 메시지
✍️ 영상 내용을 바로 쓸 수 있게 다듬은 문장
3. 해결한 문제는 기록하고, 필요할 때 찾아 쓰기
이 내용이 채팅 속에만 있으면 다음 개발에서 다시 찾아 설명해야 합니다.
- 이 오류는 왜 발생했는지
- 어떤 방법이 실패했는지
- 최종적으로 무엇을 바꿨는지
해결 기록을 남기게 하는 요청문 (문제를 고친 직후)
✍️ 영상 내용을 바로 쓸 수 있게 다듬은 문장
기록을 찾아 쓰게 하는 요청문
🎬 영상 화면에 그대로 나온 문장
이렇게 필요한 자료를 찾아 작업에 보태는 방식을 RAG(검색 증강 생성)라고 합니다. 기록이 백 개 있어도 매번 백 개를 다 읽히는 게 아니라, 예약 오류를 고친다면 예약 처리와 관련된 기록부터 찾게 하는 겁니다.
개발 기록 보관함 예시
4. 옵시디언을 장기기억으로 연결하기
옵시디언은 메모를 내 컴퓨터 폴더에 텍스트 파일로 저장합니다(보관함 = 볼트). 옵시디언을 설치하는 것만으로 AI가 기록을 읽지는 않습니다.
- 보관함 위치를 알려 준다 — 지침 파일에 볼트 폴더 경로를 적는다.
- 그 폴더를 읽고 쓸 수 있게 한다 — 도구 설정에서 그 폴더의 파일 읽기·쓰기 권한을 준다(영상에서는 Codex 설정의 기본 권한 화면).
- 지침에 쓰는 법을 적는다 — 아래 문장을 지침 파일에.
지침 파일에 넣을 문장
🎬 영상 화면에 그대로 나온 문장
저장 규칙까지 넣으려면 (지침 파일에 이어서)
✍️ 영상 내용을 바로 쓸 수 있게 다듬은 문장
이렇게 해 두면 새 채팅에서도, 다른 개발 도구에서도 같은 기록을 이어서 쓸 수 있습니다. 쌓일수록 관련 기록끼리 연결돼서 찾을 거리가 늘어납니다.
이 자료를 만든 저희가 직접 만든 것
뤼미에르 가격에 Claude 이용료는 포함되지 않습니다. Claude는 Anthropic의 상표이며, 뤼미에르는 Anthropic과 제휴하거나 보증받은 제품이 아닙니다.
꼭 기억할 것
- 오래된 기록을 그대로 믿지 않기 — 최종 확인은 지금의 코드와 테스트로.
- 토큰이 얼마나 줄어드는지는 사용 방식·요금제·캐시에 따라 다릅니다. 반복 설명과 재시도를 줄이는 것이 목적입니다.
- 오늘 바로 할 일: AI에게 가장 자주 반복하는 설명 하나를 지침 파일에 남기기.
참고 문서
Codex·Claude Code·Antigravity·Obsidian은 각 회사의 상표이며, 이 자료는 각 회사와 관계가 없습니다.
다음 단계
어떤 일이 번거로운지 남겨 주시면 연락드려요.
상담 남기기새 자료가 나오면 제일 먼저 받아 보세요
이런 따라 하기 자료와 모션 코드를 새로 올리면 이메일로 알려 드려요. 광고 메일을 마구 보내지 않아요.
언제든 수신 거부할 수 있습니다.
더 보고 싶으시다면
▶ 디렉터스AI 유튜브 보러 가기홈페이지의 다른 자료도 둘러보세요.