월~금 오전 7시, 일요일 오전 8시 — AI 뉴스와 용어를 보내드립니다메일로 받아보기

METAL LAB

DietrichGebert/ponytail

★ 110,492오늘 +944JavaScript

AI 코딩 에이전트에게 '일단 줄이고 봐라'는 규칙을 심어주는 도구

ponytail은 Claude Code, Codex 같은 AI 코딩 에이전트가 코드를 짜기 전에 '이게 정말 필요한가'부터 따지도록 강제하는 규칙 모음(스킬/플러그인)이다. 라이브러리 설치나 새 컴포넌트 작성보다 먼저 이미 있는 코드 재사용, 표준 라이브러리, 브라우저 내장 기능, 한 줄 코드를 순서대로 시도하게 만든다. 실제 FastAPI+React 저장소에서 같은 에이전트를 켜고/끄고 비교했을 때 코드량이 평균 54% 줄었고 안전장치(검증, 에러 처리, 보안, 접근성)는 그대로 유지됐다.

무엇을 하는 레포인가

  1. 문제: AI 에이전트에게 날짜 입력 기능을 시키면 라이브러리(flatpickr)를 설치하고 래퍼 컴포넌트와 스타일시트까지 만드는 과잉 설계를 한다.
  2. 해결 방법: 코드를 쓰기 전에 '필요한가 → 기존 코드에 있나 → 표준 라이브러리에 있나 → 브라우저/OS 기능으로 되나 → 이미 설치된 패키지로 되나 → 한 줄로 되나 → 그래도 안 되면 최소한만' 순서(사다리)로 점검하게 하는 규칙을 프롬프트/플러그인으로 주입한다.
  3. 결과: 실제 Claude Code 세션(Haiku 4.5 모델)으로 FastAPI+React 오픈소스 저장소를 고치는 12개 기능 작업에서, 스킬 없는 경우 대비 코드량 평균 54%(최대 94%) 감소, 토큰 22% 감소, 비용 20% 감소, 시간 27% 감소를 기록했고 안전성 점수는 100%를 유지했다.
  4. 비교 대상: 같은 조건에서 '장황하게 말만 줄이는' 방식(caveman)이나 'YAGNI+한줄코드만 써라'는 단순 프롬프트는 토큰/비용/시간이 오히려 늘거나 안전성이 95%로 떨어졌는데, ponytail만 모든 지표를 줄이면서 안전성 100%를 유지했다.
  5. 설치: Claude Code, Codex, GitHub Copilot CLI, Cursor, Windsurf, Gemini CLI 등 20개 이상의 AI 코딩 도구에 플러그인이나 규칙 파일 복사 방식으로 붙일 수 있다.

왜 중요한가

AI 코딩 도구가 필요 이상으로 많은 코드와 의존성을 만들어내는 '과잉 설계' 문제는 유지보수 비용과 보안 취약점을 늘리는데, 이 도구는 별도 모델 학습 없이 규칙 텍스트만 주입해서 이를 줄인다. 개발팀이 여러 AI 코딩 에이전트를 도입할 때 코드 품질과 비용을 동시에 관리할 수 있는 실용적인 방법을 보여준다.

이 레포의 용어

  • YAGNI · You Aren't Gonna Need It, 지금 필요 없는 기능은 만들지 말라는 소프트웨어 개발 원칙
  • LOC · Lines of Code, 코드 줄 수
  • AGENTS.md · 여러 AI 코딩 도구가 공통으로 읽어들이는 프로젝트 지침 파일
  • n=4 · 각 작업을 4번씩 반복 측정했다는 뜻
  • Haiku 4.5 · 이번 벤치마크에 사용된 AI 모델 이름

레포 원문 소개 (영문)

Makes your AI agent think like the laziest senior dev in the room. The best code is the code you never wrote.

GitHub에서 보기

주목받는 레포

레포 전체 보기 →

METAL LAB 최신 기사