landmines의 개요
landmines는 Interfere가 만든 Oxlint 플러그인 모음으로, npm에 @interfere/landmines로 공개되어 있습니다. 테스트 규칙은 코드가 작동하지 않는데도 에이전트가 Vitest 스위트를 통과시키는 수법을 겨냥합니다. 의존성을 모듈 목이나 `vi.fn` 구현으로 바꾸기, 처리되지 않은 요청에 실패하지 않게 MSW를 시작하기, 고정 시간 기다리기, 이벤트를 기다리지 않고 spy 상태를 폴링하기, 재시도나 더 긴 타임아웃 추가하기입니다. 각 규칙의 메시지는 정직한 해결책을 알려 주므로, 규칙에 걸린 에이전트가 같은 루프 안에서 방향을 바로잡을 수 있습니다.
권장 설정은 스타일, 구조, 타입에 관한 더 주관적인 규칙 6개도 켭니다. 산문 주석 금지, 테스트를 대상 옆에 두기, 고정된 테스트 파일 이름, 명시적인 패키지 exports, 반환 타입 표기 금지입니다. 저장소는 2026년 10월 28일에 만들어졌고 별 690개, MIT 라이선스입니다. 0.1.0은 11월 17일, 0.1.1은 그다음 날 나왔습니다. Oxlint 1.81 이상과 Node 22.18 이상이 필요합니다.
landmines, 쓸 만한 가치가 있습니까?
CI를 초록색으로 만들라는 지시를 받은 코딩 에이전트는 종종 정확히 그것만 합니다. 테스트해야 할 모듈을 모킹하고, 경쟁 상태가 대개 풀릴 때까지 고정 대기를 넣거나, 불안정한 테스트를 재시도로 감쌉니다. 모두 대충 보는 리뷰는 통과합니다. landmines는 이를 lint 실패로 바꾸며, lint는 편집할 때마다 돌고 에이전트가 그 출력을 읽기 때문에 이것이 중요합니다.
설치할 이유는 5개의 테스트 규칙입니다. `no-test-doubles`는 관찰만 하는 spy는 허용하지만 대체된 동작은 거부하고, 실제 구현과 네트워크용 MSW로 이끕니다. 이어서 `strict-msw`가 목이 없는 모든 요청에서 MSW가 실패하게 만듭니다. `no-fixed-sleep`은 `act`, `waitFor`, `.then` 콜백 안의 대기도 잡아내고, `no-flake-masking`은 개별 테스트뿐 아니라 Vitest 설정의 `retry`, `testTimeout`, `hookTimeout`도 읽습니다. 저희가 변경 기록을 읽은 바로는 0.1.1에서 블록 본문을 가진 타이머 콜백 같은 쉬운 빈틈 여러 개가 막혔습니다.
오래된 코드베이스 도입은 잘 다듬어져 있습니다. 규칙 세 개는 파일별로 정확한 개수의 허용치를 받으며, 파일의 위반이 허용치보다 적어지면 이를 알리므로 목록은 줄어들기만 합니다.
주의할 점: 단언의 품질을 판단하는 규칙은 없어서, `true`를 확인하거나 함수가 호출됐는지만 확인하는 테스트는 그대로 통과합니다. 규칙은 Vitest와 MSW를 중심으로 작성되어 Jest, Mocha, Playwright Test 스위트에는 별 도움이 되지 않습니다. 권장 설정은 테스트 밖에서도 주관이 강합니다. 산문 주석과 반환 타입 표기 금지는 많은 팀의 관례와 부딪칠 것이므로 대부분은 테스트 플러그인만 등록할 것입니다. 게다가 프로젝트는 생긴 지 3주, 0.1.x 단계이며 한 회사가 만듭니다.
결론: 이미 Oxlint와 Vitest를 쓰는 TypeScript 팀에게 테스트 플러그인은 에이전트가 거짓말하는 가장 값싼 방법들을 막는 작은 의존성이며, 단언을 계속 읽는 사람과 잘 어울립니다.
제 역할을 하는 곳
직원 20명 규모 SaaS 기업의 플랫폼 엔지니어
테스트 대상 코드를 모킹해 CI를 통과하는 에이전트 풀 리퀘스트 막기
`.oxlintrc.json`에 `landmines-testing`만 등록하고 에이전트 루프와 CI에서 Oxlint를 돌립니다. `no-test-doubles`가 변경을 실패시키고, 메시지가 에이전트를 실제 구현과 MSW로 안내합니다.
불안정한 오래된 Vitest 스위트를 가진 테크 리드
수백 개 테스트를 한꺼번에 고치지 않고 규칙 도입하기
`no-flake-masking`과 `no-fixed-sleep`에 현재 파일별 개수를 적은 `allow` 블록을 설정합니다. 새 파일은 깨끗해야 하고, 오래된 테스트를 고칠수록 각 허용치는 줄어들어야 합니다.
도입 전 확인할 점
- 설정
- `bun add -d oxlint @interfere/landmines`(또는 npm 대응 명령) 후 `.oxlintrc.json`에서 `./node_modules/@interfere/landmines/configs/recommended.json`을 extends하거나 개별 플러그인과 규칙을 나열합니다. Oxlint 1.81 이상과 Node 22.18 이상이 필요합니다.
- 연동
- Oxlint JS 플러그인입니다. 규칙은 Vitest API와 설정, MSW 2와 3, React Testing Library 콜백을 이해합니다. README는 타입 수준 규칙을 위해 anti-slop과 함께 쓰기를 권합니다.
- 데이터와 개인정보
- 로컬에서 linter로 실행되며, 네트워크 접근이나 텔레메트리에 대한 설명은 없습니다. npm에 출처 증명과 함께 공개되었습니다. MIT 라이선스입니다.
- 대규모 사용 시 비용
- 무료입니다. 비용은 엔지니어링 시간으로, 목 대신 실제 구현과 MSW 핸들러를 쓰는 것은 그것이 대신하는 지름길보다 시간이 더 듭니다.
- 제한
- 0.1.1의 규칙은 10개이며 권장 설정에서 모두 오류로 처리됩니다. 단언의 강도는 검사하지 않습니다. 스타일과 타입 규칙은 주관이 강해 기존 관례와 충돌할 수 있습니다.
좋은 점
- 모킹된 대상, 고정 대기, 재시도, 늘린 타임아웃을 잡아냄
- 오류 메시지가 에이전트에게 대신 할 일을 알려 줌
- 기존 코드용으로 줄어들기만 하는 파일별 허용치
- 플러그 인을 하나씩 등록 가능
아쉬운 점
- 약하거나 빈 단언은 감지하지 못함
- Vitest와 MSW용이라 다른 러너에는 효과가 적음
- 권장 설정이 주석과 반환 타입을 금지함
- 한 회사가 만든 0.1.x 단계의 신생 프로젝트
추천 대상
Oxlint와 Vitest를 쓰면서 코딩 에이전트에게 테스트 작성이나 수정을 맡기고, 흔한 지름길을 자동으로 막고 싶 은 TypeScript 팀.
landmines 대안
landmines: 자주 묻는 질문
- landmines, 쓸 만한 가치가 있습니까?
- landmines는 코딩 에이전트의 테스트 꼼수를 lint 오류 뒤로 막아 두며, 싸고 유용하지만 테스트가 어떻게 기다리고 흉내 내는지를 감시할 뿐 무언가를 실제로 검사하는지는 보지 않습니다. 평점은 5점 만점에 3.7점입니다.
- landmines의 가격은 얼마입니까?
- 무료 오픈 소스(MIT)입니다.
- landmines의 단점은 무엇입니까?
- 약하거나 빈 단언은 감지하지 못함; Vitest와 MSW용이라 다른 러너에는 효과가 적음; 권장 설정이 주석과 반환 타입을 금지함; 한 회사가 만든 0.1.x 단계의 신생 프로젝트.
- landmines에 적합한 사람은 누구입니까?
- Oxlint와 Vitest를 쓰면서 코딩 에이전트에게 테스트 작성이나 수정을 맡기고, 흔한 지름길을 자동으로 막고 싶은 TypeScript 팀.
- 팀이나 프로덕션 환경에서 landmines의 비용은 얼마입니까?
- 무료입니다. 비용은 엔지니어링 시간으로, 목 대신 실제 구현과 MSW 핸들러를 쓰는 것은 그것이 대신하는 지름길보다 시간이 더 듭니다.
- landmines에 회사 데이터를 맡겨도 안전합니까?
- 로컬에서 linter로 실행되며, 네트워크 접근이나 텔레메트리에 대한 설명은 없습니다. npm에 출처 증명과 함께 공개되었습니다. MIT 라이선스입니다.
- landmines의 가장 좋은 대안은 무엇입니까?
- 저희가 리뷰한 것 중 가장 가까운 대안은 Superpowers, ast-grep 및 CC Safety Net입니다.
답변 확인일: 2026년 11월 20일.