원문: DietrichGebert/ponytail · 수집일: 2026-10-03 · 커밋
c982cd4· 릴리스 v4.10.3 · Stars 약 15만 · MIT · 홈페이지 ponytail.dev
개요
ponytail은 AI 코딩 에이전트가 필요한 만큼만 코드를 쓰도록 만드는 스킬 겸 플러그인이다. 콘셉트는 “말없이 50줄을 한 줄로 바꾸는 꽁지머리 시니어 개발자”다. 대표 예시는 날짜 선택기다. 에이전트는 보통 flatpickr를 설치하고 래퍼 컴포넌트와 스타일시트를 만든다. ponytail을 켜면 <input type="date"> 한 줄로 끝낸다.
규칙의 목표는 “토큰 최소화”가 아니다. 과제에 필요한 것만 쓰되 검증·오류 처리·보안·접근성은 절대 줄이지 않는다. 코드가 작아지는 건 필요한 것만 남겼기 때문이지 코드 골프를 해서가 아니다.
사다리: 코드를 쓰기 전에 멈추는 7단계
에이전트는 아래 단계 중 처음으로 성립하는 곳에서 멈춘다.
- 이게 꼭 있어야 하나? 추측성 필요라면 건너뛰고 한 줄로 알린다(YAGNI).
- 이미 코드베이스에 있나? 있는 헬퍼·유틸·타입을 재사용한다. 몇 파일 옆에 있는 걸 다시 만드는 게 가장 흔한 군더더기다.
- 표준 라이브러리로 되나?
- 플랫폼 기본 기능으로 되나? 피커 라이브러리 대신
<input type="date">, JS 대신 CSS, 앱 코드 대신 DB 제약. - 이미 설치된 의존성으로 되나? 몇 줄이면 될 일에 새 의존성을 추가하지 않는다.
- 한 줄로 되나?
- 그다음에야 동작하는 최소 코드.
사다리는 문제를 이해한 뒤에 돈다. 변경이 닿는 코드를 읽고 실제 흐름을 끝까지 추적한 다음 단계를 고른다. “해법에는 게으르되 읽기에는 게으르지 않다”는 것이 핵심 단서다. 버그 수정도 같은 원리다. 보고된 증상 경로만 고치지 말고, 고칠 함수의 호출자를 모두 찾아 공유 함수에 가드 하나를 넣는다. 그쪽이 diff도 더 작다.
규칙과 출력 형식
- 구현이 하나뿐인 인터페이스, 제품이 하나뿐인 팩토리, 바뀌지 않는 값의 설정을 만들지 않는다.
- “나중을 위한” 스캐폴딩 금지. 추가보다 삭제, 영리함보다 지루함.
- 알려진 한계가 있는 단순화(전역 락, O(n²) 스캔)는
ponytail:주석으로 한계와 업그레이드 경로를 남긴다./ponytail-debt가 이 주석을 모아 부채 장부를 만든다. - 출력은 코드 먼저, 그다음 최대 세 줄. 패턴은
[코드] → skipped: [X], add when [Y]. 사용자가 요청한 설명은 예외다. - 분기·루프·파서·돈·보안 경로 같은 비자명한 로직에는 실행 가능한 검사 하나(
assert기반 self-check나 작은test_*.py)를 남긴다.
강도는 세 단계다. “API 응답 캐시 추가” 요청을 예로 들면 다음과 같다.
| 레벨 | 동작 |
|---|---|
| lite | 요청대로 만들고 더 게으른 대안을 한 줄로 알린다(“lru_cache 한 줄로도 됩니다”) |
| full (기본) | 사다리를 강제한다. @lru_cache(maxsize=1000)만 붙이고 커스텀 캐시 클래스는 건너뛴다 |
| ultra | 프로파일러가 말하기 전엔 캐시를 만들지 않는다. 요구 자체에 이의를 제기한다 |
벤치마크: 비판을 받고 다시 잰 수치
처음 공개한 단일 응답 벤치마크는 코드 80~94% 감소를 주장했다. Colin Eberhardt가 이슈 126에서 이를 반박했다. 기준선이 산문과 선택지를 늘어놓는 채팅 모델이라 줄 수가 부풀려졌고, “한 줄 선호”는 안전 가드를 깎을 수 있으며, 짧은 프롬프트 한 줄로도 같은 효과가 날 수 있다는 지적이었다. 저자는 이를 인정하고 벤치마크를 새로 만들었다.
새 벤치마크는 헤드리스 Claude Code(Haiku 4.5)가 실제 저장소(full-stack-fastapi-template)에서 기능 티켓 12개를 처리하게 하고, 남긴 git diff 추가 줄 수를 쟀다. 조건당 4회 실행이다. 비교 대상은 스킬 없는 기준선, 산문만 짧게 하는 Caveman, 그리고 “YAGNI를 따르고 한 줄 해법을 선호하라”는 7단어 프롬프트다.
| 기준선 대비 | 코드 줄 | 토큰 | 비용 | 시간 | 안전 |
|---|---|---|---|---|---|
| ponytail | -54% | -22% | -20% | -27% | 100% |
| caveman | -20% | +7% | +3% | +2% | 100% |
| YAGNI + 한 줄 프롬프트 | -33% | -14% | -21% | -30% | 95% |
읽을 때 주의할 점은 다음과 같다.
- -54%는 과제 평균이다. 네이티브 입력으로 대체되는 과제에서 차이가 컸다. 날짜 선택기는 404줄에서 23줄(-94%), 색상 선택기는 287줄에서 23줄로 줄었다. 백엔드 CRUD처럼 원래 최소인 코드는 거의 차이가 없다.
- 안전성은 하한선 확인 수준이다. 경로 탐색·SQL 인젝션·위조 토큰 같은 적대 입력으로 실제 함수를 실행해 봤다. 7단어 프롬프트만 20회 중 1회 경로 탐색 검사를 빼먹었다. ponytail은 그 검사 3줄을 남겨 4/4 안전했다. 다만 과제 6개, 결정적 검사라 보안을 증명하지는 않는다.
- 모델 하나(Haiku 4.5), n=4. 큰 모델에서는 격차가 줄거나 커질 수 있다. 저자는 GPT-5.5처럼 사고 토큰을 많이 쓰는 모델에선 단계를 고민하느라 오히려 비용이 늘 수 있다고 적었다.
- 처음 측정에서 플러그인의
SessionStart훅이 기준선에도 걸려 오염된 사실을 발견해 고쳤다고 밝혔다(--setting-sources project,local+ 조건별--plugin-dir).
설치와 명령
Claude Code에서는 /plugin marketplace add DietrichGebert/ponytail, /plugin install ponytail@ponytail을 두 번에 나눠 보낸다. Codex, Copilot CLI, Gemini CLI, OpenCode, Cursor(훅 설치), Hermes Agent, Devin CLI 등 20개 에이전트를 지원한다. 플러그인이 없는 환경에서는 AGENTS.md나 각 도구의 규칙 파일을 복사해 지시문만 쓸 수 있다. Claude Code·Codex 플러그인은 Node.js 생명주기 훅 2개를 돌리므로 node가 비대화형 셸 PATH에 있어야 한다.
| 명령 | 역할 |
|---|---|
/ponytail [lite|full|ultra|off] | 강도 설정·해제 |
/ponytail-review | 현재 diff의 과잉 설계를 찾아 삭제 목록을 준다 |
/ponytail-audit | 저장소 전체 과잉 설계 감사 |
/ponytail-debt | ponytail: 주석으로 미룬 단순화를 장부로 모은다 |
/ponytail-gain | 벤치마크 영향 점수판 |
기본 레벨은 PONYTAIL_DEFAULT_MODE 환경 변수나 ~/.config/ponytail/config.json으로 정한다. 활성 상태에서는 Agent 도구로 띄운 서브에이전트에도 규칙이 주입되며, PONYTAIL_SUBAGENT_MATCHER 정규식으로 범위를 좁힐 수 있다. 제거할 때는 플러그인을 지우기 전에 node scripts/uninstall.js로 모드 플래그·설정·statusLine 항목을 정리해야 한다.
Caveman과의 관계
둘은 겹치지 않는다. Caveman은 에이전트가 말하는 것을 줄이고 코드는 그대로 둔다. ponytail은 만드는 것을 줄이고 산문에는 관여하지 않는다. 저자는 함께 쓰기를 권한다. 벤치마크에서도 caveman은 코드를 20% 줄였지만 토큰은 오히려 7% 늘었다. 말만 짧아지고 고민의 양은 같았기 때문이다.
관련 노트
- 2026-04-07-addyosmani-agent-skills — 에이전트 스킬 묶음의 다른 예
- moc-claude-code — Claude Code 허브