시킨 것보다 크게 만들어 오는 코드를 반으로 줄이는 ponytail 가이드

추석 AI 부트캠프 하루 6시간 만에
AI 기초부터 나만의
서비스까지 완성 이번 연휴를 기회로 삼으세요일정 보기 ↗

역할: ponytail의 설치와 동작 검증을 맡는 담당

맥락: 이 컴퓨터의 클로드 코드에 ponytail이 아직 설치되지 않았을 수 있고,
지금은 시킨 것보다 크게 만들어 오는지 아닌지를 눈으로 확인할 방법이 없는 상태입니다

입력: <운영체제와 셸, 예: macOS zsh>, <경험, 예: 터미널만 쓸 수 있음>,
<목표 한 줄, 예: 시키지도 않은 것까지 만들어 오는 걸 멈추고 싶다>

작업: 아래 네 단계를 순서대로 진행하세요.
1. 설치 여부 확인: `claude plugin list` 로 이미 있는지 보고하세요.
   있으면 다시 설치하지 말고 버전만 알려주세요.
2. 설치: 저장소 README의 Claude Code 절에 적힌 명령을 그대로 쓰세요.
   README에 두 줄을 한 번에 보내면 안 된다고 적혀 있으니, 그 지시를 지키세요.
   마켓 이름과 설치 ID를 추측하지 말고 README에서 확인한 값을 쓰세요.
3. 동작 확인: 세션을 새로 연 뒤 인자 없이 `/ponytail` 을 쳐서 현재 강도를 보고하고,
   이어서 “웹 페이지에 날짜 고르는 칸을 하나 넣어 주세요”라고 시키세요.
   라이브러리를 새로 깔았는지, 아니면 브라우저에 원래 있는 기능을 썼는지 그대로 알려주세요.
4. 마지막에 이게 무엇을 강제하고 무엇은 못 하는지, 개발을 처음 하는
   사람도 이해할 수 있는 말로 다섯 줄 이내로 설명하세요.

제약: 설치 명령이나 강도 이름을 추측해서 말하지 마세요. README에서 확인한 값만 쓰세요.
3번에서 코드를 실제로 만들기 전에, 몇 줄짜리가 될지 먼저 알려주세요.
비밀키와 자격 증명 파일을 읽거나 출력하지 마세요.

출력: 확인한 설치 상태, 실행한 명령, 현재 강도, 날짜 칸을 만들 때 쓴 방법과 줄 수,
남은 문제를 정리해 주세요.

검증: 인자 없이 `/ponytail` 을 쳤을 때 현재 강도가 답으로 돌아와야 하고,
날짜 칸 과제에서 새 라이브러리를 하나도 깔지 않아야 합니다.
하나라도 실패하면 완료로 보고하지 말고 실패 지점과 다음 조치를 알려주세요.

이걸 깔면 무엇이 달라지나

시켜 놓고 나온 결과가 마음에 안 드는 이유는 대개 실력이 아니라 크기입니다. 사람이라면 신입이라도 "이건 브라우저에 원래 있는데요"라고 말합니다. AI는 그 말을 안 하고 일단 만듭니다.

저장소가 첫 화면에 걸어 둔 예가 정확히 그 장면입니다. 날짜 고르는 칸을 하나 넣어 달라고 하면 라이브러리를 깔고, 감싸는 파일을 만들고, 스타일 파일을 더하고, 시간대 이야기를 꺼냅니다. ponytail을 켜면 같은 요청에 이 한 줄이 돌아옵니다.

[켜기 전]  라이브러리 설치 → 감싸는 파일 → 스타일 파일 → 시간대 논의

[켜고 나서]
  <!-- ponytail: browser has one -->
  <input type="date">

여기서 중요한 건 결과가 아니라 판단입니다. 코드를 못 읽는 사람은 파일 다섯 개가 돌아와도 그게 과한지 알 수 없습니다. 열어 봐야 아는 걸 안 열어 보고도 알게 만드는 방식이 하나뿐인데, 만들기 전에 스스로 멈춰 세우는 것입니다.

