#개발환경

MCP 3종을 전역에서 뺐더니 메모리가 10GB 줄었다

세션마다 하나씩 뜨는 줄 몰랐다

한 줄로 맥미니 메모리가 32GB 중 25.5GB 차 있었다. 범인은 무거운 앱이 아니라 세션마다 하나씩 뜨는 MCP 서버였다. 세션 21개 × MCP 3종. 전역 등록에서 셋을 빼고 서버를 재시작하니 node+claude 가 15.4GB 에서 5.7GB 로 떨어졌다. 그중 MCP...

문서에 없는 API 를 바이너리에서 꺼냈다

Herdr 소켓 API 로 플러그인 만들기

한 줄로 Herdr 공식 문서의 API 페이지는 엔드포인트를 하나도 적어두지 않았다. server · client · update 세 개와 “CLI 와 소켓 API 는 같은 표면”이라는 한 문장이 전부다. 그런데 herdr api schema --json 을 치면 275KB 가 쏟...

폰에서 에이전트를 조종했다

Collie 로 승인 대기를 풀어낸 3일

한 줄로 에이전트를 오래 돌려보면 일하는 시간보다 승인을 기다리는 시간이 길다. 자리를 비우면 그 대기가 전부 멈춤이 된다. Collie 는 그 판에 폰을 붙인다. 밖에서 승인 번호를 누르고, 답을 보내고, /compact 를 친다. 3일 동안 폰에서 문장을 21번 보내고 키를 1...

Herdr 는 에이전트의 옆자리를 알아본다

코딩 에이전트를 위한 터미널 멀티플렉서

한 줄로 터미널 판(pane) 안에 무엇이 돌고 있는지를 아는 멀티플렉서다. tmux 는 판을 나눠주고 끝난다. 그 안에서 도는 게 셸인지 에이전트인지, 답을 기다리는 중인지 일하는 중인지는 모른다. Herdr 는 그걸 안다. 그래서 에이전트가 다른 에이전트를 부릴 수 있다. 이 ...

내 설정이 4개월 만에 3계층이 됐다

에이전틱 워크플로우를 어떻게 설계했나

에이전틱 워크플로우가 뭔가 AI 에게 매번 지시를 다시 쓰는 대신, 판단 기준과 절차를 미리 파일로 적어두고 그 위에서 일을 시키는 것이다. 대화가 끝나도 파일은 남으므로, 다음 대화는 같은 기준에서 시작한다. “프롬프트를 잘 쓴다”와는 다르다. 프롬프트는 이번 한 번이고, 워크플...

내가 쓴 규칙을 소스로 검증했더니 근거가 틀려 있었다

규칙도 썩는다 앞의 두 글에서 규칙을 어떻게 나누고 어떻게 쌓았는지 썼다. 이번엔 반대다. 쌓아둔 규칙을 다시 읽어보니 틀린 것들이 있었다. 틀린 방식이 세 가지였다. 동작은 맞는데 이유가 틀린 것, 가리키던 대상이 사라진 것, 그리고 숫자를 재본 적이 없는 것. 셋 다 에러가 나...

LSP 는 코드를 글자가 아니라 뜻으로 읽는다

에이전트에게 무엇을 주는가

한 줄로 코드를 문자열이 아니라 문법으로 이해하는 도구다. grep 은 비슷한 글자를 찾고, LSP 는 같은 것을 찾는다. 이 차이가 전부다. 문제 — save 를 찾아줘 같은 코드에서 save 를 검색한다고 하자. user.save() // ← 진짜 그 함수 // 나중에 save...

훅은 언제 막고 언제 못 막나

하나는 막았고 하나는 0건이었다

훅을 두 번 만들었고 결과가 갈렸다 Claude Code 의 훅(hook)은 특정 시점에 끼어드는 스크립트다. 도구를 부르기 직전, 파일을 저장한 뒤, 세션이 끝날 때 같은 지점에서 돈다. 프롬프트에 적은 규칙과 달리 모델의 협조가 필요 없다 — 코드가 판정하고 코드가 막는다. 그...

스킬 24개를 왜 만들었나

직접 만든 16개와 가져온 3개

