domain-dictionarylisted

# Domain Dictionary (도메인사전) > Eric Evans의 *Domain-Driven Design* — Ubiquitous Language 개념을 한국 SI/현장의 영-한 혼용 환경에 맞게 적용. > 한 프로젝트 안에서 **개발자, 도메인 전문가, 사업 담당자**가 같은 단어를 같은 뜻으로 쓰도록 강제하는 사전. ## 적용 시점 | 시점 | 진입점 | |------|--------| | 신규 기능 계획 시 | `zephermine`이 Spec Synthesis 직후 자동 호출 | | 기존 코드베이스 분석 시 | `/domain-dictionary` 직접 호출 | | 코드 리뷰 시 | `code-reviewer`가 `domain-dictionary.md` 위반을 검출 | | 신규 멤버 온보딩 시 | `domain-dictionary.md` 한 장이 첫 자료 | ## 첫 실행 시 동작 스킬 첫 실행 시 글로벌 폴더를 자동 생성하고 `references/global-readme-template.md`를 README.md로 복사합니다. 기본 위치는 `~/.agent-memory/domain-dictionaries/`이며, `AGENT_DOMAIN_DICTIONARY_HOME` 환경 변수가 있으면 그 값을 우선합니다. 사용자가 `install.bat`/`install.sh`를 다시 실행하지 않아도 됩니다. 처음에는 글로벌 도메인 파일들이 비어있습니다(`ecommerce.md`, `healthcare.md` 등). 시간이 흐르면서 zephermine 컨텍스트 모드의 명확한 범용 용어 또는 사용자의 직접 선택으로 누적됩니다 — 의도된 설계. ## 질문 도구 호환성 CLI마다 질문 도구 스키마가 다릅니다. `Invalid tool parameters`를 피하기 위해 기본은 일반 텍스트 번호 목록입니다. - zephermine 컨텍스트 모드에서는 질문하지 않는 것이 기본입니다. 충돌 용어가 DB/API/타입/UI/보안/정책을 바꿀 때만 한 질문씩 묻습니다. - 직접 호출 모드(`/domain-dictionary`)에서는 사용자가 사전 점검을 요청한 것이므로 핵심 충돌이나 수정 후보를 물을 수 있습니다. - 구조화 질문 도구는 짧은 단일/소수 선택에만 사용합니다. - 한 번에 최대 3개 질문, 질문당 2-3개 짧은 선택지만 보냅니다. - 다중 선택은 기본적으로 "1, 3, 5처럼 번호로 답해주세요" 방식으로 받습니다. 구조화 다중 선택 필드는 현재 CLI가 명시 지원할 때만 사용합니다. - 도구 오류가 한 번 나면 같은 payload를 재시도하지 말고 일반 텍스트 질문으로 전환합니다. ## 사전의 두 종류 (글로벌 + 프로젝트) | 종류 | 위치 | 역할 | |------|------|------| | **글로벌** | `~/.agent-memory/domain-dictionaries/{도메인}.md` | 사용자 자산 — 자주 다루는 도메인의 누적 용어 (참고용 씨앗) | | **프로젝트** (마스터) | `<proje