- 신영선
- 기본 과정
- 깃허브
요즘 해외에서 난리 난 포니테일 아저씨
바이브코딩할 때 이 아저씨 모르면 손해입니다.
- 릴스 영상을 저장 또는 공유하기로 기록 해놓습니다.
- DM으로 받은 링크를 카톡으로 옮겨 놓습니다.
- PC로 접속해서 AI 즐겨찾기 폴더를 만들어 저장해놓습니다.
- 바로 사용을 해봅니다. 절대 미루지 마세요. (⭐ 제일 중요)
1. 깃허브 오픈 소스 자료
https://github.com/DietrichGebert/ponytail
Claude Code에서 ponytail 쓰는 법
1. 설치
Claude Code 프롬프트 창에 아래 두 줄을 각각 따로 입력합니다. 한 번에 붙여넣으면 설치가 안 됩니다.
/plugin marketplace add DietrichGebert/ponytail
(엔터 후, 응답이 온 다음에)
/plugin install ponytail@ponytail
끝입니다. 설치되면 현재 모드가 화면에 표시됩니다.
전제조건 하나: node가 PATH에 있어야 합니다. Claude Code 플러그인이 작은 Node.js 라이프사이클 훅 2개를 돌리기 때문입니다. Node가 없어도 스킬 자체는 작동하지만, "항상 켜짐" 자동 활성화는 조용히 꺼진 상태가 됩니다. (nvm/Nix 쓰신다면 비대화형 셸 PATH에도 node가 잡혀야 합니다.)
데스크톱 앱 Code 탭에서도 동일합니다. 위 두 명령어를 프롬프트 박스에 입력하거나, 옆의 + 버튼 → Plugins → Add plugin으로 설치하면 됩니다.
2. 설치 후 자동으로 일어나는 일
별도 설정 없이 모든 세션에서 자동 적용됩니다. 기본 모드는 full. 이제부터 Claude Code가 코드를 쓰기 전에 이 순서로 자문하고, 처음 걸리는 지점에서 멈춥니다.
1. 이게 존재해야 하나? → 아니면 안 만듦 (YAGNI)
2. 코드베이스에 이미 있나? → 재사용
3. 표준 라이브러리로 되나? → 그거 씀
4. 네이티브 기능인가? → 그거 씀
5. 이미 깔린 의존성인가? → 그거 씀
6. 한 줄로 되나? → 한 줄
7. 그제서야: 되는 최소한
체감 예시: "날짜 선택기 만들어줘"라고 하면 원래는 flatpickr 설치 + 래퍼 컴포넌트 + 스타일시트 + 타임존 논의까지 갑니다. ponytail이 켜져 있으면 <input type="date"> 한 줄로 끝냅니다.
중요한 건 읽는 것에는 게으르지 않다는 점입니다. 사다리는 문제를 이해한 후에 돌아갑니다. 변경이 닿는 코드는 다 읽고 실제 흐름을 추적한 뒤 어느 칸에서 멈출지 정합니다. 그리고 신뢰 경계 검증, 데이터 손실 처리, 보안, 접근성 이 네 가지는 절대 잘라내지 않습니다.
3. 실제로 쓰는 커맨드 5개
| 커맨드 | 언제 쓰나 |
|---|---|
/ponytail | 지금 모드가 뭔지 확인 |
/ponytail lite | 살살 (프로덕션 코드 작업할 때) |
/ponytail full | 기본값 |
/ponytail ultra | 세게 (프로토타입, 실험 코드) |
/ponytail off | 잠깐 끄기 |
| 커맨드 | 기능 |
|---|---|
/ponytail-review | 지금 diff를 훑고 "이건 지워도 됨" 리스트를 뽑아줌 |
/ponytail-audit | diff 말고 레포 전체를 감사 |
/ponytail-debt | 미뤄둔 ponytail: 주석들을 모아 부채 원장으로 정리 |
/ponytail-gain | 절감 효과 스코어보드 |
/ponytail-help | 커맨드 요약 |
실무에서 가장 많이 쓰게 되는 건 /ponytail-review입니다. 커밋 전에 한 번 돌리면 "왜 이걸 만들었지" 싶은 코드가 잡힙니다.
4. 추천 사용 패턴
하루차: 설치만 하고 full 그대로 둔 채 평소처럼 씁니다. 코드가 눈에 띄게 짧아지는지 체감만 봅니다.
일주일차: 커밋 전 /ponytail-review를 습관화합니다. 여기서 나오는 삭제 리스트가 사실상 무료 코드 리뷰입니다.
모드 선택 기준:
- CMOS 같은 프로덕션 SaaS 코드 →
lite또는full - 내부 툴·프로토타입·1회성 스크립트 →
ultra - 아키텍처 설계 단계 →
off(설계 논의를 "필요 없음"으로 잘라버릴 수 있음)
세션마다 매번 바꾸기 귀찮으면 환경변수 PONYTAIL_DEFAULT_MODE=lite 로 기본값을 고정하거나, ~/.config/ponytail/config.json에 defaultMode 필드를 넣으면 됩니다. 설정 파일은 필수가 아닙니다.
5. 알아둘 것
효과는 균등하지 않습니다. 실측 평균은 코드량 -54%지만, 오버빌드 함정이 있는 작업(날짜 선택기 404줄 → 23줄, 컬러 피커 287줄 → 23줄)에서 최대 94%까지 가고, 이미 최소한으로 짜인 코드에서는 거의 0입니다. 즉 에이전트가 과잉 설계하기 쉬운 UI/유틸 작업에서 이득이 크고, 이미 압축된 로직에서는 별 차이가 없습니다.
6. 지우고 싶을 때
node scripts/uninstall.js
를 먼저 돌린 다음
/plugin remove ponytail
순서가 중요합니다. uninstall 스크립트 자체가 플러그인 파일이라, 플러그인을 먼저 지우면 스크립트도 같이 사라집니다.
이런 자료를 이메일로 받아보시겠습니까? 무료 강의 안내도 같이 갑니다.
무료로 신청하기