아프니까 개발자다 아프니까 개발자다

코드를 읽어 위키를 LLM이 생성하는 시스템을 혼자 굴릴 때는 한 가지 트릭으로 충분했다. "이 위키를 이렇게 써라"라는 운영 규칙을 SKILL.md 한 파일에 모아 두고, 그게 모든 위키 세션의 system prompt에 자동으로 끼워 넣어지게 하는 것이다. AI 에이전트는 매 세션이 새로 시작이라 위키 사용법을 매번 추측하는데, 그 한 파일이 추측을 contract로 대체해 줬다.그런데 이 위키를 나 혼자가 아니라 외부의 수많은 사람에게 배포하기로 하면서 질문이 생겼다. 딥 위키를 나눠 줄 때 그 SKILL.md도 같이 배포해야 하나? 그리고 그것만으로 충분한가? 직관적으로는 "규칙 파일을 같이 주면 남의 에이전트도 똑같이 일관되게 쓰겠지"였다. 하지만 그 직관은 내 기계에서만 성립하던 전제 위에 서..

Claude Code로 복잡한 자동화 파이프라인을 만들면 한 가지 근본적인 문제에 부딪힌다. LLM은 비결정적(non-deterministic)이다. "이 5단계를 순서대로 해줘"라고 SKILL.md에 적어놔도, 실제로는 3단계를 건너뛰거나 4단계를 까먹을 수 있다.이 글에서는 Claude Code의 Hooks 시스템을 활용해 AI 에이전트가 다단계 작업을 빠짐없이 수행하도록 강제하는 패턴을 소개한다.문제: "해줘"라고 했는데 절반만 하는 AI예를 들어 이런 파이프라인이 있다고 하자. 개인 독서 노트를 자동으로 정리하는 시스템이다:Step 1: 독서 앱에서 하이라이트 가져오기Step 2: 관련 기존 노트와 연결Step 3: AI 요약 + 핵심 인사이트 추출Step 4: 품질 검증Step 5: git co..