전체 내역

[Claude Code 플러그인] ponytail, 필요 없는 코드는 짜지 않게 하기

에이전트가 요청보다 많이 만들어 오는 일을 줄여 주는 플러그인입니다. 일곱 단계 사다리, 강도 세 가지, 줄이면 안 되는 예외까지 스킬 원문을 읽으며 정리하고, 이 블로그 작업에서 무엇이 줄었는지 적었습니다.

에이전트에게 기능을 맡기면 가끔 요청보다 훨씬 많이 만들어 옵니다. 새 추상화, 새 라이브러리, 쓰지도 않는 설정까지요. 날짜 하나를 고르는 입력칸을 요청했는데 날짜 선택 라이브러리가 설치되어 있는 식입니다. 동작하는 것은 맞는데, 나중에 읽고 고쳐야 할 코드가 불어났다는 점이 문제입니다.

이 글에서는 이런 과잉을 줄여 주는 ponytail 플러그인을 다룹니다. 설치된 스킬 원문을 읽으며 어떤 순서로 따져 보게 하는지, 강도를 어떻게 바꾸는지, 어디까지는 줄이지 말라고 하는지를 정리했고, 이 블로그에 도구 섹션을 넣는 작업에서 체감한 차이를 적었습니다. Claude Code로 기능을 자주 붙이는 개발자, 특히 에이전트가 만든 코드가 요청보다 크다고 느낀 분을 염두에 두었습니다.

1. 어떤 플러그인인가

세션이 시작될 때 훅(hook)으로 규칙을 넣어 주는 플러그인입니다. 스킬 설명은 가장 게으르면서 실제로 동작하는 해법, 곧 가장 단순하고 짧고 최소한인 해법을 고르게 한다고 적고 있습니다. 모든 걸 본 시니어 개발자가 새벽 3시에 과잉 설계된 코드 때문에 호출당해 본 적이 있다는 설정으로, "가장 좋은 코드는 쓰지 않은 코드"라는 문장을 내세웁니다.

게으르다는 말은 부주의하다는 뜻이 아닙니다. 원문은 게으름을 효율로 정의하고, 이해하는 일을 건너뛰는 것은 게으름이 아니라 위험한 쪽이라고 따로 못 박습니다. 이 구분이 이 플러그인의 가장 중요한 부분이라고 생각해서 뒤에서 한 번 더 다룹니다.

일곱 단계 사다리

규칙의 중심은 위에서부터 차례로 따져 보는 사다리입니다. 첫 번째로 성립하는 단계에서 멈춥니다.

  1. 이것이 애초에 필요한가. 아직 오지 않은 필요를 위한 것이면 건너뛰고 한 줄로 이유를 말합니다(YAGNI).
  2. 이 저장소에 이미 있는가. 비슷한 함수, 유틸, 타입, 패턴이 있으면 재사용합니다. 몇 파일 옆에 있는 것을 다시 만드는 일이 가장 흔한 낭비라고 합니다.
  3. 표준 라이브러리가 하는가.
  4. 플랫폼의 기본 기능이 하는가. 날짜 선택 라이브러리 대신 <input type="date">, 자바스크립트 대신 CSS, 앱 코드 대신 데이터베이스 제약처럼요.
  5. 이미 설치된 의존성이 해결하는가. 몇 줄로 되는 일에 새 의존성을 들이지 않습니다.
  6. 한 줄로 되는가.
  7. 그제서야 동작하는 최소한의 코드를 씁니다.

사다리는 문제를 이해한 뒤에 오르는 것이지 이해를 대신하지 않습니다. 두 단계가 모두 되면 높은 단계를 고르고 넘어갑니다.

버그 수정도 같은 규칙

버그 수정에도 규칙이 있습니다. 증상이 아니라 원인을 고치라는 것입니다. 고치기 전에 고칠 함수를 부르는 곳을 모두 찾아보라고 합니다. 공용 함수에 가드 하나를 넣는 것이 호출하는 곳마다 가드를 넣는 것보다 작은 수정이고, 티켓이 가리키는 경로만 고치면 같은 함수를 부르는 다른 경로가 여전히 깨진 채로 남기 때문입니다. 게으른 수정이 곧 근본 원인 수정이라는 것이 원문의 입장입니다.

2. 출처

항목 내용
AI 도구 Claude Code (저장소에는 Codex 등 다른 도구용 설정도 들어 있습니다)
종류 플러그인 (스킬과 훅 포함)
만든 사람 Dietrich Gebert
저장소 https://github.com/DietrichGebert/ponytail
설치 경로 DietrichGebert/ponytail 마켓플레이스
확인한 버전 4.9.0 (2026년 10월 7일 설치본 기준)
라이선스 MIT

3. 언제 쓰면 좋은가

기능 추가나 리팩터링 전반에 걸어 두면 됩니다. 글쓰기나 번역 같은 코딩이 아닌 요청에는 쓰지 말라고 스킬 설명에 적혀 있고, 입력 검증, 보안, 접근성처럼 줄이면 안 되는 것은 규칙에서 예외로 따로 적혀 있습니다. 새 의존성을 고르는 순간에도 쓸모가 있습니다. 라이브러리를 들이기 전에 사다리의 3, 4, 5단계를 거치게 되기 때문입니다.

4. 사용법

설치하면 세션마다 자동으로 적용됩니다. 켜져 있는 동안은 응답마다 규칙이 유지되고, 그만두려면 "stop ponytail" 또는 "normal mode"라고 말하면 됩니다. 강도는 /ponytail lite|full|ultra로 바꾸고, 정하지 않으면 기본은 중간 단계인 full입니다.

강도 세 가지

