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

프롤로그 — 한 줄 명령으로 끝난 설치/plugin install context7. /reload-plugins. 끝. 메시지 두 줄로 새 MCP 서버가 내 Claude Code에 붙었다. 라이브러리 공식 문서를 실시간으로 가져오는 그 유명한 MCP다.그런데 깔고 나서 든 의문은 하나였다. 그래서, 이걸 정말 잘 쓰려면 뭘 더 해야 하지? 설치 자체는 너무 쉬웠다. 너무 쉬워서 오히려 의심스러웠다.context7 MCP가 뭐였더라 (1분 복습)혹시 이 글을 처음 보는 사람을 위해 짧게 정리하면 — context7은 React, Next.js, Prisma, Django 같은 라이브러리·프레임워크의 공식 문서를 LLM에게 실시간으로 주입해주는 MCP 서버다. LLM의 학습 데이터는 어쩔 수 없이 시간이 멈..

프롤로그 — 플러그인 하나 깔고 나서 시작된 질문들어느 날 Claude Code의 /plugin 마켓플레이스에서 "github" 플러그인을 설치했다. 설명 한 줄: "Official GitHub MCP server for repository management." 설치는 10초 만에 끝났다.그런데 /reload-plugins를 실행하고 나서야 머리가 복잡해지기 시작했다.이건 로컬 MCP 서버인가? 아니면 원격에서 도는 건가?이미 gh CLI가 잘 돌고 있는데, 이걸 굳이 쓸 이유가 뭔가?Claude가 MCP를 호출할 때 프롬프트가 통째로 GitHub 쪽으로 넘어가는 건 아닌가?내 프로젝트·스킬 중에 실제로 "이걸로 바꿔서 더 좋아질 만한 것"이 있나?며칠에 걸쳐 이 질문들을 하나씩 풀고, 실제로 환경을 ..

프롤로그 — 매일 여는 도구가 "적당히" 깔끔했다나는 로컬 AI 서버에 개인 홈 포털을 하나 띄워두고 산다. GPU 상태를 확인하고, 로컬 LLM 챗봇을 열고, 지식 금고 검색으로 들어가는 진입점이다. 매일 몇 번씩 연다.그런데 어느 순간 이 포털을 열 때마다 묘한 기분이 들었다. 뭔가 나쁘지 않은데, 아무 느낌도 없다. 검정 배경, 시스템 기본 폰트, 비슷비슷한 둥근 카드가 대칭 그리드로 깔려 있는 화면. "SaaS 관리자 페이지 템플릿 한 장"이라고 해도 믿을 만한 모습. 기능은 다 되는데, 누구의 도구라는 느낌이 없었다.이 느낌에 이름이 붙은 걸 최근에 알았다. "AI slop" — AI가 대충 만든 것 같은, 어디서 본 것 같은, 개성 없는 UI. 그 이름을 명시적으로 적어놓고, 그걸 만들지 말라..

프롤로그 — 스킬이 너무 많아졌다SKILL.md 파일 하나로 "이런 요청이 오면 이렇게 하라"는 절차를 캡슐화해두면, 에이전트가 그 파일을 자동으로 골라 읽고 따라간다. 그 구조를 처음 이해했을 때는 내 워크플로우를 내가 직접 스킬로 짜는 게 재밌다고 생각했다.그러다 어느 순간부터 분위기가 바뀌었다. 직접 짜기 전에 먼저 드는 생각이 "누가 이미 만들어놓지 않았을까"가 되어버렸다. PR 리뷰, 체인지로그 작성, React 성능 최적화, Terraform 템플릿 — 내가 필요하다고 느낀 건 남들도 똑같이 느꼈을 가능성이 높고, 실제로 그런 스킬들이 GitHub 여기저기에 이미 올라와 있다.문제는 그걸 어디서 어떻게 찾는가였다. 레포 스타 검색, 구글 검색, X 타임라인 스크롤 — 다 비효율적이었다. 그래서..

