no-mistakes — git push 실수를 AI 검증 파이프라인으로 차단하는 도구

들어가며

git push 한 번이 production 브랜치를 깨뜨린 경험, 한 번쯤은 있으실 겁니다. 로컬에서 git push origin main을 치는 순간 CI는 빨갛게 물들고, PR은 자동 머지되고, 팀 슬랙에는 누군가의 한숨이 올라옵니다.

오늘 소개할 no-mistakes는 이런 사고를 구조적으로 방지하기 위해 만들어진 도구입니다. 단순한 pre-commit hook과 달리, AI 에이전트 기반의 검증 파이프라인을 로컬 git 프록시 뒤에 둡니다.

핵심 아이디어: 로컬 git 프록시 + 격리된 worktree

전체 흐름은 의외로 단순합니다.

1. origin 대신 no-mistakes 라는 로컬 git 프록시로 push
2. push 순간 일회용 worktree를 띄움
3. 격리된 환경에서 review → test → docs → lint → push → PR → CI 순서로 AI 기반 검증 실행
4. 모든 검사가 green일 때만 실제 remote에 브랜치 전달 + PR 자동 생성

가장 중요한 포인트는 검증이 격리된 worktree에서 실행된다는 점입니다. 진행 중인 작업 파일을 건드리지 않고, 완전히 분리된 디렉터리에서 모든 게이트를 통과해야만 진짜 push가 일어납니다.

에이전트 비종속 vs 에이전트 네이티브

no-mistakes의 강점 중 하나는 다중 에이전트 지원입니다.

• 에이전트 비종속 모드: claude, codex, opencode, pi, copilot 등 다양한 코딩 에이전트를 순서 지정 폴백으로 사용. 어느 회사의 에이전트든 검증 단계에 투입할 수 있습니다.
• 에이전트 네이티브 모드: /no-mistakes 라는 slash 명령으로 이미 돌아가고 있는 코딩 에이전트의 작업이나, 이미 커밋된 작업을 검증 파이프라인에 태울 수 있습니다.

각 단계는 통과하거나, 사용자가 처리해야 할 finding과 함께 중단됩니다. 안전한 기계적 수정은 자동 적용되고, 의도가 걸린 항목(예: API 시그니처 변경, 비즈니스 로직 결정)만 approve / fix / skip으로 사용자에게 에스컬레이션.

세 가지 실행 방식

명령이 세 가지라서 처음엔 헷갈릴 수 있는데, 각각의 사용 상황이 다릅니다.

• git push no-mistakes — 커밋된 브랜치를 게이트 remote로 보내는 명시적 Git 경로. 기존 git 워크플로에 자연스럽게 녹아듭니다.
• no-mistakes — TUI 모드. 변경 후 (커밋 전에도) 실행하면 브랜치 생성·커밋·push를 마법사가 안내합니다. -y 플래그로 자동 수행 가능.
• /no-mistakes — 에이전트 skill 명령. 내부적으로 비대화형 TOON(Token-Oriented Object Notation) 인터페이스로 no-mistakes axi를 구동합니다.

실전에서 얻는 이득

실제로 써보면 수동 git push origin 이나 직접 PR 본문 작성이 완전히 사라집니다. CI가 떨어질 때까지 기다렸다가 고치는 게 아니라, push 직전에 모든 게이트를 통과한 상태로 remote에 도달하니까요.

특히 CI가 느린 프로젝트에서는 효과가 큽니다. 로컬 worktree에서 AI가 5분 만에 잡아낼 lint/docs/test 실패를, 원격 CI에서는 30분 기다려야 했던 적이 있다면 — 그 30분이 진짜 git push no-mistakes 한 번으로 줄었습니다.

마치며

> "새로운 바퀴를 발명하는 건가요?" 라는 긱뉴스 댓글처럼, 처음엔 "git hook이랑 뭐가 다르지?" 싶을 수 있습니다.

차이는 명확합니다.

• git hook = "내가 깜빡했을 때를 대비한 일회용 가드"
• no-mistakes = "에이전트 검증을 필수 통과 단계로 만든 구조적 가드"

코딩 에이전트가 워크플로에 깊이 들어오는 2026년, 단순 lint가 아니라 에이전트 기반 풀 파이프라인 검증을 push 단계에 강제하는 건 자연스러운 진화입니다. MIT 라이선스라 부담 없이 프로젝트에 한 번 도입해 보세요.

• --

원본 글: no-mistakes - git push 할 때 실수를 방지하기 (긱뉴스 #31223)

원본 소스: github.com/kunchenguid/no-mistakes

---

📰 원본 출처 · https://news.hada.io/topic?id=31223 (#N=31223)

이 글은 GeekNews(긱뉴스)에 게제된 글을 기반으로 작성되었습니다. 원본의 라이선스와 저작권은 원작자에게 있습니다.