개발을 모를수록 효과가 큽니다

개발자는 결과를 열어 보고 "이거 이렇게까지 안 해도 되는데요"라고 되받을 수 있습니다. 코드를 못 읽으면 그 말을 못 합니다. 많이 나온 걸 오히려 열심히 한 것으로 읽게 됩니다.

이 설치물이 대신 하는 말이 그 되받음입니다. 코드를 쓰기 전에 일곱 개 질문을 순서대로 던지고, 답이 나오는 첫 칸에서 멈춥니다.

```

1. 이게 꼭 있어야 하나? → 아니면 안 만든다
2. 이 코드 안에 이미 있나? → 있으면 그걸 쓴다
3. 언어에 기본으로 딸려 있나? → 있으면 그걸 쓴다
4. 브라우저나 운영체제가 해 주나? → 해 주면 그걸 쓴다
5. 이미 깔려 있는 도구가 하나? → 하면 그걸 쓴다
6. 한 줄로 되나? → 한 줄로 쓴다
7. 여기까지 다 아니면 → 돌아가는 만큼만 최소로

```

부르는 게 아니라는 점이 중요합니다. 명령어를 외울 필요가 없습니다. 한 번 깔고 세션만 새로 열면 코딩 작업마다 알아서 걸립니다.

Quick Start

공식 저장소: ponytail 공식 GitHub · MIT 무료 · 공식 홈페이지 ponytail.dev

클로드 코드 대화창에 두 줄을 칩니다. 한 번에 같이 보내면 설치가 안 됩니다. 저장소 README에 "설치가 되려면 두 개의 프롬프트로 나눠 보내야 한다"고 괄호까지 쳐서 적혀 있습니다.

/plugin marketplace add DietrichGebert/ponytail

/plugin install ponytail@ponytail

설치가 됐는지 화면에서 확인합니다.

claude plugin list

설치가 끝나면 세션을 새로 여세요. 이 한 줄을 빠뜨려서 "설치했는데 아무 일도 안 일어난다"고 넘어가는 경우가 가장 많습니다.

진짜 걸리는지 확인

설치됐는지가 아니라 실제로 게을러졌는지를 봐야 합니다. 새 세션에서 두 가지를 칩니다.

/ponytail

웹 페이지에 날짜 고르는 칸을 하나 넣고 싶습니다.
만들기 전에 몇 줄짜리가 될지 먼저 알려주세요.

STEP 1 · 3분무엇을 깔는 건지 먼저 알기

이 단계에서는 명령어를 치기 전에 이게 뭔지부터 잡습니다. 프롬프트 모음으로 착각하면 쓰는 방법을 틀리기 때문입니다.

ponytail은 코딩을 시킬 때마다 판단 기준을 먼저 얹는 설치물입니다. 사람이 "간단하게 해줘"라고 매번 붙이는 대신, 코딩 작업이 오면 알아서 앞의 일곱 칸을 밟습니다.

숫자부터 봅니다. 아래는 2026년 8월 30일에 깃허브가 공개하는 저장소 정보를 직접 확인한 값입니다.

• 깃허브 스타 116,154 · 포크 6,340
• 공개 2026-06-12 — 약 두 달 반
• 라이선스 MIT · 무료
• 최신 판 v4.9.0 (2026-08-07)
• 아직 안 닫힌 문의 69건

별 개수는 안전 보증이 아닙니다. 관심도 신호일 뿐입니다. 이 설치물은 클로드 코드에 깔릴 때 작은 프로그램 두 개를 같이 돌리니, 깔기 전에 저장소 주인과 최근 변경 내역을 한 번 보고 넣으세요.

STEP 2 · 2분두 번 나눠 보내고 세션 새로 열기

