asklokesh/loki-mode

What it solves

Loki Mode는 사양(PRD, GitHub issue 또는 OpenAPI spec 등)을 완전히 기능하는 검증된 소프트웨어 프로젝트로 변환하는 자율 코딩 에이전트입니다. 이는 AI 에이전트가 작업이 완료되었다고 주장하지만 코드가 깨져 있거나 누락되어 있는 "할루시네이션 완성(hallucinated completion)" 문제를 해결합니다. Loki는 자동화된 테스트 및 빌드 체크를 포함한 결정론적 검증 게이트를 통과할 때만 작업을 "완료"로 표시합니다.

How it works

Loki는 RARV-C 사이클(Reason - Act - Reflect - Verify - Close)을 사용하여 작동합니다. 요청의 복잡성을 분류하고 8개 도메인에 걸쳐 전문화된 에이전트 역할 팀을 구성하여 빌드를 실행합니다.

주요 메커니즘은 다음과 같습니다:

• Quality Gates: 완료 전에 반드시 통과해야 하는 8가지 결정론적 체크(빌드, 테스트, 정적 분석, 시크릿 스캔 등)입니다.
• Evidence Receipts: 사실(git diffs, exit codes)과 AI 평가에 대한 변조 불가능한 기록으로, 사용자가 빌드의 성공 여부를 독립적으로 검증할 수 있게 합니다.
• Provider Agnostic: 실제 편집을 수행하기 위해 다른 코딩 CLI(Claude Code, Aider 또는 Cline 등)를 오케스트레이션합니다.
• Living Specs: 사양의 드리프트를 감지하기 위해 사양을 잠금 처리할 수 있으며, 빌드 전에 사양의 공백을 찾기 위해 "Devil's-Advocate" 심문(loki grill)을 실행할 수 있습니다.

Who it’s for

Loki는 모든 변경 사항을 수동으로 검증할 필요 없이 AI 에이전트로부터 프로덕션 수준의 코드를 필요로 하는 개발자와 팀을 위해 설계되었습니다. 특히 풀스택 애플리케이션을 구축하거나, 레거시 시스템을 현대화하거나, 높은 신뢰도와 감사 준비가 된 개발 워크플로우가 필요한 경우에 유용합니다.

Highlights

• Verified Completion: git diff가 비어 있거나 테스트가 실패하면 "완료"를 거부합니다.
• Evidence Receipts: 작업이 완료되었음을 증명하기 위해 기계 판독 가능한 proof.json 및 HTML 보고서를 생성합니다.
• Full-stack Output: 소스 코드, 테스트, healthchecks가 포함된 Docker Compose 스택 및 CI/CD 파이프라인을 생성합니다.
• Cross-project Memory: 벡터 검색을 사용하여 한 프로젝트에서 학습한 지식을 다음 프로젝트에 적용합니다.
• Standalone Verification: loki verify 명령어를 통해 어떤 브랜치나 PR diff를 품질 게이트에 대해 검사할 수 있습니다.
• MCP Server: 에이전트 기능 강화를 위해 34개의 도구를 포함한 Model Context Protocol 서버를 포함합니다.