개요

• **MoAI-ADK (MoAI Agent Development Kit)**는 Claude Code를 위한 프로젝트별 AI 개발 환경 설정 시스템입니다.

.moai 폴더는 AI가 프로젝트를 더 잘 이해하고, 일관된 방식으로 작업할 수 있도록 돕는 설정, 지식, 워크플로우를 담고 있습니다.

핵심 가치

• 할루시네이션 방지: 프로젝트 규칙을 명시하여 AI가 일관된 코드 생성
• 컨텍스트 유지: 세션이 바뀌어도 프로젝트 지식 유지
• 워크플로우 자동화: SPEC 기반 개발 프로세스 지원
• 다국어 지원: 한국어/영어/일본어/중국어 키워드 인식

폴더 구조

.moai/
├── config/                    # 설정 파일
│   ├── config.yaml            # 메인 설정 (프로젝트 메타데이터)
│   ├── sections/              # 분리된 설정 섹션
│   │   ├── user.yaml          # 사용자 설정 (이름, 역할)
│   │   ├── language.yaml      # 언어 설정
│   │   ├── agent-routing.yaml # 에이전트 라우팅 규칙
│   │   ├── skill-triggers.yaml # 스킬 자동 로딩 규칙
│   │   ├── quality.yaml       # 코드 품질 기준
│   │   └── git-strategy.yaml  # Git 전략
│   └── questions/             # 초기 설정 질문
│
├── skills/                    # 프로젝트 맞춤 스킬
│   ├── artify-default-theme/
│   ├── artify-swiss-theme/
│   ├── artify-editorial-theme/
│   ├── artify-museum-theme/
│   ├── artify-immersive-theme/
│   ├── artify-brutalist-theme/
│   └── artify-studio-theme/
│
├── specs/                     # SPEC 문서 (요구사항 명세)
│   ├── SPEC-CLERK-ORG-001/
│   │   ├── spec.md           # 요구사항 정의
│   │   ├── plan.md           # 구현 계획
│   │   └── acceptance.md     # 인수 조건
│   └── ...
│
├── memory/                    # AI 메모리
│   ├── project-notes.json     # 프로젝트 노트
│   ├── user-patterns.json     # 사용자 패턴
│   └── session-hint.json      # 세션 힌트
│
├── project/                   # 프로젝트 문서
│   ├── product.md             # 제품 설명
│   ├── tech.md                # 기술 스택
│   ├── structure.md           # 프로젝트 구조
│   ├── analysis/              # 분석 문서
│   └── trouble/               # 트러블슈팅 기록
│
├── docs/                      # AI 생성 문서
├── logs/                      # 실행 로그 (30일 보관)
├── temp/                      # 임시 파일 (7일 보관)
└── cache/                     # 캐시 (30일 보관)

핵심 기능

1. Config (설정)

user.yaml - 사용자 정보

user:
name:"YS"
role:"Frontend Developer"
responsible_areas:
-"portfolio"
-"dashboard"
documentation_folder:"docs/100_portfolio"

효과: AI가 사용자 이름을 부르고, 담당 영역에 맞는 작업을 제안합니다.

language.yaml - 언어 설정

language:
conversation_language:"ko"# AI 응답 언어 (ko/en/ja/zh)
code_comments:"en"# 코드 주석 언어
git_commit_messages:"en"# 커밋 메시지 언어
documentation:"en"# 문서 언어

효과: AI가 한국어로 응답하고, 코드 주석은 영어로 작성합니다.