스킬이 뭔가 특정 상황에서만 읽히는 지침 문서다. CLAUDE.md 와 달리 매 대화에 실리지 않고, 필요할 때만 로드된다. 그래서 평소 비용 없이 상세한 내용을 담을 수 있다. ~/.claude/skills/ 아래 폴더 하나가 스킬 하나이고, 안에 SKILL.md 를 둔다. 지금...

Superpowers 는 코드를 쓰기 전에 멈추게 만든다

플러그인이 강제하는 절차

한 줄로 AI 에게 “바로 코딩하지 말고 이 절차를 밟아라” 를 강제하는 플러그인이다. 기능을 더해주는 게 아니라 일하는 순서를 바꾼다. 그래서 설치해도 새 명령어가 늘지 않고, 대신 Claude 가 작업에 들어가는 방식이 달라진다. 만든 사람은 Jesse Vincent(obra)...

OMC 는 에이전트 19개를 부린다

oh-my-claudecode 오케스트레이션 층

한 줄로 하나의 요청을 여러 에이전트에게 나눠 실행시키는 플러그인이다. oh-my-claudecode, 줄여서 OMC. MIT 라이선스이고 Yeachan-Heo/oh-my-claudecode 에서 받는다. Superpowers 가 절차를 세운다면 OMC 는 인력을 나눈다. 층이 달...

MCP 12개, 도구 251개

무엇을 왜 붙였나

MCP 가 뭔가 Model Context Protocol. AI 가 외부 서비스를 도구로 쓰게 해주는 규약이다. 붙이면 Claude 가 Jira 티켓을 만들고, Slack 을 읽고, 브라우저를 조작할 수 있게 된다. 개념 설명은 따로 쓴 글에 있고, 여기서는 내가 실제로 무엇을 붙...

CLAUDE.md 에 무엇을 썼나

4개월간 쌓인 규칙 14개

CLAUDE.md 가 뭔가 Claude Code 가 매 대화에 자동으로 실어 보내는 규칙 파일이다. 여기 적어두면 매번 말하지 않아도 지켜진다. 전역(~/.claude/CLAUDE.md) 하나가 있고, 프로젝트마다 따로 둘 수도 있다. 계층 구조는 다른 글에서 다뤘고, 여기서는 전...

팀 설정 파일을 내 것처럼 고칠 수 없다

skip-worktree 로 흡수하기

왜 git 에 넣나 맥 4대(회사 2 · 개인 2)를 오간다. 한쪽에서 고친 규칙이 다른 쪽에 없으면 같은 지시를 두 번 해야 한다. 그래서 저장소 하나를 진실 공급원으로 두고 각 머신이 심링크(원본을 가리키는 바로가기 파일)로 그 파일을 본다. ~/.claude/CLAUDE.md...

Aside 는 로그인한 채로 브라우저를 조종한다

로그인 상태를 물려받는 AI 브라우저

한 줄로 로그인 세션을 그대로 물고 있는 브라우저를 AI 가 조종하게 해주는 도구다. 일반 브라우저 자동화는 빈 브라우저에서 시작한다. 그래서 사내 관리자 화면 하나 열려면 로그인부터 해야 한다. Aside 는 내가 이미 로그인해둔 브라우저 자체를 조종한다. 인증 단계가 사라진다....

스킬 16개를 만들었더니 명령어 모음이 판단 문서가 됐다

셸 래퍼로 시작해 판단 기준을 적게 됐다

첫 스킬은 16줄짜리 셸 래퍼였다 Claude Code 의 스킬(skill)은 특정 상황에서만 읽히는 지침 문서다. 규칙 파일과 달리 매 대화에 실리지 않고, 필요할 때만 로드된다. 계층과 로드 비용 이야기는 1편에 썼다. 지금 24개가 있고 그중 16개를 직접 만들었다. 가장 오...

Claude Code 설정을 맥 4대에 나눠 담았다

계층, 플러그인, 그리고 상시 로드 비용

시작은 규칙 파일 하나였다 Claude Code 는 CLAUDE.md 라는 파일에 적어둔 규칙을 매 대화에 실어 보낸다. “테이블 행은 | 로 시작하고 끝낸다” 같은 걸 적어두면 매번 말하지 않아도 지켜진다. 처음엔 이 파일 하나였다. 지금은 이렇게 나뉘어 있다. 계층 줄 수 적용...