CLAWPOD ENGINEERING
긴 작업을 이어갈 때: 기억과 인계 기록을 확인하는 방법
대화 맥락·장기 기억·작업 상태를 구분하고, 채워진 인계 예시로 결정과 근거를 확인하며 기록이 없을 때 복구하는 방법을 설명합니다.
긴 대화의 마지막에 “아까 정한 대로 해 줘”라고만 쓰면, Agent가 어떤 결정과 자료를 기준으로 삼았는지 확인하기 어렵습니다. 이 글은 ClawPod Cloud에서 여러 날 이어지는 조사·보고서 작업을 맡기는 실무자를 위한 안내입니다. 읽고 나면 현재 대화의 맥락, 오래 남길 기억, 미완료 작업 기록을 나누고 다음 작업의 출발점을 검증할 수 있습니다. 해당 Agent와 자료에 접근할 권한이 필요하며, 기억 저장과 작업 기록은 사용 가능한 도구·쓰기 권한·조직 정책 안에서만 요청합니다.
핵심은 대화를 길게 유지하는 것보다 다시 확인할 수 있는 작업 기준을 남기는 것입니다. 중요한 결정은 근거와 함께 기록하고, 이어서 실행하기 전에는 그 기록을 실제로 읽었는지 확인하세요. 기억 저장 요청이나 요약 한 번이 모든 내용의 보존과 자동 재개를 보장하지는 않습니다.
대화 기록, 현재 맥락, 장기 기억은 다릅니다
컨텍스트는 모델이 현재 응답을 만들 때 함께 참고하는 정보입니다. 세션은 런타임이 대화와 실행 상태를 묶어 관리하는 단위이며, 화면에서 보는 Room과 같은 개념으로 취급해서는 안 됩니다. Memory는 오래 유지할 결정·선호·업무 맥락을 관리되는 Agent 작업 공간에 기록하고 필요할 때 찾는 기능입니다.
공식 Guide는 긴 시작 지침인 bootstrap 문서가 컨텍스트 제한에 따라 잘릴 수 있다고 설명합니다. 이는 대화 본문은 절대 잘리거나 요약되지 않는다는 뜻이 아닙니다. 또한 화면에 과거 메시지가 보인다는 사실만으로 모델이 그 메시지 전체를 현재 응답에 사용한다고 판단할 수 없습니다.
이 글이 확인한 Guide에는 모든 Agent에 적용되는 정확한 컨텍스트 크기, 같은 세션 안에서 자동 요약이 시작되는 기준, 요약 뒤 모든 세부 사항이 유지된다는 보장이 없습니다. 따라서 “100만 토큰이니 계속 넣어도 된다”거나 “자동 요약이 있으니 인계 기록은 필요 없다”는 전제로 업무를 설계하지 않습니다.
요약과 저장은 서로 다른 확인이 필요합니다
긴 대화의 앞부분을 요약해 현재 맥락을 줄이는 처리를 보통 압축(compaction)이라고 부릅니다. 여기서는 개념을 구분하기 위한 용어이며 ClawPod Cloud의 특정 설정이나 화면을 안내하는 것이 아닙니다. 설치된 Agent 런타임에 이런 처리가 있더라도, 그 사실만으로 현재 조직에서의 설정·성공·보존 기간까지 확인된 것은 아닙니다.
Guide가 제품 안내로 명시하는 것은 새 세션이나 reset 때 최근 맥락을 일별 memory로 남길 수 있다는 점입니다. 이 가능성을 같은 세션의 자동 압축, 전체 원문 보존 또는 다음 작업의 무조건적인 재개와 혼동하지 마세요. 일별 기록이 만들어졌는지와 다음 응답에서 필요한 부분을 읽었는지는 각각 확인할 사항입니다.
중요한 작업에서는 Agent에게 “어떤 기록을 읽었고, 어떤 결정이 아직 유효하며, 무엇을 확인하지 못했는지”를 먼저 보고하게 하세요. 요약의 유창함보다 원본 자료와 연결되는지가 더 좋은 확인 기준입니다.
기억과 작업 보드에 서로 다른 내용을 남깁니다
아래는 Guide의 역할 구분을 업무에 적용한 기준입니다. 네 항목은 서로를 자동으로 복제하거나 대체하는 저장소가 아닙니다.
| 남길 정보 | 적합한 기록 | 다음에 확인할 것 |
|---|---|---|
| 오래 유지할 선호·확정 결정 | Memory | 현재 유효한 내용과 변경 날짜 |
| 이번 조사에서 읽은 근거·세부 메모 | 승인된 상세 문서 | 문서 위치, 판본과 근거 링크 |
| 팀이 공유할 담당자·진행·완료 기준 | Tasks | 작업 상태와 연결된 결과물 |
| Agent가 수행할 실행 단계·상태 | Workboard | 해당 카드의 결과와 남은 작업 |
Tasks는 조직의 공유 작업 현황을 추적하는 기능이고, Workboard는 Agent의 작업 보드에서 카드와 실행 상태를 관리하는 방식입니다. 어느 쪽을 사용하든 상태를 완료로 바꿨다는 사실만으로 결과물의 정확성이 증명되지는 않습니다. 작업 보드 선택은 병렬 실행 지정과도 다릅니다.
Memory 검색은 런타임의 기억 도구와 작업 공간 정책이 허용할 때 수행됩니다. Guide는 먼저 검색하고 필요한 부분만 읽도록 안내하며, 저장 요청도 도구 정책과 쓰기 권한을 따라야 한다고 설명합니다. “기억해 줘”라는 응답을 받는 것과 저장된 내용을 다시 읽어 확인하는 것을 나누세요.
여러 날의 보고서 작업을 넘기는 요청
다음은 가상 예시입니다. 실제 고객 자료나 실행 결과가 아니며, 도구 사용과 자료 접근이 허용된 환경을 가정합니다. 목표는 세 개의 내부 운영 보고서를 비교하는 초안을 만들되 원본 수정과 외부 전송은 하지 않는 것입니다.
승인된 작업 폴더의 4월·5월·6월 운영 보고서를 비교해 팀에서 검토할 비교 보고서를 작성해 줘. 원본을 수정하거나 외부로 보내지 마. 이번 작업의 기준은 처리 건수와 평균 처리 시간이며 비용 비교는 제외해.
먼저 기준과 자료 판본을 확인하고, 작업 기록에 완료 기준·결과물 위치·남은 질문을 남겨 줘. 오늘 작업을 멈출 때는 읽은 자료, 확인한 결과, 미확인 사항, 다음 행동을 인계 메모로 작성해 줘.
장기 기억에는 “월간 운영 비교는 처리 건수와 평균 처리 시간을 먼저 확인한다”는 팀 기준만 남겨 줘. 보고서 원문과 임시 계산값은 일반 기억에 복사하지 마. 기존 기준과 충돌하면 어느 기록이 다른지 알려 주고 확인 전에는 덮어쓰지 마. 저장이나 기록 도구가 없으면 완료했다고 하지 말고 가능한 결과물과 제한을 보고해 줘.
이 요청은 장기 기준과 이번 실행의 세부 사항을 분리합니다. 저장할 정보의 범위를 지정하지만, 실제 저장 성공이나 이후의 자동 조회까지 보장하는 문구는 아닙니다.
기대할 수 있는 인계 결과의 모양
가상 결과 표본 — 실제 실행 증거가 아닙니다. 아래처럼 채워진 기록을 받아 원본과 대조합니다. 파일 이름도 예시입니다.
| 항목 | 결과 표본 |
|---|---|
| 자료 | 4월·5월 보고서 판본 2, 6월 보고서 판본 1을 읽음 |
| 확인 결과 | 세 보고서의 처리 건수 정의는 같음. 평균 처리 시간은 6월만 주석 확인 필요 |
| 결과물 | 승인된 작업 폴더의 operations-comparison-draft.md와 handoff.md |
| 남은 질문 | 6월 평균 시간에 대기 시간이 포함되는가? |
| 작업 상태 | 초안 작성, 단위 비교 미완료. 최종 완료로 처리하지 않음 |
| 기억 확인 | 팀 기준 한 문장을 저장한 뒤 다시 읽어 내용 일치 확인. 보고서 원문은 저장하지 않음 |
| 다음 행동 | 6월 정의를 담당자에게 확인한 뒤 같은 기준으로 비교 가능한지 판단 |
여기서 중요한 결과는 그럴듯한 최종 보고서가 아니라 비교할 수 없는 부분을 미완료로 남긴 것입니다. 실제 응답에서 저장 경로나 확인 근거가 빠져 있다면 이 표본의 마지막 확인까지 끝났다고 받아들이지 마세요.
다음 작업 전에 네 가지를 확인합니다
- Agent에게 인계 메모와 해당 원본 판본을 실제로 읽고, 근거 위치를 보고하게 합니다. 이전 대화를 기억한다고 말하는 것만으로 대신하지 않습니다.
- 비교 기준에 비용이 들어가지 않았는지, 원본 수정·외부 전송 금지가 유지되는지 확인합니다.
- 6월 정의가 아직 미확인이라면 수치를 확정 비교하지 않도록 합니다. 답이 왔다면 출처와 확인 날짜를 추가하고 이전 가정을 구분합니다.
- 결과물 내용과 완료 기준을 대조한 뒤 작업 상태를 정리합니다. 장기 기억은 팀 기준만 포함하는지 따로 읽어 확인합니다.
이 절차는 해당 기록과 결과물에 대한 확인입니다. 모든 저장소·로그·백업에서 특정 내용이 완전히 삭제됐다는 개인정보 보증으로 확대해서는 안 됩니다.
기억이 없거나 충돌할 때는 확인 가능한 곳에서 다시 시작합니다
검색 결과가 없다고 해서 예전 결정을 추측해 채우지 마세요. 기억 검색이 가능한지, 필요한 기록을 읽을 권한이 있는지 확인한 뒤 승인된 인계 메모와 원본 자료로 돌아갑니다. 문서를 읽을 수 없다면 빠진 자료와 필요한 접근 권한을 명시하게 하고, 그 자료에 의존하지 않는 작업만 이어갑니다.
이전 기록은 “비용도 비교”라고 하는데 새 요청은 비용을 제외한다면 충돌을 드러내야 합니다. 어느 지시가 현재 유효한지 확인하고 변경 날짜와 근거를 남깁니다. 권한이나 승인 여부까지 기억에서 추정하지 않습니다.
도구 실패로 저장 여부가 불명확하면 성공으로 보고하지 않습니다. 가능한 경우 안전한 읽기 확인으로 실제 상태부터 파악하고, 중복 기록이나 의도하지 않은 삭제가 생길 수 있는 변경을 무작정 반복하지 않습니다. 삭제가 필요할 때도 대상과 범위를 먼저 확인하고 실제 결과를 검토합니다. 보존 요청에 날짜를 적는 것만으로 자동 삭제 예약이 만들어지는 것은 아닙니다.
짧은 지침과 명시적인 한계가 더 좋은 출발점입니다
Guide는 작업 공간 문서를 한 파일에 한 책임으로 나누고 짧고 검증 가능한 문장으로 쓰도록 권합니다. 역할·말투와 반복 업무 규칙, 도구 사용 메모를 구분하고 긴 세부 근거는 별도 문서로 연결하세요. 핵심을 앞에 두는 것은 작성 원칙이지, 특정 문장이 반드시 주입되거나 모든 제약이 자동 강제된다는 보장은 아닙니다.
다음 경계도 유지합니다.
- 일반 Memory와 작업 문서에 비밀번호·토큰·API 키나 불필요한 고객 원문을 넣지 않습니다. 비밀값은 조직이 승인한 전용 경로로 다룹니다.
- 기록이 관리되는 작업 공간에 있다는 사실만으로 보존 기간·완전 삭제·개인정보 보호 수준을 단정하지 않습니다. 해당 조직의 정책을 확인합니다.
- 런타임 문서에 기능이 있다는 이유로 Cloud Portal이나 Agent Control UI에 특정 메뉴가 있다고 안내하지 않습니다. 이 글은 현재 UI를 직접 검증한 설정 절차가 아닙니다.
- 기억, 요약, 작업 기록은 도구 권한이나 외부 변경 승인을 대신하지 않습니다.
다음 긴 작업 하나에서 목표·현재 결정·근거 위치·미완료 항목·다음 행동을 담은 인계 메모를 요청하세요. 이어서 작업할 때 그 메모를 다시 읽고 원본과 대조하는 것까지가 한 번의 인계입니다.
Sources
- ClawPod Guide — Memory와 Agent 설정: 기억 도구의 조건, 긴 시작 지침의 제한, 새 세션·reset의 일별 기록 가능성.
- ClawPod Guide — MEMORY.md와 memory 폴더: 장기 기록과 상세 기록, 읽기·쓰기 확인, 저장하면 안 되는 내용.
- ClawPod Guide — Agent 설정 파일 안내: 파일별 책임, 짧고 검증 가능한 지침, 자동 실행과 권한의 경계.
- ClawPod Guide — Tasks와 Milestone: 공유 작업 현황과 완료 전 결과 확인.
- ClawPod Guide — 채팅 모드: Tasks·Workboard의 역할과 실행·검토·권한의 한계.
