Ponytail은 AI 코딩 에이전트가 필요한 만큼만 구현하게 하는 스킬·플러그인이다. Claude Code, Codex, GitHub Copilot CLI, Gemini CLI, OpenCode 등 20개 에이전트를 지원한다. 새 라이브러리나 추상화를 먼저 만들지 않고 기존 코드, 표준 라이브러리, 브라우저 네이티브 기능을 순서대로 검토해 가장 작은 변경을 고른다. 검증, 오류 처리, 보안, 접근성은 줄이지 않는다는 원칙을 둔다.
핵심 규칙
Ponytail은 에이전트가 문제를 이해하고 관련 코드를 읽은 뒤 다음 사다리의 첫 번째 가능한 선택지에서 멈추도록 지시한다.
- 이 기능이 정말 필요한가? 필요하지 않다면 만들지 않는다.
- 코드베이스에 이미 같은 helper, util, 패턴이 있는가? 있다면 재사용한다.
- 표준 라이브러리가 이미 처리하는가? 그렇다면 표준 기능을 쓴다.
- 브라우저나 플랫폼의 네이티브 기능으로 충분한가? 그렇다면 그것을 쓴다.
- 이미 설치된 의존성이 처리하는가? 새 패키지를 추가하지 않는다.
- 한 줄로 충분한가? 한 줄로 끝낸다.
- 그 외에는 요구 사항을 충족하는 최소 구현을 작성한다.
예를 들어 날짜 선택 UI를 만들 때 새 date picker 라이브러리를 설치하기 전에 <input type="date">로 충분한지 확인한다. 이 규칙은 코드 골프가 아니라 유지보수할 코드의 양을 줄이는 방법이다.
측정 결과
Ponytail은 FastAPI와 React로 구성된 실제 오픈소스 저장소에서 headless Claude Code 세션을 비교했다. Haiku 4.5로 12개 feature task를 각 조건에서 4회 실행하고, 남은 git diff를 기준으로 측정했다.
| no-skill baseline 대비 | LOC | 토큰 | 비용 | 시간 | 안전성 |
|---|---|---|---|---|---|
| Ponytail | -54% | -22% | -20% | -27% | 100% |
| Caveman (간결한 산문 대조군) | -20% | +7% | +3% | +2% | 100% |
YAGNI + one-liners 프롬프트 | -33% | -14% | -21% | -30% | 95% |
절감 폭은 과잉 구현의 여지가 큰 작업에서 가장 크다. 프로젝트는 date picker 작업에서 404줄이 23줄, color picker 작업에서 287줄이 23줄이 된 사례를 제시한다. 반대로 코드가 이미 최소화된 작업에서는 차이가 거의 없다.
이전의 단발성 생성 벤치마크는 80~94% 적은 코드라는 수치를 제시했지만, 프로젝트는 산문이 섞인 baseline 때문에 공정하지 않을 수 있다고 수정했다. 현재 문서에서는 실제 에이전트 실행 기준 평균 54%를 사용한다. GPT-5.5처럼 사다리를 검토하는 과정에서 추론 토큰을 많이 쓰는 모델은 비용과 시간이 늘 수도 있다.
설치
Claude Code에서는 대화창에 아래 두 명령을 따로 입력한다.
/plugin marketplace add DietrichGebert/ponytail
/plugin install ponytail@ponytailCodex CLI와 Codex 데스크톱 앱은 다음 명령으로 설치한다. 설치 후 /hooks에서 두 lifecycle hook을 검토하고 신뢰한 뒤 새 스레드를 시작한다. 데스크톱 앱은 재시작해야 플러그인을 읽는다.
codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytailGitHub Copilot CLI, Gemini CLI, Pi, OpenCode, OpenClaw 등도 지원한다. 호스트별 설치 명령과 instruction-only 방식은 공식 설치 안내를 확인한다.
Claude Code와 Codex 플러그인은 항상 적용되는 모드 전환을 위해 작은 Node.js lifecycle hook 두 개를 사용한다. Node.js가 비대화형 셸의 PATH에 있어야 하며, 없다면 스킬은 쓸 수 있지만 자동 활성화는 동작하지 않는다.
명령과 강도
| 명령 | 기능 |
|---|---|
/ponytail [lite|full|ultra|off] | 강도를 설정하거나 끈다. 인수 없이 실행하면 현재 모드를 보여 준다. |
/ponytail-review | 현재 diff에서 과잉 구현을 찾아 제거 후보 목록을 제시한다. |
/ponytail-audit | 현재 diff가 아니라 저장소 전체의 과잉 구현을 점검한다. |
/ponytail-debt | 미뤄 둔 ponytail: 정리를 ledger에 모은다. |
/ponytail-gain | 벤치마크의 LOC·비용·속도 점수를 보여 준다. |
/ponytail-help | 명령 빠른 참조를 보여 준다. |
기본 모드는 full이다. lite는 구현은 유지하되 더 작은 대안을 한 줄로 제안한다. full은 사다리를 적용하고, ultra는 요구 사항 자체도 더 작게 만들 수 있는지 강하게 검토한다. PONYTAIL_DEFAULT_MODE 환경 변수나 ~/.config/ponytail/config.json의 defaultMode으로 새 세션의 기본 모드를 바꿀 수 있다.
명령은 Claude Code, Codex, Devin CLI, OpenCode, Gemini 등 skill-capable host에서 쓸 수 있다. Codex에서는 스킬로 등록되어 @ponytail-review처럼 호출한다. Cursor, Windsurf, Cline 등 instruction-only 연동은 항상 적용되는 규칙만 불러오며 명령과 hooks는 제공하지 않는다.
활용 케이스
- AI 에이전트가 작은 변경에도 새 라이브러리, wrapper, 설정 파일을 추가하는 팀
- 작은 기능 변경에서 diff와 장기 유지보수 비용을 줄이고 싶은 코드베이스
- PR 리뷰에서 기존 기능을 재사용하지 않은 구현이 자주 나오는 워크플로
- 메인 에이전트와 서브에이전트 모두에 같은 최소 구현 규칙을 적용하고 싶은 Claude Code·Codex 사용자
Ponytail은 활성화된 상태에서 Agent 도구로 생성한 서브에이전트에도 규칙을 주입한다. 특정 종류의 서브에이전트만 적용하려면 PONYTAIL_SUBAGENT_MATCHER에 agent type을 검사할 정규식을 설정할 수 있다.
Caveman과 함께 쓰기
caveman은 에이전트가 말하는 내용을 압축하고, Ponytail은 에이전트가 작성하는 코드를 줄인다. Caveman은 코드·명령·오류 문자열을 바꾸지 않으므로 두 도구는 역할이 겹치지 않는다. 설명은 짧게 받고 구현도 작게 유지하고 싶을 때 함께 적용할 수 있다.
라이선스
MIT
관련 문서
- agent-skills — 에이전트 스킬 시스템 개요
- claude-code-tips-steering — Claude Code 제어 채널 비교
- caveman — 출력 토큰을 줄이는 Claude Code 스킬
참고 자료
- DietrichGebert/ponytail — GitHub 공식 저장소
- Ponytail — 공식 웹사이트
- Agentic benchmark results — 12개 작업의 측정 방법과 세부 결과