블로그로 돌아가기
Agentic Coding

MoAI-ADK v1.0.0 정식 릴리스 - Ralph Engine과 Rank System 추가

7.89분
MoAI-ADKRalph EngineRank SystemClaude CodeAgentic CodingRelease Notes

MoAI-ADK v1.0.0 정식 출시. 코드 품질 보증 Ralph Engine, 개발 추적 Rank System, 다국어 CLI 재설계, curl 한 줄 설치, GLM 4.7 쉬운 스위칭 기능이 추가되었다.

MoAI-ADK v1.0.0 정식 릴리스 - Ralph Engine과 Rank System 추가
MoAI-ADK가 2026년 1월 12일 버전 1.0.0에 도달하여 정식 릴리스되었다. 이번 릴리스는 Beta 단계에서 Production/Stable 상태로 전환되는 중요한 이정표다.
지능형 코드 품질 보증을 위한 Ralph Engine, 개발 진행 상황 추적을 위한 Rank System, 다국어 지원이 포함된 CLI 재설계가 핵심 변경사항이다.

핵심 하이라이트

1. Ralph Engine 도입

Ralph Engine은 LSP(Language Server Protocol) 및 AST-grep 통합을 통한 지능형 코드 품질 보증 시스템이다.
16개 이상 언어에 대한 실시간 진단을 제공하며, 구조적 패턴 매칭 및 보안 스캐닝을 수행한다.
주요 구성 요소:
  • LSP 통합 레이어: MoAI LSP Client를 통한 고수준 인터페이스
  • LSPServerManager: 서버 생명주기 자동 관리
  • LSP Protocol: JSON-RPC 2.0 구현
  • AST-grep 분석기: 20개 이상 프로그래밍 언어 지원
  • Loop Controller: 자율 피드백 루프 완료 감지 및 진행률 추적
지원 언어:
Python, TypeScript, JavaScript, Go, Rust, Java, C/C++, C#, Ruby, PHP, Kotlin, Swift, Elixir 등 16개 이상
보안 스캐닝:
심각도 레벨별 보안 규칙 스캐닝을 제공하여 코드 작성 단계에서 보안 취약점을 사전에 탐지한다.

2. Rank System 추가

개발 활동을 실시간으로 추적하는 대시보드 TUI가 추가되었다. Hook 기반 모니터링을 통해 개발 진행 상황을 시각화한다.
기능:
  • 실시간 진행 상황 추적
  • 개발 활동 통계 수집
  • 대시보드 TUI 인터페이스
  • 훅 기반 이벤트 모니터링
공개 서비스:
MoAI Rank 서비스가 함께 공개되었다. Claude Code 세션 데이터를 분석하여 자신의 랭킹과 에이전틱 코딩 통계를 확인할 수 있다.

3. CLI 대폭 재설계

사용자 경험이 크게 개선된 CLI가 도입되었다.
간소화된 init 플로우:
프로젝트 초기화 과정이 단순화되어 빠르게 시작할 수 있다.
다국어 지원:
영어, 한국어, 일본어, 중국어 4개 언어를 지원한다. 사용자 환경에 맞는 언어로 CLI 메시지가 표시된다.
명령어 별칭:
moai-worktree 명령어에 moai-wt 별칭이 추가되었다. 편의성을 위해 moai-adk 또는 moai 명령어 모두 사용할 수 있다.

4. curl 한 줄 설치

GitHub Pages 배포가 포함된 curl 설치 스크립트가 제공된다. 복잡한 설치 과정 없이 한 줄로 설치할 수 있다.
Bash
curl -fsSL https://moai-adk.github.io/MoAI-ADK/install.sh | sh

5. GLM 4.7 쉬운 스위칭

GLM 4.7과 Claude 간 스위칭이 간편해졌다. 프로젝트 폴더의 settings.local.json에 GLM 키 설정을 자동으로 추가하거나 삭제한다.
Bash
# GLM으로 전환
moai glm


