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

서브에이전트를 만들고 나면 팀원과 공유하고 싶어진다. 가장 직관적인 방법이 GitHub다. Git을 이미 쓰고 있고, 버전 관리가 되고, URL 하나로 설치할 수 있다. 이 글은 서브에이전트를 GitHub로 배포하는 두 시나리오를 설명한다 — 프로젝트에 포함시켜 자동 공유하는 방법과, 별도 저장소로 플러그인을 배포하는 방법.두 시나리오 선택 기준세 질문을 순서대로 던진다. MCP 도구가 필요한가? 여러 저장소·팀에 배포해야 하는가? 버전 고정이 필요한가? 어느 하나라도 "예"라면 시나리오 2(별도 저장소 플러그인)로 간다. 세 질문 모두 "아니오"라면 시나리오 1(프로젝트에 포함)로 충분하다. MCP가 첫 분기 기준인 이유는 뒤에서 다시 보충하지만, 짧게 말하면 시나리오 1로도 MCP를 동봉할 수는 있어..

코드를 짜다가 PR을 확인해야 할 때마다 브라우저로 넘어가는 흐름이 끊기는 느낌이 있다. GitHub 탭을 열고, 필터를 걸고, 코멘트를 달고, 다시 에디터로 돌아오는 과정이다. GitHub MCP 플러그인을 설치하면 이 흐름이 사라진다. Claude Code 대화창 안에서 "내가 리뷰어로 지정된 PR 목록 보여줘"라고 하면 즉시 목록이 나오고, "이 PR에 LGTM 코멘트 달아줘"라고 하면 GitHub에 바로 반영된다.이 플러그인이 흥미로운 이유는 HTTP 방식의 MCP 서버라는 점이다. 앞서 설명한 서브에이전트의 3가지 핵심 구성요소 중 플러그인이 제공하는 것은 도구 목록(②)만이다. 시스템 프롬프트(①)와 트리거(③)는 사용자가 별도로 정의한다. GitHub API와 통신하는 MCP 서버가 GitH..

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

이슈가 쌓이면 마음도 무거워진다오픈소스 프로젝트를 운영하다 보면, GitHub 이슈는 끊임없이 올라온다. 버그 리포트, 기능 요청, 환경 문의, 때로는 이미 해결된 문제에 대한 중복 질문까지. 하루에 몇 개씩 쌓이는 이슈를 정기적으로 확인하고, 하나하나 브라우저에서 열어 영어로 정중한 답변을 작성하고, 담당자를 할당하고, 닫는 일련의 작업은 생각보다 시간을 잡아먹는다.문제는 이 작업이 어렵지는 않지만 번거롭다는 점이다. 답변의 패턴은 비슷하고, 판단은 금방 내려지는데, 실제 실행(GitHub 웹 열기 → 이슈 읽기 → 코멘트 작성 → 닫기/할당)에 드는 시간이 비효율적으로 길다. 특히 이동 중이거나 다른 작업에 집중하고 있을 때, 이슈 처리를 위해 맥락 전환을 하는 게 은근히 부담스럽다.텔레그램이라는 선..

PR 리뷰를 왜 놓치게 되는가오픈소스 프로젝트의 메인테이너 역할을 맡고 있으면, PR(Pull Request) 리뷰는 중요하지만 긴급하지 않은 업무에 속하기 쉽다. 본업이 따로 있으니 GitHub 알림은 메일함 저 너머로 밀려나고, 일주일쯤 지나서야 "아, 리뷰 요청이 와 있었네" 하게 된다.문제는 이게 단순한 지연이 아니라는 점이다.기여자 이탈: 리뷰가 늦어지면 기여자가 흥미를 잃고 PR을 포기한다컨텍스트 유실: 며칠 지난 PR을 열면 "이게 뭐였지?" 하며 다시 파악해야 한다리뷰 부채 누적: 미뤄둔 PR이 쌓이면 한꺼번에 처리해야 하는 압박이 생긴다GitHub 자체 알림이나 이메일 노티도 있지만, 수십 개의 리포에서 쏟아지는 알림 속에서 내가 리뷰해야 하는 PR만 골라서 판단하기는 쉽지 않다. 결국 ..

Claude Code가 PR을 만든다? 어떻게?AI 코딩 도구를 쓰다 보면 이런 장면을 만납니다. "이 기능 추가하고 PR 올려줘"라고 했더니, Claude Code가 코드를 수정하고, 커밋하고, 새 브랜치에 푸시하고, Pull Request까지 만들어버립니다.Claude Code 자체에 "PR 생성" 버튼이 있는 걸까요? 아닙니다. 비밀은 훨씬 단순합니다. Claude Code는 터미널 명령어를 실행할 수 있고, 거기에 GitHub CLI(gh)와 GitHub REST API라는 도구가 있습니다.이 글에서는 그 구조를 처음부터 풀어봅니다.GitHub API가 먼저다 - 모든 것의 기반GitHub는 웹사이트만 제공하는 서비스가 아닙니다. REST API를 통해 GitHub의 거의 모든 기능을 프로그램으로..