loki-mode

Loki Mode는 AI 에이전트의 완료 주장을 액면 그대로 받아들이지 않고 검증하도록 설계된 자율적이고 로컬에서 실행되는 소프트웨어 팩토리입니다. 핵심 워크플로는 제품 요구사항 문서, GitHub 이슈, OpenAPI 명세 또는 한 줄짜리 짧은 작업 브리프를 입력으로 받습니다. 입력이 주어지면 시스템은 먼저 요청된 작업에 대한 공식 납품 계약(수용 기준)을 도출합니다. 계약을 안정적으로 도출할 수 없는 경우, 무작위로 추측하지 않고 단 하나의 명확화 질문을 던지고 중단합니다. 작업은 구조화된 Reason, Act, Reflect, Verify 루프를 통해 계약에 따라 구축되며, 구축 과정에서 입증된 것과 아직 입증되지 않은 것을 명시적으로 문서화한 Evidence Receipt로 마무리됩니다. 핵심 구성 요소인 loki-seal은 Claude Code Stop 훅으로 작동합니다. 연결된 AI 에이전트가 작업을 완료로 표시하려고 할 때마다 이 훅은 대상 저장소의 실제 테스트 스위트를 실행합니다. 새로운 테스트 실패가 감지되거나 기존 테스트 또는 CI 구성이 삭제, 건너뛰기 또는 의도적으로 약화된 경우 완료를 차단합니다. 이 훅은 모든 중지 시도에 대해 명확한 Seal 판정을 출력합니다. 즉, 공식 영수증과 함께 PASS 결과를 내거나, 거부 사유를 문서화하여 차단합니다. 이 시스템은 Claude Code를 완전히 지원하고 Cline, OpenAI Codex CLI, Aider, OpenCode와도 호환되는 등 주요 AI 코딩 도구와 통합됩니다. 사용자의 기존 LLM API 키를 사용하여 전적으로 사용자의 로컬 머신에서 실행되며, 필수 호스팅 서비스 요구사항이 없습니다. 빌드가 완료로 표시되기 전에 내장된 리뷰 위원회가 구성 가능한 풀에서 전문 리뷰어를 선택하며, 리뷰어 선택은 포커스 키워드 매칭으로 점수가 매겨집니다. 번들로 제공되는 MCP 서버는 stdio를 통해 36개의 도구를 노출하여 에이전트 기능을 확장합니다. 설치 옵션에는 전역 npm 또는 bun 패키지 설치가 포함되며, 초보 사용자를 위한 안내식 퀵스타트 흐름이 제공됩니다. 사용자는 로컬 PRD 파일이나 연결된 GitHub 저장소 이슈에서 직접 빌드를 트리거할 수 있습니다. API 액세스 없이 Evidence Receipt 흐름을 시연할 수 있는 제로 키 리플레이 투어가 제공되며, 읽기 전용 브라운필드 모드는 기존 저장소와 함께 사용할 수 있도록 지원합니다. 환경 변수 구성으로 옵트인 미리보기 Loki 10 엔진을 사용할 수 있습니다. 추가 문서에서는 대체 설치 방법(Bun, npm, Homebrew, Docker), CLI 레퍼런스, 구성 옵션, 시스템 아키텍처, 품질 게이트, 메모리 기능, 대시보드 기능, 유사 개발 도구와의 비교를 다룹니다. 이 프로젝트는 BUSL-1.1 라이선스로 npm 패키지로 게시됩니다.