한눈에
Simon Willison은 요즘 자기 프로젝트 변경 대부분을 Claude Code나 Codex가 연 PR로 처리한다.
에이전트는 PR 설명을 잘 쓴다. 문제, 해결책, 검증 과정까지 빠짐없이 적는다. 그런데 너무 잘 써서 읽기 싫어진다고 한다.
그가 쓰는 방법
GitHub 마크다운은 HTML의 details·summary 태그를 지원한다. 이 안에 넣은 글은 접힌 채 제목만 보인다.
PR 맨 위에는 사람이 고른 짧은 소개 한 단락을 둔다. 필요하면 스크린샷도 붙인다.
에이전트가 쓴 긴 설명은 그 아래 접힌 칸에 넣는다. 접힌 제목에는 “Claude Opus 5.5 Medium”처럼 모델과 effort를 적는다.
소개를 꼭 직접 쓰지는 않는다. 다만 그 첫 단락은 읽을 가치가 있다는 사람의 판단이라는 약속이다.
왜 중요한가
정보는 그대로 두면서 읽는 사람의 부담을 줄인다. AI가 만든 결과물을 팀과 나눌 때 바로 따라 할 수 있는 습관이다.