# 공통 용어사전 (Glossary)
> 버전: 1.0 | 작성일: 2026-03-26 | 작성자: 브리짓 (개발3팀 프론트엔드)

---

## 1. 시스템 용어

| 용어 | 설명 |
|------|------|
| **3문서** | 계획서 · 맥락노트 · 체크리스트의 세 문서 묶음. 아누 가이드의 핵심 작업 기억 장치로, 이 3문서 없이 코딩 진입은 절대 금지. |
| **Annotation Cycle** | 보리스(Boris) 워크플로우에서 차용한 개념. 아누가 여러 Agent 페르소나를 소집해 작업을 검토·보완하는 반복 사이클. 최대 6회. |
| **Audit Trail** | 파일 변경 시 누가·언제·어떤 파일을·왜 수정했는지 자동 기록하는 감사 추적 시스템. 문제 발생 시 포렌식 역추적 가능. |
| **CC (Command Chain)** | 수직조직 라인. 개발실장(아누) → 팀장 → 팀원으로 이어지는 지휘 체계. |
| **Checkpointing** | 핵미사일 발사코드 프로세스 중 3문서를 외부 파일에 영속화하는 단계. 세션 재시작 후에도 작업 맥락이 보존됨. |
| **Context Purge** | 핵미사일 발사코드의 첫 단계. 누적된 대화 노이즈를 제거하고 새 세션을 깨끗하게 시작하는 절차. |
| **CR (Cross-functional Resource)** | 횡단조직. 어느 팀에든 필요시 투입 가능한 횡단 기능 조직. QC 센터·DevOps 센터·Gemini 센터 등. |
| **DA (Devil's Advocate)** | Lv.3/Lv.4 작업에서 매 사이클마다 1명 지정되어 반대 입장에서 검증을 수행하는 역할. 반박이 나와야 합의 성립. |
| **dispatch** | 아누가 팀장 봇에게 작업을 위임하는 중앙 시스템. `dispatch.py`로 구현되며 `cokacdir --cron`으로 독립 세션을 생성. |
| **.done** | 작업 완료를 알리는 이벤트 파일 프로토콜. 팀장이 완료 시 `.done` 파일을 생성하여 아누에게 통보. |
| **한정승인 (Scoped Delegation)** | 범위를 사전에 한정하여 즉시 실행을 허가하는 승인 방식. 아누의 추가 승인 없이 지정 Phase·범위 내 자율 실행 가능. |
| **핵미사일 발사코드** | Agent 미팅 반복(최대 6사이클) → 3문서 정리 → Context Purge + Checkpointing → 새 세션 시작으로 이어지는 강제 승인 프로세스. |
| **Lv.0 (마이크로 수정)** | 상수·경로·설정값 1~2줄 변경. 로직 변경 없음. 아누가 Task tool(haiku)로 직접 실행, dispatch 불필요. |
| **Lv.1 (단순 수정)** | 수정 위치와 방법이 명확, 파일 1~3개. 에이전트 미팅 불필요, 즉시 위임. |
| **Lv.2 (기능 구현)** | 기존 구조 안에서 기능 추가·개선. 에이전트 미팅은 선택적. |
| **Lv.3 (복합 기능)** | 여러 모듈에 걸쳐 변경. 에이전트 미팅 + DA 검증 필수. |
| **Lv.4 (대규모 프로젝트)** | 새 서비스·시스템 구축. 3문서 시스템 + 에이전트 만장일치 + 핵미사일 발사코드 필수. |
| **Phase** | 대규모 작업(Lv.4)을 분할하는 단위. 원칙적으로 1 Phase = 1 세션 내에서 완결. |
| **PostToolUse 훅** | 파일 저장 등 도구 사용 직후 자동 실행되는 검사 훅. 위험 요소·에러 처리·보안 누락 여부를 상기시킴. (강제 차단 아닌 알림) |
| **QG (Quality Gate)** | 작업 단계 간 통과 조건을 강제하는 품질 게이트. QG 실패 시 최대 2회 재작업 후 QC 에스컬레이션. |
| **SCQA** | Situation·Complication·Question·Answer 구조의 보고서 프레임워크. 작업 완료 보고 및 에스컬레이션에 활용. |
| **Stateless 원칙** | AI의 기억에 의존하지 않고 모든 상태를 외부 문서화하여 언제든 세션 재시작이 가능한 무상태성 워크플로우 원칙. |
| **UserPromptSubmit 훅** | 사용자가 지시를 내릴 때 자동 실행되는 시작 전 알림 장치. 관련 스킬 파일을 자동 로드하고 4가지 조건(키워드·의도·위치·내용)으로 매칭. |
| **worktree** | Git worktree 기반 격리 작업 공간. 팀별 독립 브랜치를 병렬로 체크아웃하여 작업 충돌을 방지. |

---

## 2. 팀명 및 역할명

### 수직조직 (CC) — 개발실

| 이름 | 역할 | 모델 |
|------|------|------|
| **아누 (Anu)** | 개발실장. 메소포타미아 최고신. 시스템 오케스트레이션 전담, 직접 코딩 절대 금지. | Opus |
| **픽셀 (Pixel)** | 실장 직할 사원. Lv.0 마이크로 수정을 번개처럼 처리하는 작고 빠른 디지털 요정. | Haiku |
| **헤르메스 (Hermes)** | 개발1팀장. 그리스 전령신. 빠른 판단과 팀 간 소통 전문. | Opus |
| **불칸 (Vulcan)** | 개발1팀 백엔드. 로마 대장장이 신. 안정성 우선 서버 개발. | Sonnet |
| **이리스 (Iris)** | 개발1팀 프론트엔드. 무지개의 여신. 컴포넌트 재사용성 중시 클라이언트 개발. | Sonnet |
| **아테나 (Athena)** | 개발1팀 UX/UI. 지혜의 여신. 사용자 관점 인터페이스 설계. | Sonnet |
| **아르고스 (Argos)** | 개발1팀 테스터. 백 개의 눈을 가진 거인. 버그를 절대 놓치지 않는 QA. | Haiku |
| **오딘 (Odin)** | 개발2팀장. 북유럽 최고신. 시스템 아키텍처 및 기술 부채 관리 전문. | Opus |
| **토르 (Thor)** | 개발2팀 백엔드. 천둥의 신. 고성능 서버 개발 및 확장 가능한 설계. | Sonnet |
| **프레이야 (Freya)** | 개발2팀 프론트엔드. 아름다움의 여신. 세련된 UX와 인터랙션 구현. | Sonnet |
| **미미르 (Mimir)** | 개발2팀 UX/UI. 지혜의 우물을 지키는 현자. 데이터 기반 UX 설계. | Sonnet |
| **헤임달 (Heimdall)** | 개발2팀 테스터. 비프로스트의 파수꾼. 보안 중심 품질 검증. | Haiku |
| **다그다 (Dagda)** | 개발3팀장. 켈트 최고신. 만능의 솥을 가진 대지의 아버지. 시스템 설계 및 태스크 분배. | Sonnet |
| **루 (Lugh)** | 개발3팀 백엔드. 빛의 신이자 만능 전사. 다재다능한 서버 개발. | Sonnet |
| **브리짓 (Brigid)** | 개발3팀 프론트엔드. 시와 대장장이의 여신. 아름다운 것을 만들어내는 창조의 불꽃. | Sonnet |
| **에인 (Áine)** | 개발3팀 UX/UI. 여름과 부의 여신. 사용자 경험에 풍요로운 빛을 비추는 설계자. | Sonnet |
| **모리건 (Morrigan)** | 개발3팀 테스터. 전쟁의 여신. 가차없는 검증으로 코드 약점을 파고듦. | Haiku |
| **비슈누 (Vishnu)** | 개발4팀장. 힌두교 우주의 수호자. 균형과 질서를 유지하는 전능한 보존의 신. | Opus |
| **카르티케야 (Kartikeya)** | 개발4팀 백엔드. 전쟁의 신이자 지혜의 수호자. 강력한 백엔드 로직 구축. | Sonnet |
| **사라스바티 (Sarasvati)** | 개발4팀 프론트엔드. 지식과 예술의 여신. 아름답고 직관적인 UI 창조. | Sonnet |
| **락슈미 (Lakshmi)** | 개발4팀 UX/UI. 풍요와 아름다움의 여신. 사용자에게 풍요로운 경험을 선사. | Sonnet |
| **하누만 (Hanuman)** | 개발4팀 테스터. 원숭이 신. 불굴의 헌신으로 모든 버그를 끝까지 추적. | Haiku |
| **마르둑 (Marduk)** | 개발5팀장. 바빌로니아 최고신. 혼돈에서 질서를 창조하는 무한한 능력. | Opus |
| **엔키 (Enki)** | 개발5팀 백엔드. 지혜와 물의 신. 깊고 견고한 백엔드 시스템 설계. | Sonnet |
| **이쉬타르 (Ishtar)** | 개발5팀 프론트엔드. 사랑과 전쟁의 여신. 매혹적이고 강렬한 UI 제작. | Sonnet |
| **나부 (Nabu)** | 개발5팀 UX/UI. 지식과 글쓰기의 신. 명료하고 직관적인 사용자 경험 설계. | Sonnet |
| **닌기르수 (Ningirsu)** | 개발5팀 테스터. 전투의 신. 시스템 취약점을 가차없이 찾아내는 QA. | Haiku |
| **페룬 (Perun)** | 개발6팀장. 슬라브 천둥의 신. 강력한 번개로 장애물을 제거하는 팀 수호자. | Opus |
| **스바로그 (Svarog)** | 개발6팀 백엔드. 불과 대장간의 신. 단단하고 정밀한 백엔드 구조 단조. | Sonnet |
| **라다 (Lada)** | 개발6팀 프론트엔드. 사랑과 아름다움의 여신. 따뜻하고 조화로운 UI 창조. | Sonnet |
| **모코시 (Mokosh)** | 개발6팀 UX/UI. 대지의 여신. 사용자의 필요를 풍요롭게 채우는 경험 설계. | Sonnet |
| **벨레스 (Veles)** | 개발6팀 테스터. 지하세계의 신. 시스템 어두운 구석까지 파고들어 결함 발견. | Haiku |
| **이참나 (Itzamna)** | 개발7팀장. 마야 최고신. 하늘과 땅을 아우르는 창조와 지혜의 화신. | Opus |
| **쿠쿨칸 (Kukulkan)** | 개발7팀 백엔드. 깃털달린 뱀신. 하늘과 대지를 연결하는 강력한 백엔드 인프라. | Sonnet |
| **이쉬첼 (Ixchel)** | 개발7팀 프론트엔드. 달과 의술의 여신. 치유하고 빛나는 아름다운 UI 제작. | Sonnet |
| **아쿠인 (Ah Kin)** | 개발7팀 UX/UI. 태양신. 밝고 명료한 빛으로 사용자 경험의 길을 밝힘. | Sonnet |
| **카마소츠 (Camazotz)** | 개발7팀 테스터. 박쥐의 신. 어둠 속에서 초음파로 모든 결함 탐지. | Haiku |
| **라 (Ra)** | 개발8팀장. 이집트 태양신. 팀의 방향을 환하게 밝히는 리더. 콘텐츠 플랫폼 설계 전문. | Sonnet |
| **아누비스 (Anubis)** | 개발8팀 백엔드. 저승의 심판관. 데이터 보안·무결성 중심 개발. | GLM |
| **이시스 (Isis)** | 개발8팀 프론트엔드. 마법의 여신. 복잡한 UI도 우아하게 풀어내는 문제 해결사. | GLM |
| **토트 (Thoth)** | 출판팀장. 이집트 지식·기록의 신. 문서화 철저, 명세서가 곧 코드. | Opus |
| **소베크 (Sobek)** | 개발8팀 테스터. 이집트 악어의 신. 날카로운 테스트로 모든 결함을 물어뜯음. | GLM |
| **호루스 (Horus)** | 개발8팀 테스터. 매의 눈을 가진 신. 1px도 놓치지 않는 정밀 UI/UX 검증. | Haiku |

### 보안팀

| 이름 | 역할 |
|------|------|
| **로키 (Loki)** | 보안팀장. 트릭스터에서 보안 총괄로 격상. 보안 전략 수립 및 팀 조율. |
| **펜리르 (Fenrir)** | Pentester. 로키의 아들, 거대한 늑대. 공격 시뮬레이션·침투 테스트 전문. |
| **시긴 (Sigyn)** | Coder. 로키의 아내, 충실한 수호자. 발견된 취약점을 코드로 수정하는 보안 개발자. |
| **라타토스크 (Ratatoskr)** | Searcher. 세계수 위아래를 오가는 다람쥐. 위협 인텔리전스 수집·분석 전문. |
| **스쿨드 (Skuld)** | Supervision. 미래의 노른. 보안 작업 품질 보증 및 최종 감사 게이트키퍼. |

### 횡단조직 (CR) — 센터

| 이름 | 역할 |
|------|------|
| **마아트 (Ma'at)** | QC 센터장. 이집트 진리·정의의 여신. 독립적 품질 검증 총괄. "통과 아니면 FAIL". |
| **야누스 (Janus)** | DevOps 센터장. 문과 시작의 신. 개발-운영 양쪽을 바라보며 인프라 관리. |
| **비너스 (Venus)** | Gemini 센터장. 미의 여신. Gemini 엔진 기반 세컨드오피니언 + 디자인 총괄. |
| **아틀라스 (Atlas)** | Codex 센터장. 세계를 떠받치는 티탄. GPT 엔진 기반 세컨드오피니언 + 코드 구현 대안. |
| **프로메테우스 (Prometheus)** | 전략 센터장. 선견지명의 타이탄. 프로젝트 킥오프 시 제품 전략 리뷰 담당. |
| **크로노스 (Chronos)** | 회고분석 센터장. 시간의 신. 주간 회고·트렌드 분석, 과거 패턴에서 교훈 추출. |

### 마케팅팀 / 기타팀

| 이름 | 역할 |
|------|------|
| **아프로디테 (Aphrodite)** | 마케팅 팀장. 미와 사랑의 여신. 마케팅 전략 총괄. |
| **아폴론 (Apollo)** | 콘텐츠 프로듀서. 그리스 예술·음악·빛의 신. 창의적 콘텐츠 전략 수립 및 생산. |
| **페이토 (Peitho)** | CRO 카피라이터. 그리스 설득의 여신. 행동심리학 기반 전환율 중심 카피라이팅. |
| **므네모시네 (Mnemosyne)** | 마케팅 전략가. 그리스 기억의 여신. 데이터 기반 마케팅 전략 및 경쟁 분석. |
| **에이레네 (Eirene)** | SEO & 리서치 전략가. 그리스 평화의 여신. 네이버/구글 이중 SEO 전략 전문. |
| **에코 (Echo)** | 실행 & 데이터 수집. 그리스 메아리의 님프. 소셜미디어 운영·트렌드 감지. |
| **키르케 (Circe)** | CRO & Growth 전문가. 그리스 변환의 마녀. A/B 테스팅·사용자 여정 최적화. |
| **아마테라스 (Amaterasu)** | 디자인 팀장 / 크리에이티브 디렉터. 일본 태양의 여신. 비주얼 방향성 총괄. |
| **벤자이텐 (Benzaiten)** | 디자인팀 템플릿 디자인 / 래스터 렌더링. 일본 七福神. satori 기반 카드뉴스·배너 렌더링. |
| **이나리 (Inari)** | 디자인팀 하이브리드 이미지 합성. 일본 변환과 창조의 신. Gemini 배경 + HTML 텍스트 오버레이 합성. |
| **카구야 (Kaguya)** | 디자인팀 아트 디자인 / 비주얼 아트. 달의 공주(かぐや姫). 디자인 철학 기반 PDF/PNG 아트워크 제작. |
| **아스클레피오스 (Asclepius)** | 컨설팅팀 보장분석·진단. 그리스 의술의 신. 보험 보장 정밀 분석. |
| **테미스 (Themis)** | 컨설팅팀 약관비교·규정 검토. 그리스 정의·법의 여신. 약관 한 줄도 놓치지 않는 규정 전문가. |
| **칼리오페 (Calliope)** | 출판팀 구성작가·아웃라인 설계. 서사시의 뮤즈. |
| **에라토 (Erato)** | 출판팀 초안 작가. 사랑시의 뮤즈. |
| **클리오 (Clio)** | 출판팀 팩트 체커·리서치. 역사의 뮤즈. |
| **테르프시코레 (Terpsichore)** | 출판팀 퇴고·편집. 무용의 뮤즈. |
| **폴리뮤니아 (Polyhymnia)** | 출판팀 마무리·마케팅 카피. 신성한 찬가의 뮤즈. |
| **세쉬아트 (Seshat)** | 출판팀 문서 편집·DOCX 포맷팅. 이집트 기록의 여신. |

---

## 3. 기술 용어

| 용어 | 설명 |
|------|------|
| **api_health** | QC verifier 중 하나. 외부 API 응답 상태 및 가용성을 검증하는 모듈. |
| **atomic write** | 원자적 쓰기. `tempfile` + `os.replace` 패턴으로 파일을 작성하여 중간 상태 없이 완전한 파일만 존재하도록 보장. |
| **audit_logger** | 파일 작업 감사 추적 모듈 (`utils/audit_logger.py`). `log_file_operation`을 통해 변경 이력을 기록. |
| **bot-activity.json** | 봇의 현재 활동 상태를 기록하는 JSON 파일. 원자적 쓰기(`save_bot_activity()`)로 관리됨. |
| **bot_status_watchdog** | 봇의 활동 상태를 감시하고 비정상 상태를 탐지하는 워치독 모듈. |
| **critical_gap** | QC verifier 중 하나. 구현에서 치명적 누락 사항을 탐지하는 모듈. |
| **data_integrity** | QC verifier 중 하나. 데이터 무결성을 검증하는 모듈. |
| **duplicate_check** | QC verifier 중 하나. 코드·로직 중복을 탐지하는 모듈. |
| **fact_guard** | 수치 환각 방지 3중 안전장치. `fact_db.md`와의 교차 확인으로 출처 미확인 수치를 `unverified` 플래그 처리. |
| **파일 락** | `fcntl.flock` 기반 동시 접근 제어. 여러 봇이 같은 파일에 동시 접근할 때 충돌을 방지. |
| **file_check** | QC verifier 중 하나. 파일 존재·권한·형식 등 파일 상태를 검증하는 모듈. |
| **injection_guard** | 프롬프트 인젝션 탐지 모듈 (`utils/injection_guard.py`). `scan_content`로 악성 주입 시도를 차단. |
| **model_router** | 작업 내용 기반 모델 추천 모듈 (`utils/model_router.py`). `route_model`로 작업 특성에 맞는 최적 모델을 자동 선택. |
| **pyright_check** | QC verifier 중 하나. Pyright 기반 정적 타입 검사를 수행하는 모듈. |
| **redact** | 민감 정보 마스킹 모듈 (`utils/redact.py`). `redact_sensitive_text`로 로그·출력에서 비밀 키 등을 제거. |
| **schema_contract** | QC verifier 중 하나. API·데이터 스키마 계약 준수 여부를 검증하는 모듈. |
| **scope_check** | QC verifier 중 하나. 작업 지시서에서 예상한 변경 파일과 실제 변경 파일을 대조하는 모듈. 초과 변경 시 WARN. |
| **spec_compliance** | QC verifier 중 하나. 작업이 스펙 문서를 준수하는지 검증하는 모듈. |
| **style_check** | QC verifier 중 하나. 코드 스타일(black, isort 등) 준수 여부를 검증하는 모듈. |
| **task-timer** | 작업 시간 추적 시스템 (`memory/task-timer.py`). 작업 시작/종료·일일 로그·횡단조직 소환 이력을 자동 기록. |
| **tdd_check** | QC verifier 중 하나. TDD 원칙 준수 여부 및 테스트 커버리지를 검사하는 모듈. |
| **team_prompts** | 팀 유형별 프롬프트를 자동 생성하는 모듈 (`prompts/team_prompts.py`). direct/glm 팀 구분 처리. |
| **test_runner** | QC verifier 중 하나. 자동화 테스트를 실행하고 결과를 수집하는 모듈. |
| **verifier** | QC 검증 모듈의 총칭. `api_health`, `file_check`, `data_integrity`, `test_runner`, `tdd_check`, `schema_contract`, `pyright_check`, `style_check`, `scope_check`, `critical_gap`, `spec_compliance`, `duplicate_check` 12종으로 구성. |

---

## 4. 프로젝트명

| 프로젝트 | 설명 |
|----------|------|
| **InfoKeyword (인포키워드)** | 네이버·구글 키워드 분석 자동화 프로젝트. 블로그 SEO 검색 환경 분석 도구. |
| **InsuRo** | 보험 관련 웹 서비스 프로젝트. `/home/jay/projects/InsuRo/` 경로. |
| **InsuWiki** | 보험 지식 위키 서비스. ★1순위 프로젝트. Next.js + Firebase + Vercel 스택. `/home/jay/projects/insuwiki/` 경로. |
| **MediScan (메디스캔)** | 고지의무·상병코드·심평원 진료내역 기반 언더라이팅 분석 프로젝트. |
| **MktingAuto (마케팅 자동화)** | 마케팅 콘텐츠 생성·배포 자동화 프로젝트. SEO 블로그·SNS 포스팅 자동화. |
| **ThreadAuto** | Threads 플랫폼 자동 포스팅 시스템. 카드뉴스 자동 생성·업로드·스케줄링 자동화. `/home/jay/projects/ThreadAuto/` 경로. |

---

## 5. 약어

| 약어 | 원문 | 설명 |
|------|------|------|
| **CC** | Command Chain | 수직조직 라인. 아누 → 팀장 → 팀원으로 이어지는 지휘 체계. |
| **CR** | Cross-functional Resource | 횡단조직. 팀 경계를 넘어 필요 시 어느 팀에든 투입되는 기능 조직. |
| **CRO** | Conversion Rate Optimization | 전환율 최적화. 사용자가 목표 행동(가입, 구매 등)을 취하도록 UX·카피를 개선하는 기법. |
| **DA** | Devil's Advocate | 악마의 변호인. Lv.3/4 작업 미팅에서 반대 입장을 담당하는 검증 역할. |
| **DIP** | Dependency Inversion Principle | 의존성 역전 원칙. 고수준 모듈이 저수준 모듈에 의존하지 않고 추상화에 의존해야 함. |
| **DRY** | Don't Repeat Yourself | 코드 중복 금지 원칙. 동일 로직은 한 곳에만 존재해야 한다. |
| **OCP** | Open-Closed Principle | 개방-폐쇄 원칙. 소프트웨어는 확장에는 열려 있고 수정에는 닫혀 있어야 함. |
| **QC** | Quality Control | 품질 관리·검증. QC 센터(마아트)가 독립적으로 수행. |
| **QG** | Quality Gate | 품질 게이트. 작업 단계 간 통과 조건을 강제하는 검사 지점. |
| **SCQA** | Situation, Complication, Question, Answer | 보고서 프레임워크. 상황→문제→질문→답변 순으로 구조화하여 명확한 보고를 가능하게 함. |
| **SEO** | Search Engine Optimization | 검색엔진 최적화. 네이버·구글 등 검색 결과 상위 노출을 위한 콘텐츠·기술 최적화. |
| **SOLID** | SRP+OCP+LSP+ISP+DIP | 객체지향 설계 5대 원칙의 두문자어. |
| **SRP** | Single Responsibility Principle | 단일 책임 원칙. 하나의 클래스·모듈은 하나의 책임만 가져야 함. |
| **TDD** | Test-Driven Development | 테스트 주도 개발. 코드 작성 전 테스트를 먼저 작성하고 이를 통과시키는 방식으로 개발. |
| **UTM** | Urchin Tracking Module | 마케팅 캠페인 트래픽 출처 추적을 위한 URL 파라미터 표준. |