/moai gate

커밋 전 품질을 빠르게 검증하는 경량 게이트 명령어입니다. 린트·포맷·타입 검사·테스트를 병렬로 실행하여 대부분의 프로젝트에서 30초 이내에 완료됩니다. 검사 결과는 공유 진단 스냅샷에 남기 때문에, 뒤따르는 run-phase 사전 게이트나 sync 게이트가 같은 검사를 다시 돌리지 않고 기록된 결과를 재사용합니다.

정보

한 줄 요약: /moai gate는 “커밋 전 빠른 검문소” 입니다. 4가지 검사 (린트·포맷·타입·테스트) 를 동시에 돌려 통과/실패를 바로 알려 줍니다. 전체 코드 리뷰나 커버리지 분석은 건너뛰고 판정만 빠르게 냅니다.

정보

슬래시 커맨드: Claude Code에서 /moai:gate를 입력하면 이 명령어를 바로 실행할 수 있습니다. /moai만 입력하면 사용 가능한 모든 서브커맨드 목록이 표시됩니다.

커밋하기 전에 “지금 상태가 깨끗한가?“를 확인하고 싶을 때 사용합니다. /moai review (심층 4관점 리뷰) 나 sync 파이프라인의 전체 품질 검사와 달리, /moai gate는 빠른 통과/실패 판정만 제공합니다.

# 전체 검사
> /moai gate

# 린트·포맷 자동 수정
> /moai gate --fix

# 스테이징된 파일만 검사
> /moai gate --staged

# 특정 파일만 검사
> /moai gate --file src/auth/service.go

flowchart TD
    Start["/moai gate 실행"] --> Detect["1단계: 언어 감지
(마커 파일 우선순위)"]
    Detect --> Snap["1B단계: 공유 스냅샷 소비
(신선하면 재사용, --fresh면 건너뜀)"]
    Snap --> Parallel

    subgraph Parallel["2단계: 병렬 검사"]
        C1["Lint
스타일·미사용 import"]
        C2["Format
포맷 검증"]
        C3["Type
정적 타입 분석"]
        C4["Test
테스트 스위트"]
    end

    Parallel --> Report["3단계: 결과 보고
(PASS/FAIL/WARN 표)"]
    Report --> Next["4단계: 다음 단계
(실패 시 --fix / /moai fix / 무시)"]

마커 파일을 우선순위대로 살펴 (먼저 걸리는 마커를 따릅니다) 언어별 도구 체인을 고릅니다. 16개 지원 언어를 똑같이 다루며, 예를 들어 Go라면 go vet·golangci-lint·go test -race가, Python이라면 ruff·mypy·pytest가 돌아갑니다. 알아볼 수 있는 마커가 없으면 언어별 검사를 건너뛰고 “unknown language"로 보고합니다.

검사를 돌리기 전에, 지금 작업 트리에 대한 공유 진단 스냅샷이 있는지 먼저 봅니다. 아직 유효한 스냅샷(키 일치 + TTL 이내, 기본 10분)이 이 게이트가 돌릴 검사 항목을 모두 담고 있으면, 다시 돌리는 대신 기록된 결과를 재사용하고 보고서에 Test | PASS (snapshot)처럼 표시합니다. 오래된 스냅샷은 증거로 인용하지 않고 다시 돌립니다. --fresh 모드에서는 이 단계를 통째로 건너뜁니다.

4가지 검사를 백그라운드로 동시에 실행합니다.

개별 검사 타임아웃은 60초, 전체 게이트 타임아웃은 90초입니다. 시간을 넘기면 WARNING으로 보고하되 막지는 않습니다. 재사용이 아니라 실제로 돌린 검사 결과는 .moai/state/verify/ 아래 공유 스냅샷 스토어에 남습니다. 작업 트리가 그대로인 한, 뒤따르는 쪽(run-phase 사전 리뷰 게이트, sync 사전 게이트, stop-goal 평가기)이 이 결과를 그대로 가져다 씁니다.

## Quality Gate: PASS
| Check  | Status | Time  |
|--------|--------|-------|
| Lint   | PASS   | 2.1s  |
| Format | PASS   | 0.8s  |
| Type   | PASS   | 3.2s  |
| Test   | PASS   | 12.4s |
Total: 18.5s

모두 통과하면 커밋해도 좋다는 메시지를 띄웁니다. --fix 없이 실패했다면 AskUserQuestion으로 세 가지를 제시합니다. 자동 수정 (--fix 재실행, 권장), /moai fix (더 깊이 해결), 무시하고 진행입니다. --fix를 돌린 뒤에도 남은 이슈 (타입 오류·테스트 실패) 는 직접 들여다보는 편이 낫습니다.

/moai gate는 확인만 하고 파일에는 손대지 않는 가벼운 검문소입니다 (--fix를 줄 때만 린트·포맷을 바로잡습니다). 더 깊이 손봐야 하면 /moai fix (단발) 나 /moai loop (반복) 로 넘어가고, PR 전 종합 리뷰는 /moai review로 합니다. --fresh 모드는 /moai loop의 독립 최종 검증 패스가 자기 자신을 근거로 삼지 않는 증거를 얻으려고 이 게이트를 부를 때 씁니다.

• /moai fix - 일회성 자동 수정
• /moai loop - 반복 수정 루프
• TRUST 5 품질 시스템