AI_FIRST_READ

이 사이트는 읽기 전용 컨텍스트이며, 실제 수정은 GitHub repo에서만 한다.
이 페이지는 Cloudflare Pages 가 public/ 으로 빌드한 정적 스냅샷이다.
내용에 오류가 있어도 이 사이트에서 수정하지 않는다 — 항상 원본 repo (GitHub) 에서 수정 → push → 자동 재빌드.

0. 이게 뭐야?

core-admin repo 의 핵심 구조를 Claude / GPT 같은 AI가 같은 URL 로 읽도록 만든 정적 viewer 다.

GitHub push → Cloudflare Pages 자동 빌드 → 공개 URL 자동 갱신
AI 는 항상 최신 구조를 같은 주소로 조회 가능
사람용 예쁜 UI 가 아니라 AI 가 안정적으로 읽는 것이 우선

1. 프로젝트 목적

core-admin 은 한 사람의 작업·기획·자기 점검을 한 자리에 묶어둔 운영 공간이다.
핵심 축

운영판 — 실제 돌아가는 prompt 운영 시스템 (Flask 기반)
_정야총괄 — 카테고리 / 운영 원칙 / 인수인계 메모
창작 자료들 — 캐러셀 생성기, 채집 메모 등 (이 viewer 에는 노출되지 않음)

이 viewer 는 AI 가 컨텍스트만 얻도록 일부 파일/폴더만 추려 노출한다.

2. 핵심 폴더 구조 (이 viewer 에 노출되는 것만)

core-admin/
├── README.md                          ← 프로젝트 소개 / 진입점
├── HANDOFF.md                         ← 인수인계 메모 (현재 상태)
├── AI_FIRST_READ.md                   ← 지금 이 문서
├── _정야총괄/
│   ├── AI운영원칙.md                  ← AI 가 어떤 톤·범위로 작업할지의 규약
│   ├── HANDOFF_갈아엎기_2026-05-14.md ← 큰 리팩터링 이벤트의 컨텍스트
│   └── 카테고리/                      ← 영역별 메모 (SNS / 사주 / 쇼핑몰 등)
└── 운영판/
    ├── server.py                      ← Flask 운영 서버 (읽기만)
    ├── static/index.html              ← 운영판 UI (읽기만)
    └── data/prompts.json              ← 운영판 prompt 데이터 (읽기만)

위 외의 것은 노출되지 않는다. (나에 대한 정리들/, 선별 대기/, 링크 아카이브/, 아카이브/, 그냥 이것저것/, _사업/, _휴지통/ 등)

3. 파일 읽는 순서

처음 들어왔다면 이 순서로 읽어라.

AI_FIRST_READ.md ← 지금 이 문서
README.md — 프로젝트 한 줄 소개
HANDOFF.md — 지금 시점의 작업 상태 / 다음 액션
_정야총괄/AI운영원칙.md — AI 가 지켜야 할 톤·범위·금지사항
_정야총괄/HANDOFF_갈아엎기_2026-05-14.md — 큰 변경 이력의 맥락
필요 시 _정야총괄/카테고리/ 의 해당 카테고리 문서
운영판 코드를 봐야 할 때만 운영판/server.py, 운영판/static/index.html, 운영판/data/prompts.json 참고

4. 금지사항 (AI 가 이 컨텍스트로 작업할 때)

수정 제안을 이 사이트의 파일로 돌려보내려 하지 말 것. 이 사이트는 출력 전용 스냅샷이다.
운영판 구조를 리팩터링하거나 이식하지 말 것. Flask 서버를 다른 데로 옮기거나 구조를 바꾸지 않는다.
운영판/server.py, 운영판/static/index.html, 운영판/data/prompts.json 을 직접 수정하지 말 것. 읽기 전용.
repo 전체 자동 공개 금지. 노출 범위는 이 빌드 스크립트의 whitelist 로만 결정된다.
UI 위주 작업으로 빠지지 말 것. 사람용 예쁜 사이트가 목적이 아니다.

5. 주요 파일 링크 (이 viewer 안의 변환된 페이지)

원본	viewer 내 경로
`README.md`	`README.html`
`HANDOFF.md`	`HANDOFF.html`
`_정야총괄/AI운영원칙.md`	`_정야총괄/AI운영원칙.html`
`_정야총괄/HANDOFF_갈아엎기_2026-05-14.md`	`_정야총괄/HANDOFF_갈아엎기_2026-05-14.html`
`_정야총괄/카테고리/*.md`	`_정야총괄/카테고리/*.html`
`운영판/server.py`	`운영판/server.py.html`
`운영판/static/index.html`	`운영판/static/index_raw.html`
`운영판/data/prompts.json`	`운영판/data/prompts.json.html`

전체 노출 파일 목록은 REPORT.md 에 자동 기록된다.

6. 빌드 / 갱신 흐름

GitHub push
   ↓
Cloudflare Pages: python scripts/build-docs-viewer.py
   ↓
public/ 자동 생성
   ↓
같은 공개 URL 로 최신 스냅샷 노출

빌드 스크립트: scripts/build-docs-viewer.py
출력 디렉토리: public/
환경변수: PYTHON_VERSION = 3.11

7. 한 줄 원칙

이 사이트는 읽기 전용 컨텍스트이며, 실제 수정은 GitHub repo에서만 한다.