================================================================
 My DX CODEX 하네스 & RAG — 기준 폴더 스타터 번들
 (삼성전자 DX 엔지니어용 · 김태영 코치)
================================================================

[이게 뭔가요?]
이 폴더(my-dx-rag)가 곧 당신의 "개인 RAG 홈"입니다.
압축을 홈 폴더에 풀면 그대로 ~/my-dx-rag 가 되어 바로 씁니다.
(직접 만들고 싶으면: mkdir -p ~/my-dx-rag/{raw,knowledge,bin,outputs})

[폴더 구조]
  my-dx-rag/
  ├── raw/                원본 문서를 여기에 (불변·읽기만). 사람이 큐레이션.
  ├── knowledge/          AI가 만들고 유지하는 OKF 지식 atom (index.md·log.md 포함)
  ├── bin/                도구 2개: dx_mini_rag.py(검색) · dx_compliance_check.py(규제 점검)
  ├── outputs/            lint·점검 리포트 (생성물)
  └── AGENTS.template.md  ← 당신의 "작업 레포 루트"에 AGENTS.md 로 복사할 씨앗

----------------------------------------------------------------
[설치 — macOS]
  1) 이 폴더를 홈에 풀기:  mv my-dx-rag ~/        (결과: ~/my-dx-rag)
  2) 동작 확인:           python3 ~/my-dx-rag/bin/dx_mini_rag.py --help
  3) Codex CLI 설치(택1):  npm i -g @openai/codex   (또는 회사 배포 채널)
     · macOS는 Codex 앱 + Codex CLI 둘 다 사용 가능.

[설치 — Windows]
  1) 압축을 사용자 폴더에 풀기: 결과가 %USERPROFILE%\my-dx-rag 가 되도록.
  2) 동작 확인 (PowerShell):  python %USERPROFILE%\my-dx-rag\bin\dx_mini_rag.py --help
     · Python 3.8+ 필요. (winget install Python.Python.3.12 등)
  3) Windows Codex 앱 사용. 설정 경로는 %USERPROFILE%\.codex\ 입니다.

----------------------------------------------------------------
[3개 앵커 — 이 셋만 기억하세요]
  A. 개인 RAG 홈   = ~/my-dx-rag          (이 폴더 · 집에 1개)
  B. 레포별 지침   = <작업 레포>/AGENTS.md (AGENTS.template.md를 복사·편집)
  C. 회사 정책     = requirements.toml      (관리자 · A·B보다 상위)

[3분 시작]
  1) AGENTS.template.md 를 작업 레포 루트에 AGENTS.md 로 복사 → <<...>>를 내 부서로 채움
  2) 사내 문서(S0/S1)를 raw/ 에 넣기
  3) 가이드 HTML의 09 프롬프트로 knowledge/ 에 OKF atom 만들기 (코드 불필요)
     또는: python3 ~/my-dx-rag/bin/dx_mini_rag.py index --root ~/my-dx-rag/knowledge --bu <BU>
  4) Codex가 AGENTS.md + 개인 RAG로 "추측 대신 출처 회수" → 할루시네이션 최소화

[중요]
  · Codex는 웹 ChatGPT와 전혀 다른 엔진입니다 — 파일을 읽고, 명령을 실행하고, AGENTS.md를 따릅니다.
  · 사내 소스/미공개 스펙/BOM/시크릿은 외부로 내보내지 마세요. 민감(S2/S3)은 로컬에만.
  · 규제 표면(개인정보·RF·의료·AI 등)은 dx_compliance_check.py 로 점검 후 법무/RA 확인.

  전체 온보딩 가이드: index.html (또는 받은 가이드 HTML)을 브라우저로 여세요.
================================================================
