Claude Code 세션 내용을 기록해 두면 설계 이유와 작업 과정을 나중에 찾을 수 있다(qiita.com)

- 개발자 @qwertyhoge가 Claude Code 작업이 끝날 때 /decision-log 명령으로 부르는 자체 제작 작업 지시 파일(skill)을 소개한다. 기술 선택, 채택하지 않은 대안과 그 이유, AI 제안을 고친 부분, PR 전 셀프 리뷰 여부, 코드 라이선스와 기밀 정보 확인 여부를 골라 월별 기록 파일에 추가한다. - 중요한 선택이 있으면 ADR(Architecture Decision Record, 설계 결정의 배경과 대안을 남기는 문서)도 함께 작성한다. 원문에 따르면 약 1개월 동안 작업 기록 5건과 ADR 10건을 남겼다. - 저자는 AI가 자기 작업을 좋게 해석해 쓰는 경향이 있어 '하지 않은 일은 쓰지 마라'는 지시를 넣었다고 설명한다. Opus 5.5 모델로 몇 차례 시험했을 때 없던 일을 쓴 사례는 보지 못했다고 적었는데, 이는 저자 개인의 관찰이다. - 기록을 보니 저자가 PR 전 셀프 리뷰를 거의 하지 않았다는 점이 드러났다. 이에 리뷰를 강제하는 별도 skill과 훅을 만들어 리뷰를 거치지 않으면 PR을 만들 수 없게 했다고 한다.