TL;DR

no-mistakes는 로컬에 게이트 원격을 설치해 git push를 가로채고 일회성 작업트리에서 review·test·docs·lint 등의 검증 파이프라인을 실행하는 도구이다. 파이프라인은 기계적으로 안전한 수정은 자동으로 적용하고 의도에 영향을 줄 수 있는 항목은 사용자 승인으로 에스컬레이션하며 모든 체크가 통과될 때만 구성된 원격에 브랜치를 포워드하고 PR을 자동으로 연다. TUI와 /no-mistakes 에이전트 스킬을 통해 수동 승인과 무인 에이전트 주도 흐름 모두를 지원하며 e2e 녹화 기능은 실제 에이전트 CLI와 API를 사용하므로 실행 시 비용이 발생할 수 있다.

주요 기능

• 로컬 git 푸시를 프록시로 가로채어 별도 게이트 원격으로 전달한다
• 일회성 작업트리에서 review·test·docs·lint 등 검증 파이프라인을 실행한다
• 안전한 기계적 수정을 자동으로 적용하고 의도 변경이 가능한 항목은 사용자 승인으로 분리한다
• 모든 체크가 통과되어야만 구성된 푸시 대상에 브랜치를 전달하고 PR을 연다
• TUI와 /no-mistakes 에이전트 스킬을 통해 수동 승인과 무인 실행 모두를 지원한다

어떻게 동작하는가

로컬에 'no-mistakes'라는 가상의 원격(remote) 게이트를 설치해 사용자가 해당 게이트로 푸시하면 일회성 작업트리를 생성한다. 생성된 작업트리에서 리뷰, 테스트, 문서 검사, 린트 등 정의된 검증 스텝을 순차 실행하고, 기계적으로 안전한 수정은 자동 적용하며 의도에 영향을 줄 수 있는 변경은 사용자 승인으로 에스컬레이션한다. 모든 체크가 통과되어야만 원격 푸시가 실제 대상에 포워드되며 그 시점에 깨끗한 PR이 자동으로 열린다.

해결 문제

개발자가 로컬에서 발생시키는 미완성 브랜치나 자동화되지 않은 수정으로 인해 원격에 불완전한 PR이 생기는 문제를 줄인다. no-mistakes는 푸시 시점에 검증과 자동 수정을 적용해 수동으로 PR을 만들고 CI를 기다리는 수고를 줄이며, 의도 변경이 우려되는 수정은 사용자 개입을 요구해 안전성과 자동화의 균형을 맞춘다.

차별점

• 비파괴적 워크플로를 위해 일회성 작업트리를 사용해 기존 작업 디렉터리를 건드리지 않고 검증을 수행한다
• 에이전트 네이티브 스킬(/no-mistakes)을 제공해 코딩 에이전트가 수행한 작업을 그대로 게이트할 수 있다
• 안전한 수정은 자동 적용하고 의도 변경 가능성이 있는 항목은 명시적 승인 흐름으로 분리해 자동화와 휴먼 컨트롤을 동시에 제공한다
• 푸시를 차단하는 대신 로컬에서 비동기적으로 검사·수정·리뷰를 진행하므로 개발자 작업을 중단시키지 않는 Non-blocking 설계를 채택했다

사용 사례

• 포크 기반 기여에서 origin을 부모 저장소로 유지한 채 자신의 fork URL로 no-mistakes를 초기화하여 기여 워크플로를 깔끔하게 자동화할 때
• 코딩 에이전트가 생성한 변경사항을 에이전트 스킬로 게이트해 자동 수정과 사람 승인 플로우를 적용할 때
• 로컬에서 린트·테스트·문서 검사를 자동으로 실행해 수작업으로 PR 바디를 작성하고 CI를 모니터링하는 반복을 줄일 때
• 반복적인 스타일·포맷·경미한 버그 패턴을 자동으로 정리해 리뷰어 부담을 낮출 때

시작하기

설치 권장 방법은 README 상단의 단일 셸 명령을 실행하는 것으로, curl -fsSL https://raw.githubusercontent.com/kunchenguid/no-mistakes/main/docs/install.sh | sh 로 설치한다. 설치 후 no-mistakes init 명령으로 게이트를 초기화하고 변경 브랜치를 git push no-mistakes <branch>로 푸시하거나 no-mistakes TUI를 실행해 워크플로를 시작한다. 자세한 초기화·포크 설정·에이전트 연동 정보는 프로젝트 문서 페이지에서 확인할 수 있다.

요구사항

• Go 툴체인과 Make가 설치된 개발 환경이 필요하며 여러 플랫폼(macOS, Linux, Windows)을 지원한다
• 에이전트 연동 및 e2e 녹화를 실행하려면 해당 에이전트의 CLI와 API 키가 필요하며 e2e-record는 실제 API 사용으로 비용이 발생할 수 있다
• 데모 재생성은 vhs와 ffmpeg를 요구하며 문서 빌드에는 프로젝트에 정의된 Node/아키텍처 도구(예: Astro)가 필요할 수 있다

이미지 분석