프롤로그 — 30개 가까이 쌓인 스킬들개인 개발 환경에 Agent Skill을 도입한 지 몇 달 됐다. 사진 보정, 지식 금고 정리, 일기 추출, 포토북 생성, 음성 전사, GPU 스케줄링... 하나씩 만들다 보니 어느새 ~/.claude/skills/ 아래 30개에 가까운 폴더가 생겼다. 각각 수십~수백 줄의 SKILL.md를 담고 있고, 대부분은 내가 직접 타이핑했다기보다 Claude Code와의 협업으로 작성된 것들이다.어느 날 Anthropic이 skill-creator를 공개했다. 스킬을 만들어주고, 개선하고, 테스트까지 돌려주는 메타 스킬이다. 궁금해졌다. 내가 쓴 스킬을 얘가 다시 쓰면 어떻게 될까? 단순한 호기심이 아니었다. 30개를 직접 유지보수하는 일이 점점 버겁게 느껴지고 있었고, A..

ruff 바로 뒤이어서 — 같은 날 shellcheck까지오전에 Python 프로젝트 10개에 ruff를 넣으면서 한 줄을 이렇게 남겨뒀다. "shellcheck는 다음 주기에 다루기로 했다 — 한 번에 한 도구씩 확실히 안착시키자." 그렇게 ruff 쪽 정리가 끝나고 나니, 그 "다음 주기"를 굳이 다른 날로 미룰 이유가 없어졌다. 손이 뜨거워진 김에 같은 날 그대로 shellcheck로 넘어갔다.대상은 개인 프로젝트 4곳에 흩어져 있는 bash 스크립트 17개. cron용 엔트리포인트, GPU 자원 관리 도구, 백그라운드 서비스 재시작 스크립트 — 전부 손으로 짠 글루 코드다. Python 쪽은 테스트·ruff로 촘촘히 덮었지만, bash는 "잘 돌아가길래 그냥 둔" 상태였다. 그 "잘 돌아간다"가 ..

시리즈 맥락 복기Step 5에서 루프가 자율적으로 시작되고 끝날 수 있게 됐습니다. 자율성이 높아질수록 "사람이 개입할 지점"을 잘 정해야 합니다. 너무 많이 개입하면 자동화의 의미가 없고, 너무 적게 개입하면 사고가 납니다. Step 6의 HITL(Human-in-the-Loop) 정책이 바로 이 균형을 설계하는 단계입니다.#0 ~ #5 (이전 단계)#6 HITL 정책 ← 이번 편#7 감사 로그#8 측정 + 회고이 단계의 의미 — HITL은 하네스의 '브레이크 강도' 설정Step 4의 Hook이 "비상 브레이크"였다면, Step 6의 HITL은 "브레이크 강도 조절"입니다. 어떤 명령은 묻지 않고 지나가고, 어떤 명령은 확인 후 지나가고, 어떤 명령은 아예 막습니다. 이 등급 체계를 코드로 구현한 것이..

시리즈 맥락 복기Step 3까지 우리는 "에이전트에게 무엇을 시킬 것인가"를 정의했습니다. 하지만 시킨 일을 잘못 실행하는 것을 막을 장치가 없으면, Skill이 늘어날수록 사고 위험도 함께 커집니다. Step 4의 Hook은 바로 이 방어선입니다.#0 업무 프로세스 매핑#1 프로젝트 규칙 설정#2 Code Wiki 작성#3 Skill 정의#4 검증 (Hook) ← 이번 편#5 자동 트리거 + 완료 조건... (#8까지)이 단계의 의미 — Hook은 하네스의 안전벨트다Hook은 에이전트가 도구를 실행하기 직전과 직후에 끼어드는 코드입니다. 말에 비유하면 안전벨트 혹은 브레이크에 가깝습니다. 사람이 "출발!"을 외쳐도, Hook이 "길이 막혔다"고 판단하면 실행을 차단합니다. 반대로 실행 후에는 상태를 업..