Compact 전에 Checkpoint

Checkpoint는 상태를 글로 붙잡는 거야

compaction은 context를 줄여. checkpoint는 줄이기 전에 운영 진실을 붙잡아두고. 지금 목표가 뭔지, 어떤 파일을 건드렸는지, 무슨 결정을 내렸는지, 어떤 test를 돌렸는지, 뭐가 막고 있는지, 다음에 뭘 할지, 권한 경계가 어디까지인지를 다 적어. 찍는 시점은 context가 차기 전, 일이 바뀌기 전, 위험한 수정을 하기 전, 다른 모형한테 넘기기 전이고.

확인되는 게 두루뭉술한 걸 이겨

좋은 checkpoint에는 정확한 경로, commit hash, 명령 결과, 상태가 들어가. 두루뭉술한 checkpoint는 자기가 쓸모 있는 줄 아는 일기일 뿐이고. 판정법은 하나야. 갓 시작한 instance가 이 checkpoint랑 지금 소스만 읽고 일을 이어갈 수 있나? 못 하면 그 checkpoint는 덜 된 거야.

Checkpoint는 쌓이는 거지 갈아 끼우는 게 아니야

새 checkpoint가 옛 걸 지우지 않아. 같이 모여서 발자취가 되지. 제일 최근 게 운영 진실이고, 옛 것들은 프로젝트가 어떻게 여기까지 왔는지 보여주는 참고 자료야.

Code

Checkpoint 서식·markdown

# Checkpoint @ <timestamp>
- Goal:
- Current truth:
- Files changed (paths + last commit):
- Commands run + outcomes:
- Tests passed/failed:
- Decisions made:
- Authority boundaries (do-not list):
- Next action:
- Push/deploy status:
- Open questions:

판정법·text

Read only the checkpoint and the current source files.
Could you, as a fresh instance:
  - know what the goal is?
  - know what is already done?
  - know what to do next?
  - know what NOT to do?
If any answer is no, the checkpoint is incomplete.

Exercise

지금 하는 일이든 가상의 코딩 작업이든 checkpoint를 하나 써봐. 정확한 경로 둘이랑 권한 경계 하나를 꼭 넣고. 그다음 판정법을 대봐 — 갓 시작한 instance가 이것만 보고 이어갈 수 있어?

Hint

새 instance가 그것만으로 못 이어가면 아직 checkpoint가 아니야.