DietrichGebert/ponytail

Ponytail – '시니어 개발자' 프롬프트 for AI 코딩 에이전트

What it is – Ponytail은 단일 파일 프롬프트(그리고 작은 npm 패키지)로, Claude Code, Codex, Cursor, Copilot, Gemini 등과 같은 LLM 기반 코딩 어시스턴트에 로드합니다. 설치 후 에이전트는 변경 요청을 보고 아무 말 없이 검증, 보안 및 접근성을 유지하면서 작업을 충족하는 최소한의 구현을 반환하는 베테랑 개발자처럼 행동합니다.

핵심 아이디어

• The ladder – 에이전트가 문제를 이해한 후 일곱 가지 질문의 "사다리"를 따라 이동합니다(기능이 이미 존재합니까? 표준 라이브러리가 처리할 수 있습니까? 한 줄로 처리할 수 있습니까? 등). 그리고 작동하는 첫 번째 단계에서 멈춥니다. 이렇게 하면 에이전트가 기존 코드를 재사용하고 실제로 필요한 것만 작성하게 됩니다.
• 리뷰 및 감사 명령 – /ponytail-review는 커밋하려는 diff를 검사하여 버그, 보안 허점, 누락된 테스트, 성능 문제 및 불필요한 코드를 표시합니다. /ponytail-audit는 전체 저장소에 대해 동일한 분석을 실행하고 결과를 순위화하여 무엇을 먼저 수정해야 하는지 알려줍니다.
• Band 및 board – Claude Code에서 프롬프트 위의 작은 "band"는 실시간 통계(사용된 토큰, 비용, 에이전트 시간, 재사용률, 테스트 결과)를 보여줍니다. 선택적 board는 모든 세션에서 이러한 메트릭을 집계하는 로컬 대시보드입니다.
• 모드 – /ponytail lite|full|ultra|off를 사용하면 프롬프트가 얼마나 공격적인지 조정할 수 있습니다. "Ultra"는 코드베이스가 당신을 나쁘게 대했더라도 계속 파고들 것입니다.
• 제로 구성 – 도구는 기본적으로 작동합니다. 선택적 ~/.config/ponytail/config.json 또는 PONYTAIL_DEFAULT_MODE 환경 변수가 기본 모드를 설정할 수 있습니다.

작동 방식

1. 설치 – Claude Code(/plugin marketplace add DietrichGebert/ponytail) 또는 Codex(codex plugin marketplace add …)에 플러그인을 추가합니다. 다른 에이전트의 경우 AGENTS.md 또는 skills/ponytail/SKILL.md 파일을 프로젝트에 복사하기만 하면 됩니다.
2. 프롬프트 주입 – 스킬 파일은 에이전트의 일반적인 동작을 재정의하는 시스템 수준 프롬프트로 로드됩니다. 이후의 모든 메시지는 Ponytail 규칙을 통해 해석됩니다.
3. 명령 처리 – 플러그인은 호스트 IDE/CLI가 LLM에 전달하는 슬래시 명령(/ponytail-review, /ponytail-audit 등)을 등록합니다. LLM은 호스트가 사용자에게 표시하는 구조화된 응답(코드 diff, 테스트 스니펫, 위험 메모)을 반환합니다.
4. 메트릭 – 각 턴 후 에이전트는 토큰 사용량, 비용 및 생성된 테스트가 통과했는지 여부를 보고합니다. band는 이를 시각화하고 board는 ~/.config/ponytail/band/ 아래에 로컬 로그를 저장합니다.

일반적인 워크플로우

1. Claude Code에서 새 스레드를 엽니다(또는 Codex 세션을 시작).
2. `/ponytail`을 입력하여 기본 모드를 활성화합니다.
3. 기능을 요청합니다(예: "체크아웃 양식에 날짜 선택기를 추가하세요").
4. Ponytail은 저장소를 읽고 기존 `Input` 컴포넌트를 찾은 다음 네이티브 HTML 날짜 입력을 재사용하는 10줄 파일을 반환합니다.
5. `/ponytail-review`를 실행합니다 – 에이전트는 누락된 검증을 지적하고 작은 테스트를 추가합니다.
6. 변경 사항을 커밋합니다. band는 토큰 약 45%와 턴당 $0.72를 절약했음을 보여줍니다.

주장하는 내용 (README의 벤치마크에 근거)

• 기준 "스킬 없음" 에이전트와 비교하여 -53% 코드, -41% 시간, -26% 비용, -45% 토큰.
• 위험한 로직의 **98%**가 테스트와 함께 제공됩니다(Ponytail 없이 68% 대비).
• 보안 중심 작업(SQL 인젝션, 경로 탐색 등)에서는 더 적은 코드를 사용하면서 30개 실행 모두 통과했습니다.

누가 사용할 수 있을까요?

• 이미 LLM 코딩 어시스턴트에 의존하고 있으며 최소한의 안전한 변경을 강제하는 가드레일을 원하는 팀.
• 토큰 비용을 줄이고 저장소를 깔끔하게 유지하려는 개인 개발자.
• AI 워크플로우에 감사 스타일 안전망(보안 검사, 테스트 커버리지)을 통합해야 하는 조직.

제한 사항 / 주의 사항

• Ponytail은 단지 프롬프트일 뿐입니다. 품질은 기본 모델(Claude, Gemini 등)에 따라 달라집니다. 모델이 환각을 일으키면 안전 검사가 이를 놓칠 수 있습니다.
• "band" 시각화는 Claude Code 2.1.290+에서만 작동합니다. 다른 호스트는 핵심 프롬프트를 얻지만 UI는 얻지 못합니다.
• 호스트가 /plugin 명령을 실행하고 로컬 보드를 위한 작은 파일 시스템을 노출할 수 있다고 가정합니다. 모든 IDE 통합이 아직 이를 지원하는 것은 아닙니다.
• 이 도구는 컴파일된 바이너리를 제공하지 않습니다. 실행 파일을 추가하는 악의적인 포크는 작성자의 통제 범위를 벗어납니다.

결론 – Ponytail은 문서화가 잘 된 오픈소스 프롬프트 기반 확장 프로그램으로, 일반 LLM 코딩 에이전트를 가능한 가장 작은 올바른 변경을 작성하고 버그, 보안 및 테스트 커버리지를 자동으로 검토하는 "시니어 개발자"로 전환합니다. AI 에이전트 도구 공간 내에 머물면서 비용 절감 주장을 정당화하는 구체적인 메트릭을 제공합니다.