코딩 에이전트가 만든 페이지나 설명문은 기능이 맞아도 어딘가 비슷해 보일 때가 있다. 근거 없는 성과 수치, 내용보다 큰 장식, 코드 한 줄을 다시 읽어 주는 주석이 쌓이기 때문이다. anti-slop은 이런 출력을 검토하는 규칙 묶음이다. 새 모델이나 독립 실행 프로그램이 아니라, 이미 쓰는 에이전트가 읽고 적용하는 문서다.
anti-slop 설치 방법과 적용 확인
먼저 사용 중인 코딩 에이전트의 프로젝트 폴더에서 터미널을 연다. 터미널은 명령을 입력해 프로그램을 실행하는 창이다. 설치 도구에는 Node.js 18 이상이 필요하다. Node.js는 자바스크립트 프로그램을 실행하며, 함께 제공되는 npx가 설치 도구를 불러온다. node -v로 버전을 확인한다. 명령을 찾지 못하면 Node.js 공식 사이트에서 지원 버전을 설치하고 터미널을 다시 연다. Windows, macOS, Linux에서 같은 설치 명령을 사용한다.
npx antislop-ai화살표 키로 이동하고 Space로 선택한 뒤 Enter로 확정한다. 기본 규칙인 antislop은 항상 포함된다. 첫 시도에는 주석 정리용 antislop-code를 추가하고, 설치 위치는 This project, 대상은 자신이 쓰는 에이전트로 고른다. 마지막 설치 확인에 동의하면 해당 프로젝트의 규칙 폴더와 안내 문서를 만든다. Everywhere는 홈 폴더에 설치해 다른 프로젝트에도 영향을 주므로, 한 프로젝트만 시험할 때는 선택하지 않는다.
Claude Code를 고르면 .claude/skills/antislop/SKILL.md와 선택한 추가 규칙 폴더를 만든다. SKILL.md는 에이전트가 작업 절차를 읽는 파일이며, 파일을 담은 폴더를 스킬이라고 부른다. 프로젝트의 CLAUDE.md에는 어떤 작업에서 어떤 규칙을 읽을지 가리키는 안내가 들어간다. 파일 존재를 확인한 뒤 새 에이전트 대화를 열고, “설치한 antislop의 R-31과 antislop-code의 수정 범위를 파일에서 읽어 설명해 줘”라고 요청한다. 답변이 실제 경로와 규칙을 짚는지 확인해야 한다.
Claude Code에서 플러그인, 즉 에이전트가 관리하는 확장 묶음으로 쓰려면 공식 문서의 다음 대화창 명령도 지원한다. 설치 도구 방식과 플러그인 방식은 둘 중 하나를 선택한다.
/plugin marketplace add https://github.com/miqdadbadjuber/anti-slop
/plugin install antislop@anti-slop여기서 실행한 설치 확인은 버전 3.2.20의 공식 설치 코드가 사용하는 복사·안내 생성 함수를 격리 폴더에서 호출한 것이다. 기본 규칙과 주석 규칙 두 개, CLAUDE.md 생성을 확인했다. 대화형 npx 화면을 끝까지 조작한 결과와는 구분한다. 실제 사용 시험은 아래처럼 Hermes에 같은 규칙 파일을 명시적으로 읽힌 방식으로 진행했다.
주석을 줄일 때 무엇을 남겨야 할까
anti-slop은 기본 규칙과 다섯 추가 스킬로 구성된다. antislop-ui는 화면 구성, antislop-copywriting은 제목과 문구, antislop-human은 대비·키보드·초점 같은 접근성, antislop-layoutmobile은 화면 폭에 따른 배치, antislop-code는 코드 주석을 다룬다. 필요한 작업에 맞춰 읽을 범위를 나누므로, 주석을 정리하려고 모든 화면 디자인 규칙을 적용할 필요는 없다.
주석 규칙은 코드가 이미 말하는 것을 다시 설명하는 문장을 지우되, 코드만으로 알 수 없는 이유와 제약을 남기도록 한다. 변수에 USD가 들어 있는데 “통화는 USD”라고 덧붙이면 같은 정보를 두 번 읽게 된다. 반면 금액의 단위, 입력의 허용 범위, 반올림 방식은 함수 이름만 보고 알 수 없다. 보안·동시 실행·외부 서비스의 제한·법적 고지처럼 변경 판단에 필요한 설명도 보존 대상이다.
아래는 저장소 작성자가 공개한 예시의 상수 부분이다. 통화·세율·재시도 값은 그대로 두고, 반복 설명 대신 주문 처리와 청구서 계산이라는 문맥을 남기는 차이를 보여 준다. 이 화면은 작성자의 예시이며, 다음 절의 실행 시험과는 별개다.
작은 Python 파일에서 실제로 바뀐 것
실제 시험에는 원화 금액에 10%를 더하고 Python의 round로 반올림하는 짧은 파일을 사용했다. Python은 이 파일을 실행하는 언어다. 설치 도구를 실행하는 Node.js와는 역할이 다르다. 이 작업에는 이미 실행 가능한 Python 파일과, 에이전트가 읽을 규칙 두 개가 필요했다.
Hermes에 기본 규칙과 antislop-code/SKILL.md를 사용자 제공 문서로 읽힌 뒤, after 방식으로 검사하고 불필요한 주석 삭제만 승인했다. 에이전트는 장식적인 대문자 제목, 상수 이름 반복, 함수 이름 반복, 반환문 설명을 네 개의 지적 사항으로 기록하고 제거했다. “입력은 0 이상의 원화 금액이며 반올림은 Python round를 따른다”는 원문 주석은 그대로 남겼다.
변경 전후에 python3 example.py를 실행했고 모두 종료 코드 0이었다. 종료 코드 0은 프로그램이 정상 종료했다는 뜻이다. 파일에 있던 assert total(10000) == 11000, 즉 10,000원의 계산 결과가 11,000원인지 확인하는 검사도 통과했다. 실행 구문 구조와 주석을 제외한 코드 토큰, 즉 프로그램을 이루는 기호·이름을 비교해 같음을 확인했다. 삭제한 네 주석을 제외한 나머지 줄도 보존했다.
이 결과는 규칙 파일을 읽은 Hermes가 작은 예제에서 승인 범위를 지켰다는 사례다. Hermes의 설치 스킬 자동 탐색이나 Claude Code 인증을 시험한 결과로 넓혀 해석하지 않는다. 한 번의 주석 정리로 화면 디자인의 개선 폭, 일반적인 정확도, 처리 비용을 추정할 수도 없다. 실행 기록의 전체 세션 시간은 1분 22초였으며, 이는 규칙 읽기와 검사·보고서 작성까지 포함한 시간이다.
새로 만들 때와 이미 만든 뒤의 검토는 다르다
during은 만드는 동안 규칙을 적용하는 방식이고, after는 이미 있는 결과를 먼저 검사하는 방식이다. 기본값에서는 새 대화마다 어느 방식을 쓸지 묻는다. 현재 대화에서 방식을 명시하면 저장된 선호보다 우선한다. 주석 정리를 처음 시험할 때는 “after로 검사하고 보고서만 작성해 줘. 아직 수정하지 마”처럼 범위를 정하는 편이 변경 내용을 살피기 쉽다.
after에서는 에이전트가 anti-slop/audit-001-YYYY-MM-DD.md처럼 번호가 붙은 보고서를 만들고, 규칙 번호와 이유를 적는다. 사람이 수정할 지적 번호를 승인한 뒤에만 해당 항목을 고치고 후속 보고를 남긴다. 설치했다는 사실이나 검토를 부탁했다는 말은 전체 파일의 재작성을 허용하지 않는다. 특히 주석 스킬은 실행 코드, 이름, 가져오기, 들여쓰기, 공백, 제어 흐름을 바꾸지 않는 범위를 명시한다.
화면을 만들 때는 삭제 규칙만으로 원하는 디자인이 정해지지 않는다. DESIGN.md는 브랜드의 색·글꼴·배치 방향을 적는 문서이고, anti-slop은 그 방향 안에서 목적 없는 장식과 근거 없는 문구를 걸러 내는 역할이다. 둘은 같은 일을 하지 않는다. 보기 좋은 카드도 정보를 묶는 이유가 있으면 남길 수 있다. 임의로 모든 색상이나 효과를 금지하면 해당 제품의 성격까지 지우게 된다.
업데이트와 제거도 설치 범위부터 확인한다
설치 도구로 복사한 규칙은 자동 업데이트되지 않는다. npx antislop-ai --update는 현재 프로젝트와 홈 폴더에서 찾은 설치본을 모두 갱신하며, 선택한 스킬 구성은 유지한다. 한 프로젝트만 바꿀 생각이라면 전역 설치본도 있는지 먼저 확인한다. 플러그인으로 설치했다면 그 에이전트의 플러그인 갱신 명령을 사용한다. 어느 쪽이든 갱신 후에는 새 대화를 시작한다.
제거할 때는 대상 에이전트 폴더의 antislop과 선택한 antislop-* 폴더만 지우고, 프로젝트 안내 파일에서 <!-- antislop:start -->와 <!-- antislop:end --> 사이의 안내 블록을 제거한다. 다른 프로젝트 지침까지 지우지 않는다. 반복 문구나 불필요한 주석을 지속적으로 검토해야 할 때는 이런 규칙 묶음이 유용하다. 한 문장만 다듬으면 되는 작업에는 파일 설치 없이 원하는 수정 범위를 직접 요청하는 것으로 충분하다.
출처: anti-slop README · 설치·사용 가이드 · 주석 규칙