이 단계에서는 실제로 깝니다. 명령은 두 줄인데, 그 두 줄을 어떻게 보내느냐가 이 도구에서 가장 자주 걸려 넘어지는 자리입니다.

앞의 Quick Start대로 /plugin marketplace add 를 먼저 보내고 답을 받은 뒤에 /plugin install 을 보냅니다. 두 줄을 한 번에 붙여넣으면 설치가 안 됩니다.

깔고 나면 아직 아무 일도 일어나지 않습니다. 세션을 새로 여세요. 이 설치물은 세션이 시작될 때 규칙을 대화 맨 앞에 밀어 넣는 방식이라, 이미 열려 있던 세션에는 그게 안 들어가 있습니다.

클로드 코드와 코덱스에 깔 때는 node 가 컴퓨터에 깔려 있어야 합니다. 없어도 스킬 자체는 돌아가지만, 매번 자동으로 켜지는 부분이 조용히 빠집니다. 저장소 README가 그렇게 적어 두었습니다.

클로드 코드 말고도 README 설치 절에 호스트가 열네 곳 적혀 있습니다. 코덱스 · Copilot CLI · Gemini CLI · OpenCode · Devin · Grok · Hermes 같은 것들이고, 도구마다 명령이 다르니 저장소 README의 해당 절을 그대로 보세요.

STEP 3 · 3분진짜로 게을러졌는지 시켜서 확인하기

이 단계에서는 설치 확인이 아니라 결과가 작아졌는지를 봅니다. 목록에 이름이 떠 있어도 실제로 안 걸리는 경우가 있기 때문입니다.

앞의 "진짜 걸리는지 확인"에 있는 날짜 칸 요청을 그대로 씁니다. 이 과제를 고른 데는 이유가 있습니다. 만든 사람이 실제 저장소에서 잰 값에서 가장 크게 갈린 자리가 정확히 이것입니다.

• 날짜 고르는 칸 — 404줄 → 23줄
• 색 고르는 칸 — 287줄 → 23줄
• 파일 끌어다 놓는 칸 — 251줄 → 95줄
• 목록에서 제목으로 검색 — 44줄 → 44줄 (하나도 안 줄어듦)

마지막 줄이 중요합니다. 원래 군더더기가 없는 일에서는 아무것도 안 줄어듭니다. 줄어드는 건 "브라우저에 원래 있는 걸 손으로 다시 만들던 자리"뿐입니다. 시험할 때 그 자리를 골라야 차이가 보입니다.

STEP 4 · 3분강도 세 단계 골라 두기

이 단계에서는 얼마나 게으르게 할지를 정합니다. 기본값이 세지도 약하지도 않은 가운데라, 손대지 않으면 그대로 굴러가기 때문입니다.

한 번 정하면 세션이 끝날 때까지 유지됩니다. 끄고 싶으면 대화창에 "stop ponytail" 이나 /ponytail off 를 칩니다.

매번 정하기 귀찮으면 기본값을 아예 바꿉니다.

export PONYTAIL_DEFAULT_MODE=ultra

STEP 5 · 4분이미 만들어 둔 코드에서 지울 것 찾기

이 단계에서는 앞으로 만들 것이 아니라 이미 쌓여 있는 것을 봅니다. 지금까지 시켜서 나온 결과가 이미 부풀어 있을 수 있기 때문입니다.

같이 깔리는 명령이 여섯 개인데, 그중 둘이 이 일을 합니다. /ponytail-review 는 방금 바꾼 부분만, /ponytail-audit 은 프로젝트 전체를 훑습니다. 둘 다 고치지는 않고 목록만 줍니다.

/ponytail-review

돌아오는 모양은 이렇습니다. 아래는 스킬 문서에 예시로 박혀 있는 형식을 그대로 옮긴 것입니다.

L12-38: stdlib: 27줄짜리 이메일 검사 클래스. 언어에 기본으로 있는 걸로 한 줄이면 됩니다

