Convince-XConvinceX
← Harness

자동 트리거 & 컨텍스트 맵 —
세션 간 기억 시스템

AI는 세션이 끝나면 모든 것을 잊습니다. 어제 어떤 작업을 했는지, 어떤 결정을 내렸는지, 다음에 뭘 해야 하는지. 매번 처음부터 설명해야 합니다.

이건 단순한 불편함이 아닙니다. 연속성이 없으면 같은 실수를 반복하고, 이전 맥락을 모르니 잘못된 판단을 하고, 결국 생산성이 무너집니다.

이 문제를 구조적으로 해결하기 위해 자동 트리거와 컨텍스트 맵을 설계했습니다.

• • •

AI의 기억 문제

AI 코딩 어시스턴트와 함께 SaaS를 운영하면, 세션 단위의 기억 한계가 매우 구체적인 문제를 만듭니다.

맥락 손실. 어제 "파이프라인 기능의 API를 수정했다"는 사실을 오늘의 AI는 모릅니다. 오늘 같은 파일을 건드리면서 어제의 수정을 덮어쓸 수 있습니다.

결정 망각. "이 기능은 다음 버전에서 구현하기로 했다"는 결정을 했는데, 다음 세션에서 AI가 그 기능을 바로 구현하려고 시도합니다.

우선순위 혼란. "지금 가장 중요한 건 X다"라는 합의가 세션이 바뀌면 사라집니다.

세션 간 기억 손실
세션 A
API 수정 완료
결정 3건 합의
X
세션 B
기억 없음
처음부터 다시
트리거 적용 후
맥락 자동 로드
이어서 작업

처음에는 매 세션 시작 시 직접 "어제 우리가 한 일은..."을 타이핑했습니다. 그런데 프로젝트가 커지면서 설명해야 할 맥락이 너무 많아졌습니다.

• • •

자동 트리거란

자동 트리거는 특정 이벤트가 발생했을 때 자동으로 실행되는 동작입니다. 사람이 개입하지 않아도 구조적으로 작동합니다.

핵심 아이디어는 간단합니다. AI가 "기억"하게 만드는 게 아니라, 필요한 정보를 자동으로 "주입"하는 것.

기억에 의존하면 실패합니다. 주입에 의존하면 구조적으로 보장됩니다.

• • •

세션 시작 트리거

가장 중요한 트리거입니다. 세션이 시작될 때 자동으로 실행됩니다.

이 트리거가 하는 일은 두 가지입니다.

1. 컨텍스트 맵 로드. 프로젝트의 파일 구조, 기능 목록, 현재 상태 등이 정리된 맵 파일을 자동으로 읽습니다.

2. 다음 세션 알림 확인. 이전 세션이 끝날 때 기록해둔 "다음에 해야 할 일" 목록을 자동으로 로드합니다.

세션 시작 트리거 흐름
STEP 1
세션 시작
STEP 2
컨텍스트 맵 로드
STEP 3
알림 확인
STEP 4
상태 보고

이 과정이 자동이라는 게 핵심입니다. 사람이 "지난번에 뭐 했는지 확인해"라고 말할 필요가 없습니다.

• • •

키워드 기반 주입

두 번째 트리거는 입력 트리거입니다. 사용자가 특정 키워드를 입력하면 관련 파일이 자동으로 로드됩니다.

예를 들어 "콘텐츠"라고 입력하면, 콘텐츠 전략 문서, 이전 포스트 목록, 브랜드 가이드라인이 자동으로 컨텍스트에 추가됩니다.

AI에게 "이 파일 읽어봐"라고 말하는 대신, 키워드 하나로 관련 파일 전체가 자동 로드됩니다.

이 시스템의 장점은 사람이 어떤 파일이 필요한지 기억할 필요가 없다는 것입니다.

• • •

컨텍스트 맵 설계

컨텍스트 맵은 프로젝트의 "지도"입니다. 키워드와 관련 파일 클러스터를 연결하는 매핑 파일입니다.

설계 원칙은 세 가지였습니다.

1. 키워드는 작업 단위로. 파일 이름이 아니라, 실제 작업할 때 쓰는 단어를 키워드로 씁니다.

2. 클러스터는 작업에 필요한 모든 것을. 모델 파일만이 아니라, 라우트, 프론트엔드, 테스트, 관련 설정까지 포함합니다.

3. 정기적으로 업데이트. 새 파일이 추가되거나 구조가 바뀌면 컨텍스트 맵도 갱신합니다.

컨텍스트 맵 구조 예시
"시퀀스" → 모델, 라우트, 프론트, 테스트, 설정
"콘텐츠" → 전략 문서, 이전 포스트, 브랜드 가이드
"배포" → 체크리스트, 환경 설정, 최근 이력
"검색" → 검색 전략, 데이터 소스, 캐싱 설정
• • •

7개에서 2개로

처음에는 트리거를 7개 만들었습니다. 세션 시작, 입력, 코드 수정 시작, 코드 수정 완료, 테스트 실행, 배포 전, 세션 종료. 모든 중요한 시점에 트리거를 걸었습니다.

결과는? 대부분의 트리거가 로깅만 할 뿐 실질적인 가치를 만들지 못했습니다.

트리거 정리 결과
세션 시작 트리거유지
컨텍스트 로드 + 알림 확인. 대체 불가.
입력 트리거유지
키워드 기반 파일 주입. 대체 불가.
코드 수정 시작/완료제거
핵심 원칙 + 검증 에이전트와 기능 중복.
테스트 실행 / 배포 전제거
기존 시스템의 출력과 중복.
세션 종료제거
워크플로우 스킬로 대체.

교훈: 적고 강한 트리거가 많고 약한 트리거보다 낫습니다.

• • •

세션 간 연속성

자동 트리거와 컨텍스트 맵의 조합이 만드는 가장 큰 효과는 세션 간 연속성입니다.

20번째 세션을 시작할 때, AI는 자동으로 이전 19번의 세션에서 축적된 맥락을 파악합니다. 사람이 설명할 필요가 없습니다.

물론 완벽하지는 않습니다. 컨텍스트 맵이 오래되면 잘못된 정보가 주입될 수 있고, 알림이 너무 많으면 중요한 것이 묻힐 수 있습니다.

하지만 수동으로 매번 맥락을 전달하던 시절과 비교하면, 생산성 차이는 극적입니다. 세션 시작 후 작업에 들어가기까지의 시간이 10분에서 30초로 줄었습니다.

AI의 기억력을 향상시키려 하지 마세요. 기억이 필요 없는 구조를 만드세요.

기억은 불안정합니다. 구조는 안정적입니다. 이 원칙은 AI 거버넌스 전반에 적용됩니다. 규칙을 "기억"시키는 대신 구조로 강제하고, 맥락을 "기억"시키는 대신 자동으로 주입하고, 절차를 "기억"시키는 대신 워크플로우로 정의합니다.

이것이 세션 간 기억 시스템의 핵심 철학입니다.