Skip to main content

프로젝트 상태

업데이트 2026-08-13 2분 분량 GitHub에서 수정 ↗

moai status 명령어로 현재 프로젝트의 초기화 상태, SPEC 개수, 설정 파일 현황을 한눈에 확인합니다. 플래그가 없는 읽기 전용 명령어입니다.

하네스(harness) 가 정상 동작하려면 .moai/.claude/ 디렉터리가 모두 초기화돼 있어야 하는데, 이 조건이 깨져 있으면 다른 moai 커맨드가 애매한 오류를 내기 때문에, 이 커맨드는 가장 먼저 실행해 볼 한눈짚기 용도로 쓰입니다. 따라서 SPEC 을 새로 시작하거나 디버깅 세션에 들어가기 전 상태를 확인하는 기본 진입점입니다.

사용법

bash
moai status

플래그 없이 실행하면 프로젝트 상태를 박스 형태로 출력합니다.

출력 내용

초기화된 프로젝트

.moai/ 디렉터리가 있는 프로젝트에서 실행하면 다음 정보를 보여 줍니다.

항목설명
Project프로젝트 이름 (현재 디렉터리명)
ADK설치된 MoAI-ADK 버전
Config설정 파일 경로 (.moai/config/sections)
SPECs.moai/specs/ 하위의 SPEC 디렉터리 개수
Configs.moai/config/sections/ 의 YAML 파일 개수

하단에 초기화 상태와 SPEC 개수를 나타내는 상태 표시가 함께 출력됩니다.

미초기화 프로젝트

.moai/ 디렉터리가 없는 경우, “Not initialized” 상태 표시와 함께 moai init 실행을 안내합니다.

BODP 브랜치 알림

Git 저장소에서 실행할 때 현재 브랜치가 BODP (Branch-Oriented Development Practice) 규약을 벗어나면 stderr로 알림을 내보냅니다. 분산된 1인 OSS 워크플로우에서 브랜치 네이밍 규칙을 잊지 않도록 붙여 둔 장치입니다.

알림은 따로 켜지 않아도 나오며, Git이 설치돼 있지 않거나 현재 디렉터리가 Git 저장소가 아니면 조용히 넘어갑니다.

관련 명령어

명령어설명
moai doctor시스템 진단 및 환경 검증 (상세 확인)
moai inventory활성 세션, 워크트리, 하네스 통합 조회
moai init프로젝트 초기화 (미초기화 시 실행)

참고