# Claude로 전환
moai cc  # 또는 moai claude

Ralph Engine 상세

Ralph Engine은 SPEC-RALPH-001 사양에 따라 구현되었다. 코드 작성 중 실시간으로 품질 문제를 감지하고 피드백을 제공한다.

Loop Controller

자율 피드백 루프를 관리하는 Loop Controller가 추가되었다. 작업 완료를 자동으로 감지하고 진행률을 추적한다.
슬래시 커맨드:
  • /moai:loop: 자율 피드백 루프 시작
  • /moai:fix: 빠른 수정 작업 실행
  • /moai:cancel-loop: 실행 중인 루프 취소
상태 영속성:
LoopState 및 LoopStorage를 통해 작업 상태를 저장하고 복원한다. 세션 간 작업 연속성을 보장한다.

테스트 커버리지

Ralph Engine은 302개의 테스트로 검증되었다. 80% 이상의 코드 커버리지를 유지한다.

변경 사항 요약

추가됨

  • Ralph Engine 전체 구현 (SPEC-RALPH-001)
  • Rank System 대시보드 TUI
  • CLI 다국어 지원 (영어, 한국어, 일본어, 중국어)
  • curl 설치 스크립트
  • GLM 설정 자동 복사 기능
  • /moai:loop, /moai:fix, /moai:cancel-loop 커맨드

변경됨

  • CLI 명령어 표시를 moai 별칭 사용으로 표준화
  • 40개 모든 스킬을 CLAUDE.md 문서 표준으로 변환
  • 에이전트 생태계를 28개에서 20개로 통합
  • 스킬을 50개에서 47개로 통합
  • 개발 상태를 "4 - Beta"에서 "5 - Production/Stable"로 업그레이드

수정됨

  • settings.json의 MongoDB deny 패턴 파싱 오류
  • GitHub Pages URL 대소문자 구분 문제
  • 템플릿과 config 섹션 동기화 문제

문서

  • 9단계 마법사 및 품질 집중으로 README 개선
  • 한국어 마스터 템플릿과 모든 언어 README 동기화
  • 한국어 README에 Star History 차트 추가
  • 모든 README 파일에 공식 온라인 문서 링크 추가

인프라 개선

Multi-LLM 지원

GLM 설정 자동 복사가 포함된 Multi-LLM 지원이 추가되었다. 프로젝트별로 다른 LLM을 사용할 수 있다.

권한 설정 최적화

bypass/acceptEdits 모드를 위한 권한 설정이 최적화되었다. 더 세밀한 권한 제어가 가능하다.

설치 방법

curl 설치 (권장)

Bash
curl -fsSL https://moai-adk.github.io/MoAI-ADK/install.sh | sh

uv tool 설치

Bash
uv tool install moai-adk

설치 확인

Bash
moai --version
# 또는
moai-adk --version

업그레이드 가이드

기존 사용자는 다음 명령어로 업그레이드할 수 있다.
Bash
uv tool upgrade moai-adk
설정 파일 호환성은 유지된다. 기존 .moai/config/ 디렉토리 구조를 그대로 사용할 수 있다.

테스트 현황

MoAI-ADK v1.0.0은 9,800개 이상의 테스트와 80% 이상의 커버리지로 프로덕션 사용 준비가 완료되었다.
테스트 구성:
  • Ralph Engine: 302개 테스트
  • Rank System: 안정성 개선 및 테스트 수정 완료
  • CLI: 다국어 지원 테스트 통과
  • 기타 핵심 기능: 검증 완료

향후 계획

버전 1.0.0 릴리스 이후 개발 방향은 다음과 같다.
서비스 개발 집중:
MoAI Rank 서비스를 포함한 주변 생태계 개발에 집중한다.
강의 준비:
MoAI-ADK v1.0.0을 빠르게 배우고 싶은 사용자를 위한 강의를 준비 중이다.
버그 수정 및 안정화:
사용자 피드백을 바탕으로 안정성을 지속적으로 개선한다.

참고 자료