모바일에서 읽히지 않던 문서 다이어그램을 Mermaid에서 Pele로 바꾼 과정
화면이 좁으면 통째로 줄어들던 문서 속 Mermaid 다이어그램 84개를 Pele로 바꿨습니다. Claude Code로 후보를 검증하고 다크 모드 색상 문제를 CSS로 푼 과정을 375px 캡처와 함께 정리했습니다.
‘에이전트 준비 문서’ 태그가 달린 글
에이전트를 위해 준비한 문서, 코딩 에이전트는 실제로 어떻게 읽었을까
에이전트 준비도를 갖춘 문서를 코딩 에이전트가 실제 연동 작업에서 어떻게 읽었는지 세션 기록으로 확인했습니다. 에이전트는 저희가 만든 마크다운 페이지를 한 번도 직접 요청하지 않았고, 저희가 쓴 스캐너들은 그 원인인 서버 버그를 잡아내지 못했습니다.
에이전트 준비도: 기계가 실제로 활용하는 문서 만들기
기술 문서에는 이제 두 번째 독자가 있습니다. 바로 AI 에이전트입니다. 에이전트 준비도가 무엇인지, 문서가 어디서 무너지는지, 그리고 어떻게 측정하는지 살펴봅니다.