L4: native: 날짜 표시 한 번 하려고 라이브러리를 하나 깔았습니다. 브라우저 기능으로 바꾸면 0개

repo.py:L88: yagni: 안에 든 게 하나뿐인 껍데기. 두 번째가 생길 때까지 그냥 안에 넣습니다

net: -N lines possible.

고치는 것까지 시키지는 마세요. 이 두 명령은 읽고 목록만 내놓게 만들어져 있습니다. 지울지 말지는 사람이 정하는 자리로 남겨 둔 것입니다.

STEP 6 · 3분미뤄 둔 것이 잊히지 않게

이 단계에서는 게으르게 하고 넘어간 자리를 모읍니다. 지금은 이 정도면 되지만 언젠가 손봐야 하는 것들이 있는데, 적어 두지 않으면 "나중에"가 "영영"이 되기 때문입니다.

이 설치물은 일부러 대충 하고 넘어간 자리에 ponytail: 로 시작하는 표시를 남깁니다. 그 표시에는 어디까지만 버티는지와 언제 손봐야 하는지를 같이 적게 돼 있습니다. /ponytail-debt 가 그 표시를 전부 긁어모아 한 장으로 보여줍니다.

/ponytail-debt

손볼 조건이 안 적힌 표시는 따로 표가 붙어서 나옵니다. 그게 조용히 썩는 것들이라고 스킬 문서에 적혀 있습니다.

자주 막히는 곳

FAQ

설치했는데 지금 대화에서 아무 일도 안 일어납니다

이 설치물은 세션이 시작될 때 규칙을 대화 맨 앞에 밀어 넣습니다. 이미 열려 있던 세션에는 그게 안 들어가 있으니 아무것도 안 걸립니다. 세션을 새로 여세요. 그래도 안 되면 인자 없이 /ponytail 을 쳐서 현재 강도가 돌아오는지 보세요. 돌아오지 않으면 설치가 안 된 것입니다.

깐 지 오래됐는데 그때랑 지금이 다릅니까

다릅니다. 이 컴퓨터에 깔려 있던 설치본 두 벌을 2026년 8월 30일에 직접 읽고 저장소 최신본과 글자 단위로 맞춰 봤습니다. 최신본과 완전히 같은 것이 한 벌, 2026년 6월 25일에 깔린 옛것이 한 벌이었습니다. 그리고 옛것에서 언제 걸리는지가 달랐습니다.

• 옛 판 — 사람이 "ponytail" 이라고 부르거나 너무 복잡하다고 불평할 때만 걸립니다
• 지금 판 — 모든 코딩 작업에 걸립니다. 만들 때, 고칠 때, 라이브러리를 고를 때 전부

즉 오래된 설치본을 그대로 두면 "깔았는데 안 걸린다"가 맞는 말이 됩니다. 부르지 않아서 안 걸린 것입니다. 아래로 올립니다.

/plugin marketplace update ponytail
/reload-plugins

클로드 코드 말고 다른 데도 됩니까

됩니다. README 설치 절에 호스트가 열네 곳 적혀 있고, 규칙 파일만 복사해 쓰는 방식까지 합치면 더 늘어납니다. 어느 도구에 어떤 파일이 들어가는지는 Agent portability 공식 문서에 표로 정리돼 있습니다. 한국어 README도 공식 저장소에 같이 들어 있습니다.

너무 게을러서 꼭 필요한 걸 빼면 어떡합니까

빼지 못하게 막아 둔 목록이 따로 있습니다. 설치본 문서에 입력값 검사 · 데이터가 날아가는 걸 막는 처리 · 보안 · 접근성 · 사용자가 명시적으로 요청한 것은 절대 줄이지 않는다고 적혀 있습니다.

