AI 코딩 에이전트를 위한
운영 레이어 (operating layer)
기억 · 인수인계 · 검증 · 감사 · 보안 가드를 .harness/ 에 영속화 — 코드를 대신 쓰지 않고, 어떤 에이전트 위에도 얹는 공통 운영 계층. 0 의존성 · offline-first · MCP 89 도구 · 온톨로지 그래프.
쉽게 말하면 🙂
개발을 몰라도 괜찮아요. AI에게 코딩을 시키면 똑똑하지만, 가끔 하던 걸 깜빡하거나 "다 했어요"라고만 하고 실제로는 안 끝낸 경우가 있어요. leerness는 그 AI 옆에서 일을 꼼꼼히 챙겨주는 비서예요 — 직접 코딩하진 않고, AI가 실수 없이 일하도록 돕습니다.
한 줄 요약: AI가 만든 결과를 믿을 수 있게, 기억·확인·안전을 자동으로 챙겨주는 도구.
leerness 란? (개발자용)
AI 코딩 에이전트(Claude Code, Cursor, Codex 등)는 코드를 잘 쓰지만 기억하지 못하고, 증거 없이 "완료"를 선언합니다. leerness 는 그 위에 얹는 운영 레이어 — 프로젝트 상태를 .harness/ 파일로 영속화하고 CLI · MCP 도구로 노출합니다. leerness 자체는 애플리케이션 코드를 쓰지 않습니다 — 기본 동작은 LLM 호출·코드 실행 없음, 옵트인 오케스트레이션/테스트 실행만 예외.
🕸️ 온톨로지 그래프 NEW
leerness graph --html — 프로젝트 하네스(작업·계획·결정·교훈·룰·스킬·기능)를 하나의 인터랙티브 그래프(self-contained leerness.html)로 표면화합니다. 노드를 클릭하면 내용이 바로 열리고 — 검색·타입 필터·자동 맞춤(fit)·PNG 내보내기까지. 0 의존성 vanilla JS라 파일 하나로 어떤 브라우저에서나 열립니다.
↑ 샘플 프로젝트의 실제 그래프 — 노드 드래그 · 스크롤 줌 · 클릭하면 내용 패널. 전체 화면으로 열기 → · LEERNESS_AUTO_GRAPH=1 로 handoff 마다 자동 갱신.
최근 릴리스
CHANGELOG 자동 동기화 · 총 666개 중 중요 업데이트 209건
안정화 하이라이트
데이터 무결성 · 보안 · 호환성 — 핵심 안정화 업데이트
자주 묻는 질문 (FAQ)
leerness가 뭐예요?
AI 코딩 에이전트(Claude Code, Cursor, Codex 등) 위에 얹는 운영 레이어입니다. 작업 기억·완료 검증·보안 가드·인수인계를 .harness/ 폴더의 일반 파일로 영속화해서, 어떤 에이전트가 와도 일이 이어지고 결과를 믿을 수 있게 만듭니다.
leerness가 코드를 대신 써주나요?
아니요. 애플리케이션 코드는 에이전트가 쓰고, leerness는 그 작업이 기억되고 검증되고 안전하게 인계되도록 챙깁니다. 기본 동작은 LLM 호출·코드 실행이 없으며, 옵트인 기능(에이전트 오케스트레이션, verify-claim --run-tests의 프로젝트 테스트 실행)을 켠 경우에만 설정한 도구를 호출합니다.
어떻게 시작하나요?
npm i -g leerness 로 설치하고, 프로젝트에서 leerness init . 을 실행한 뒤, 매 세션 시작 시 leerness handoff . 로 컨텍스트를 로드하면 됩니다. Node.js 18 이상이면 되고 런타임 의존성은 0개입니다.
AI가 "다 했어요"라고 거짓말하면요?
leerness verify-claim 이 완료 주장을 실제 파일 존재·테스트 실행 결과·git 변경과 대조해서 증거 없는 완료를 차단합니다. leerness lazy detect 는 증거 없는 done, 빈 인수인계, 테스트 미실행 신호를 자동 감지합니다.
어떤 에이전트와 함께 쓸 수 있나요?
CLI를 실행하거나 MCP를 쓸 수 있는 모든 에이전트와 호환됩니다 — Claude Code, Cursor, Codex CLI, GitHub Copilot, Goose 등. MCP 서버(leerness mcp serve)가 89개 도구를 노출합니다.
내 데이터가 외부로 전송되나요?
아니요. 모든 상태는 로컬 일반 파일(.harness/)에 저장되고, 도구 자체가 offline-first에 런타임 의존성 0개, 설치 스크립트 0개입니다.