같은 요청에도 강도에 따라 답이 달라집니다. 원문은 "이 API 응답에 캐시를 달아 줘"라는 요청으로 차이를 보여 줍니다.

  • lite: 요청대로 만들되, 더 게으른 대안을 한 줄로 알려 줍니다. 고르는 것은 사용자입니다. "캐시를 달았습니다. 참고로 functools.lru_cache면 한 줄로 되는데 캐시 클래스를 직접 갖고 싶지 않으면 그쪽이 낫습니다" 같은 식입니다.
  • full: 사다리를 강제합니다. @lru_cache(maxsize=1000)를 함수에 달고, 직접 만든 캐시 클래스는 건너뛰었으며 lru_cache가 측정으로 부족할 때 추가하라고 한 줄로 덧붙입니다.
  • ultra: 추가보다 삭제를 앞세웁니다. 프로파일러가 필요하다고 말하기 전까지 캐시를 만들지 않습니다.

출력 규칙: 코드가 먼저, 설명은 세 줄 이하

출력도 정해져 있습니다. 코드를 먼저 쓰고, 그 뒤에 건너뛴 것과 언제 추가할지를 세 줄 이하로 적습니다. 설명이 코드보다 길다면 설명을 지우라고 합니다. 단순화를 변호하는 문단 하나하나가 설명이라는 형태로 되돌아온 복잡도라는 이유입니다. 다만 사용자가 요청한 보고서나 단계별 설명은 부채가 아니므로 그대로 길게 쓰고, 이 규칙은 요청하지 않은 설명에만 적용됩니다.

일부러 단순하게 둔 곳에는 표시를 남깁니다. 천장이 있는 단순화(전역 락, 이중 반복문, 순진한 휴리스틱)는 코드에 ponytail: 주석으로 한계와 업그레이드 경로를 적습니다.

# ponytail: global lock, per-account locks if throughput matters

이 주석들을 한꺼번에 모아 보여 주는 ponytail-debt라는 짝 스킬이 있습니다. 천장을 적어 두었다가 잊어버리는 일을 막으려는 장치입니다.

짝 스킬들

같은 플러그인에 코드 리뷰와 점검을 위한 스킬이 더 들어 있습니다. ponytail-review는 과잉 설계만 찾는 리뷰로, 지울 것을 한 줄씩 위치와 함께 알려 줍니다. 표준 라이브러리가 하는 일을 직접 만든 코드(stdlib:), 플랫폼이 이미 하는 일을 하는 의존성(native:), 구현체가 하나뿐인 추상화(yagni:) 같은 꼬리표가 붙습니다. ponytail-audit는 같은 일을 저장소 전체에 하고, ponytail-gain은 측정된 효과를, ponytail-help는 명령 요약을 보여 줍니다.

5. 적용 예시

요청은 "AI 도구를 소개하는 섹션을 두고 싶다"였습니다. 새로 만들면 글 테이블, 목록, RSS, 동기화 스크립트를 따로 만들어야 하는 규모로 보였습니다. 규칙대로 저장소를 먼저 살펴보니 이미 다 있었습니다.

글 분류는 배열 하나와 DB 제약 하나로 관리되고 있어서 값을 하나 더하는 것만으로 목록 필터, RSS, 동기화가 따라왔습니다. 목록 조회 함수에도 분류 필터가 이미 있었습니다. 결국 새로 만든 것은 마이그레이션 한 개와 페이지 한 개이고, 새 의존성은 없습니다. 저장소를 먼저 확인하는 단계가 없었다면 저는 새 테이블부터 만들었을 겁니다. 사다리의 2단계, 이미 이 저장소에 있는가를 따져 본 덕분입니다.

비슷한 일이 이후 작업에서도 반복됐습니다. LAB 지도 페이지 아래 구현 노트에 코드 블록을 넣을 때입니다. 코드 강조와 복사 버튼을 직접 만들려다가, 글 본문이 이미 같은 기능을 쓰고 있다는 점을 먼저 확인했습니다. 글 본문은 마크다운을 HTML로 바꾸는 함수(renderMarkdown)로 코드를 강조하고, 복사 버튼은 CopyButtons 컴포넌트가 붙입니다. 새로 만든 것은 그 둘을 서버에서 호출해 클라이언트 컴포넌트에 넘기는 얇은 함수 하나였습니다.

export async function highlightSections(sections: LabSection[]): Promise<RenderedSection[]> {
  return Promise.all(sections.map(async (section) => ({
    ...section,
    blocks: await Promise.all(section.blocks.map(async (block): Promise<RenderedBlock> => {
      if (block.type !== "code") return block;
      const lang = block.file.split(".").pop() ?? "text";
      return { ...block, html: await renderMarkdown("```" + lang + "\n" + block.text + "\n```") };
    })),
  })));
}

스타일도 마찬가지였습니다. 글 본문용 .prose-post의 코드 블록 스타일을 그대로 입혔기 때문에 새 CSS는 파일 이름을 보여 주는 한 줄 정도였습니다.

6. 써 본 소감

줄어든 것은 코드량만이 아니었습니다. 나중에 읽어야 할 코드와 고쳐야 할 곳도 같이 줄었습니다. 기능을 자주 붙이는 개인 프로젝트에 잘 맞는다고 느꼈습니다.

한 가지 조심할 점도 있었습니다. 사다리는 코드를 줄이는 장치라서 이해를 건너뛰고 작은 수정부터 내놓으면 오히려 위험하다는 단서가 원문에 따로 있습니다. 읽는 일은 줄이지 말고, 읽은 뒤에 코드를 줄이는 순서가 맞다고 생각합니다. 또 설명을 세 줄 이하로 제한하는 규칙은 응답이 간결해서 좋지만, 선택의 이유를 더 듣고 싶을 때는 따로 요청해야 합니다.

Comments (0)