핵심 정리

컨텍스트 층 나누기
- AGENTS.md: 저장소 규칙, 검증 명령, 완료 기준
- 프롬프트: 이번 작업 목표, 제약, 확인할 파일
- Memories: 이전 스레드에서 반복되는 사용자·프로젝트 맥락
- Chronicle: 최근 화면 흐름에서 생긴 작업 맥락

먼저 볼 기준
1. 반복 규칙이면 AGENTS.md에 둔다.
2. 이번 작업에만 필요한 사실이면 프롬프트에 둔다.
3. 장기적으로 다시 쓰는 배경이면 Memory로 남긴다.
4. 화면 상태가 단서이면 Chronicle을 쓰되 민감 화면은 먼저 멈춘다.

역할 구분

Memories는 매번 다시 설명하는 배경을 줄이는 장기 컨텍스트다

Memories는 이전 대화에서 반복되는 선호, 프로젝트 관례, 자주 쓰는 도구, 최근 작업 흔적을 다음 세션에서 다시 활용하기 위한 층입니다. 저장소 내부의 명시 규칙을 대체하지는 않습니다. 예를 들어 "이 저장소는 빌드 후 graphify를 갱신한다"처럼 저장소 전체 규칙이면 AGENTS.md에 두는 편이 낫고, "사용자는 완료 보고를 짧게 선호한다"처럼 작업자와 사용자 사이의 반복 맥락이면 Memory가 더 적합합니다.

공식 문서 기준으로 Memories는 Codex home 아래에 저장됩니다. 기본 위치는 ~/.codex이고, 주요 memory 파일은 ~/.codex/memories/ 아래의 마크다운 자료로 관리됩니다. 로컬 파일이므로 읽고 수정할 수 있지만, 임의로 새 정보를 직접 추가하기보다 Codex가 생성한 내용을 검토·정리하는 방향이 안전합니다.

Chronicle은 화면 맥락을 Memory 생성에 쓰는 보조 장치다

Chronicle은 최근 화면 상태를 바탕으로 Codex가 어떤 파일, 앱, 대시보드, PR, 문서가 관련 있는지 추론하는 데 도움을 줍니다. 화면을 그대로 정답으로 쓰는 기능이 아니라, 필요한 원본을 더 잘 찾기 위한 단서에 가깝습니다. 그래서 "방금 보고 있던 PR의 실패 로그를 기준으로 수정해 달라" 같은 요청에는 유용하지만, 최종 판단은 실제 로그 파일, 테스트 결과, PR diff처럼 더 권위 있는 원본으로 다시 확인해야 합니다.

Chronicle은 화면 캡처와 OCR 텍스트 같은 민감한 정보를 다룰 수 있습니다. 회의, 고객 정보, 비공개 문서, 인증 토큰이 보이는 화면에서는 일시 중지한 뒤 작업하는 편이 맞습니다. 화면에 악성 지시문이 보이는 경우 prompt injection 위험도 커지므로, 외부 웹페이지나 불신 문서가 열린 상태에서는 Chronicle을 컨텍스트 원천으로 과신하지 않아야 합니다.

선택 기준

컨텍스트를 넣는 위치가 틀리면 Codex가 다음 작업에서 잘못된 우선순위를 잡습니다. 일회성 제약을 Memory처럼 장기화하면 나중에 다른 작업을 방해하고, 저장소 규칙을 프롬프트에만 적으면 새 스레드에서 누락됩니다. 컨텍스트는 "얼마나 오래 유지되어야 하는가"와 "누가 따라야 하는가"를 기준으로 나누는 편이 안정적입니다.

주의할 점

실패 예시
- "전에도 이렇게 했으니 이번에도 알아서 해줘"만 남기고 검증 명령을 적지 않음
- Chronicle이 본 화면을 원본으로 믿고 실제 파일이나 로그를 확인하지 않음
- 민감한 고객 화면을 켠 상태에서 Chronicle을 계속 사용함
- 팀 정책을 개인 Memory에만 남겨 다른 작업자나 환경에서 누락됨