AI 코딩 에이전트를 위한
운영 레이어 (operating layer)

기억 · 인수인계 · 검증 · 감사 · 보안 가드를 .harness/ 에 영속화 — 코드를 대신 쓰지 않고, 어떤 에이전트 위에도 얹는 공통 운영 계층. 0 의존성 · offline-first · MCP 85 도구.

$ npm i -g leerness
v1.10.0
최신 버전
451
릴리스
0
의존성
85
MCP 도구

쉽게 말하면 🙂

개발을 몰라도 괜찮아요. AI에게 코딩을 시키면 똑똑하지만, 가끔 하던 걸 깜빡하거나 "다 했어요"라고만 하고 실제로는 안 끝낸 경우가 있어요. leerness는 그 AI 옆에서 일을 꼼꼼히 챙겨주는 비서예요 — 직접 코딩하진 않고, AI가 실수 없이 일하도록 돕습니다.

🧠
하던 일을 기억해요
대화가 끊기거나 다음 날 다시 시켜도, 어디까지 했는지 잊지 않고 이어가요.
"다 했어요"를 확인해요
정말 끝났는지 증거(테스트·결과)로 점검해서, 안 끝난 걸 끝났다고 말하지 못하게 해요.
🛡️
사고를 미리 막아요
비밀번호 유출, 한글 깨짐 같은 흔한 실수를 일을 마치기 전에 자동으로 잡아줘요.
🤝
다음 사람에게 넘겨줘요
다른 AI 도구나 동료가 이어받을 때, 무엇을 왜 했는지 정리해 깔끔하게 인계해요.

한 줄 요약: AI가 만든 결과를 믿을 수 있게, 기억·확인·안전을 자동으로 챙겨주는 도구.

leerness 란? (개발자용)

AI 코딩 에이전트(Claude Code, Cursor, Codex 등)는 코드를 잘 쓰지만 기억하지 못하고, 증거 없이 "완료"를 선언합니다. leerness 는 그 위에 얹는 운영 레이어 — 프로젝트 상태를 .harness/ 파일로 영속화하고 CLI · MCP 도구로 노출합니다. leerness 자체는 LLM 을 호출하거나 코드를 실행하지 않습니다.

🤝 핸드오프 — 세션 시작 시 컨텍스트 자동 로드, 종료 시 인수인계 생성
progress-tracker · decisions · lessons · rules 를 읽어 다음 에이전트가 이어받음
🔍 자기검증 — 거짓 완료/게으름 감지 + 증거 기반 게이트
done 인데 evidence 없음 · 테스트 미실행 · 추적 안 된 TODO 자동 점검
🔐 보안·인코딩 — 시크릿 스캔 + 한글 UTF-8/BOM/CRLF 검사
하드코딩 시크릿·gitignore 정합·셸 스크립트 인코딩 위험 자동 탐지

최근 릴리스

CHANGELOG 자동 동기화 · 총 451개 중 중요 업데이트 107건

v1.10.0 수정 2026-06-08
🛡️ [안정화/Stable] 1.10 안정 minor (배포 정책 첫 minor 릴리스)
️ 안정화(Stable) minor — patch 누적(1.9.446~449)을 검증·통합해 npm 에 안정 버전으로 공개.
v1.9.449 리팩터 2026-06-08
plan drop: progress-tracker T- 행 미생성 (12th 외부평가 Sonnet P3, UR-0143)
🐛 plan↔progress 역할 분리: scope 드랍이 phantom task 를 만들던 문제.
v1.9.448 수정 2026-06-08
export/prompt = adapter 별칭 (GPT-5.5 전략리뷰 §6.6/7.3, UR-0154)
GPT-5.5 권고 표면명 정합: `leerness export/prompt --target <agent>`.
v1.9.447 수정 2026-06-08
plan progress 읽기전용 요약 명확화 (12th 외부평가 Codex P3, UR-0145)
🐛 명령명-동작 불일치 해소: `plan progress` 가 인자를 silent ignore 하던 문제.
v1.9.446 수정 2026-06-08
npm 배포 minor-gate (R-0011/UR-0160)
📦 배포 정책 도구화: npm 배포는 minor(x.x) 변동 시에만 — patch(x.x.x) 는 자동 스킵.
v1.9.445 수정 2026-06-08
add-family positional path 일관화 (UR-0151, UR-0141 후속)
🐛 데이터 오염 일관화: `decision/lesson/rule add` 도 positional path 인식 (task 와 동일).

전체 패치노트 →

안정화 하이라이트

데이터 무결성 · 보안 · 호환성 — 핵심 안정화 업데이트

v1.9.440 보안 2026-06-08
🛡️ [안정화/Stable] 시크릿 스캐너 prefix 패턴 placeholder 가드 (12th 외부평가 Opus P2, UR-0140)
v1.9.436 보안 2026-06-08
시크릿 스캐너 all-X/0 placeholder FP 차단 (11th 외부평가 Opus P3, UR-0139)
v1.9.433 보안 2026-06-08
11번째 외부평가: contract verify backtick-bullet 강선언 FN 수정 (UR-0136~0139)
v1.9.431 보안 2026-06-08
health exit code 정책: 보안 CRITICAL CI 게이트 (10th 외부평가 UR-0130)
v1.9.426 데이터무결성 2026-06-07
10번째 외부평가: 모듈화 회귀(health) 수정 + contract/rule 일관성 (UR-0128~0131)