포니테일 설치 가이드

AI를 세상에서 제일 게으른 시니어 개발자로 만드는 스킬. 최고의 코드는 안 쓴 코드다. 깃허브: DietrichGebert/ponytail (MIT 라이선스, 무료) 최종 확인일 2026년 8월 24일

30초 설치 (클로드 코드)

클로드 코드에서 아래 두 명령어를 각각 따로 입력하세요. 한 번에 붙여넣으면 설치가 안 되고, 두 개의 프롬프트로 나눠 보내야 합니다.

/plugin marketplace add DietrichGebert/ponytail

/plugin install ponytail@ponytail

끝입니다. 이후 모든 코딩 작업에 자동으로 적용돼요.

💡 데스크톱 앱에서도 똑같이 됩니다. Code 탭 입력창에 위 두 명령어를 치거나, 입력창 옆 + 버튼 → Plugins → Add plugin에서 설치하세요. ⚠️ 플러그인이 Node.js 훅 두 개를 실행해서 node가 PATH에 있어야 합니다. 없어도 스킬 자체는 작동하는데, 자동 활성화만 조용히 꺼져요. nvm이나 Nix 쓰는 분은 비대화형 셸 PATH에 node가 잡히는지 확인하세요.

이 스킬이 하는 일

AI 코딩 에이전트는 기본적으로 과잉 구현 성향이 있습니다. 버튼 하나 바꿔달라고 하면 라이브러리를 새로 깔고, 래퍼를 만들고, 설정 파일을 추가하죠. 포니테일은 코드를 쓰기 전에 아래 사다리를 순서대로 타게 만듭니다.

1. 이게 존재해야 하나? 아니면 건너뜀 (YAGNI)

2. 이미 코드베이스에 있나? 재사용

3. 표준 라이브러리로 되나? 그거 씀

4. 플랫폼 기본 기능으로 되나? 그거 씀

5. 설치된 의존성으로 되나? 그거 씀

6. 한 줄로 되나? 한 줄로 끝

7. 그래도 안 되면 그때서야 최소한만 구현

원칙 두 가지가 핵심이에요.

• 게으른 건 솔루션이지 읽기가 아니다. 사다리는 문제를 이해한 다음에 타는 겁니다. 관련 코드를 먼저 읽고 실제 흐름을 따라간 뒤에 선택해요.
• 게으르되 태만하지 않다. 신뢰 경계에서의 검증, 데이터 유실 처리, 보안, 접근성은 절대 줄이지 않습니다.

실측 성능 (공식 벤치마크)

실제 오픈소스 저장소(FastAPI + React)를 클로드 코드로 수정하는 실전 세션에서, 같은 에이전트를 스킬 없이 돌린 것과 비교한 수치입니다.

항목	결과
코드량	평균 54% 감소, 최대 94%
비용	약 20% 절감
속도	약 27% 빨라짐
안전성	보안 가드 100% 유지

• 54%는 기능 구현 12개 태스크 평균이고, 에이전트가 과잉 구현하는 상황(예: 날짜 선택기를 통째로 만들 때)에선 94%까지 줄어요. 이미 미니멀한 코드에선 거의 0에 가깝습니다.
• 단순히 “한 줄로 짜”라고 프롬프트하면 보안 가드를 하나 건너뛰는데, 포니테일은 전부 유지했다는 게 공식 리포트의 포인트예요.
• 전체 리포트는 저장소의 benchmarks/results 폴더에 있습니다.

명령어

설치하면 슬래시 명령어가 같이 등록됩니다.

명령어	용도
/ponytail	모드 전환
/ponytail-review	미니멀리즘 관점 코드 리뷰
/ponytail-audit	저장소 감사
/ponytail-debt	기술 부채 점검
/ponytail-gain	개선 효과 확인
/ponytail-help	전체 도움말

각 명령어의 상세 동작은 설치 후 /ponytail-help로 확인하는 게 가장 정확합니다. 기본 모드는 full이고, 세션별로 바꾸거나 PONYTAIL_DEFAULT_MODE 환경변수 또는 ~/.config/ponytail/config.json으로 전역 설정할 수 있어요.

클로드 코드 말고 다른 도구를 쓴다면

슬래시 명령어까지 전부 지원 (스킬 지원 도구)

Codex, Devin CLI, OpenCode, Gemini CLI, Copilot CLI 등. Codex는 아래처럼 설치하고, 명령어는 @ponytail-review처럼 @로 호출합니다.

codex plugin marketplace add DietrichGebert/ponytail
codex plugin add ponytail@ponytail

설치 후 /hooks에서 라이프사이클 훅 두 개를 승인하고 새 스레드를 시작하세요.

규칙만 적용 (규칙 파일 도구)

Cursor, Windsurf, Cline, Kiro 등은 플러그인 설치가 안 되는 대신, 저장소에서 해당 도구용 규칙 파일을 복사해 프로젝트에 넣으면 됩니다. Cursor라면 .cursor/rules/ 폴더에 넣으면 자동 적용돼요. 이 방식은 상시 규칙만 작동하고 슬래시 명령어는 빠집니다.

자주 묻는 것

• 무료인가요? 네, MIT 라이선스 오픈소스입니다.
• 끄고 싶으면? /plugin 메뉴에서 비활성화하거나 제거하면 됩니다. 세션 중엔 /ponytail로 모드를 바꿀 수도 있어요.
• 서브에이전트에도 적용되나요? 네, 활성화 상태에서 Agent 도구로 만든 서브에이전트에도 규칙이 주입됩니다.
• 이름이 왜 포니테일이에요? 마스코트가 꽁지머리 묶은 시니어 개발자 아저씨입니다. 저 아닙니다.