만든 사람이 이걸 실제로 재 봤습니다. 일부러 위험한 입력을 넣는 시험 스무 번에서 ponytail은 20번 다 막았고, "YAGNI를 따르고 한 줄짜리를 선호하라"는 짧은 지시문만 붙인 쪽은 19번을 막았습니다. 뚫린 한 번은 파일 경로 검사를 아껴서 생긴 것입니다. 줄이라고만 시키면 안전장치부터 사라진다는 게 이 도구가 내세우는 차이입니다.

그래도 큰 걸로 만들어야 하는 사정이 있으면 그냥 그렇게 시키면 됩니다. 저장소 FAQ에 "우기면 만들어 준다"고 적혀 있습니다.

대신 말투도 짧아집니까

아닙니다. 설치본 문서에 "무엇을 만드는지를 다루지, 어떻게 말하는지는 다루지 않는다"고 선을 그어 두었습니다. 답변 자체를 짧게 만들고 싶으면 만든 사람이 같이 쓰라고 권한 caveman이 따로 있습니다.

지우려면 어떻게 합니까

순서가 반대면 찌꺼기가 남습니다. 정리 스크립트가 설치 폴더 안에 들어 있어서, 먼저 지워 버리면 그 스크립트까지 같이 사라집니다. 저장소에 굵게 적혀 있는 순서를 그대로 따릅니다.

node scripts/uninstall.js

그다음에 대화창에서 /plugin remove ponytail 을 칩니다.

알아 둘 한계

숫자는 한 저장소에서 나온 것입니다. 만든 사람이 공개한 측정은 실제 오픈소스 저장소 한 개, 작업 12개, 각 4회, 모델 하나(작은 판)에서 잰 값입니다. 저장소 스스로 "모델 하나뿐이고, 큰 모델에서는 차이가 줄 수도 늘 수도 있다"고 한계 절에 적어 두었습니다.

줄어드는 폭은 일마다 다릅니다. 날짜 칸은 94% 줄었지만 목록 검색은 0%였습니다. 54%는 열두 개를 평균 낸 값이지, 내 일에서 나올 값이 아닙니다.

예전에 내걸던 80~94%는 저장소가 스스로 물렸습니다. 처음 측정이 한 번 물어보고 한 번 답받는 방식이라 비교 대상이 말을 길게 늘어놓았고, 그래서 차이가 부풀었다는 지적을 받아들인 것입니다. 지금 README는 그 숫자를 "평균이 아니라 잘 나올 때의 상한"이라고 고쳐 적었습니다. 다만 같이 깔리는 /ponytail-gain 명령은 여전히 옛 숫자가 든 표를 보여줍니다. 2026년 8월 30일에 그 스킬 문서를 직접 읽고 저장소 최신본과 대조했는데 둘이 같았습니다.

어떤 모델에서는 오히려 느려지고 비싸집니다. 사다리를 밟는 것 자체에 생각하는 비용이 드는 모델이 있기 때문입니다. README가 GPT-5.5를 그 예로 이름까지 적어 두었습니다.

내 프로젝트에서 몇 줄을 아꼈는지는 안 나옵니다. 안 만든 코드는 애초에 쓰인 적이 없어서 뺄 기준값이 없기 때문입니다. /ponytail-gain 스킬 문서에 저장소별 절감 숫자를 절대 찍지 말라고 못 박아 두었습니다. 대신 셀 수 있는 건 /ponytail-debt 가 세는 미뤄 둔 표시 개수뿐입니다.

고쳐 주지는 않습니다. /ponytail-review 와 /ponytail-audit 은 지울 목록만 내놓고 손대지 않습니다. 지울지 말지는 사람이 정해야 합니다.

공식 자료

• 저장소 — ponytail 공식 GitHub · MIT
• 홈페이지 — ponytail.dev
• 규칙 원문 — ponytail 공식 SKILL.md
• 측정 원문 — 공식 벤치마크 기록 (2026-06-18)
• 숫자를 다시 잰 계기 — 공식 저장소 문의 #126
• 한국어 README — 공식 번역본