📑 주제 색인 (목차)

각 주제 = 한 줄 요약 + 상태. 세부는 항목별 세부 상의 페이지 참고. 채티는 이 페이지로 먼저 주제 위치를 파악한다.

A. AI 도구 역할 분담

1. 채티 vs 코디 vs 코키 역할 구분 [확정] — 채티=설계·계획·코디 지시 / 코디=멀티파일·git·빌드 / 코키=앞간수단만.
2. 작업 흐름 [확정] — 채티 설계 → 코디 실행 → 수동 확인 순서 준수.

B. 채티 작업 지시 원칙

1. 코디 지시문 형태 [확정] — 모든 작업 지시는 기본적으로 코디 .md 지시문 작성.
2. 다단계 작업 체크리스트 [확정] — 답변 상단에 🟢/✅/⚪/⏸ 상태 표시.
3. 진단 먼저, 묶음 위임 나중 [확정] — 불확실성 0 후 코디 .md 한 번에 위임.

C. 코디 지시문 작성 규칙

1. 확인 vs 수정 구분 [확정] — "확인만 해줘"/"수정까지" 명시 간파이 없으면 코디가 임의 수정 가능.
2. PowerShell $() 금지 [확정] — 서브표현식 대신 변수 분리 사용.
3. python -m pip 규칙 [확정] — pip 직접 호출 금지, python -m pip/python -m PyInstaller 형태.
4. 코디 지시문 파일 형식 [확정] — phaseN_영문제목.md 형식, 쳄팅에 본문 길게 푸지 않음.

D. Git / 배포 규칙

1. 브랜치 역할 구분 [확정] — master=테스트/8001, deploy-live=운영/8000.
2. 운영 배포 절대 규칙 [확정] — 사용자 직접 "운영 배포해줘" 명시 시만. 지시문 내 deploy-live 포함 두어도 확인 전 절대 금지.
3. Dropbox 폴더 금지 [확정] — Git 작업 경로는 C:\dev\ 등 Dropbox 외부.

E. 개발 환경 구성

1. PC 환경 [확정] — 사무실 PC 주 개발, 집 PC 보조. C:\dev\ 공통 경로.
2. CLAUDE.md 관리 [확정] — 프로젝트 루트 + C:\dev\ 루트 동일 내용 유지. 변경 시 commit+push.
3. AWS EC2 접속 [확정] — Session Manager 탭 사용. aws ssm start-session --target i-03225ba8bc12a929e.

F. 웹 개발 규칙 (Flask/pfs)

1. API URL 패턴 [확정] — config.API_BASE_URL+ 직접 문자열 합치 금지, apiURL() 함수 사용.
2. 버튼 CSS [확정] — background: #3f8de8 !important 형태. var(--primary-color) 는 Bootstrap에 덮여쓰임.
3. Flask import 경로 [확정] — from common.response.rest_response import RestResponse 형태.

G. CLAUDE.md 관리

1. CLAUDE.md 기본 템플릿 [확정] — 작업 원칙, Git 배포 규칙 필수 포함.
2. 양쪽 PC 동기화 [확정] — 사무실에서 변경 후 집 PC에서 git pull.

H. 주요 실수 및 방지지침

1. pip 명령 인식 불가 [확정] — Python PATH 미등록. python -m pip 형태 사용.
2. 코디 임의 수정 [확정] — 지시 구분 불명확. "확인만"/"수정까지" 명시.
3. EC2 접속 실패 [확정] — EC2 Instance Connect 탭 사용 오류. Session Manager 탭.

I. Notion MCP 확장

1. 액커 링크 (MCP 한계) [진행중] — Notion MCP가 블록 UUID를 노출하지 않아 담담 링크 구현 불가. 커스텀 MCP 개발 예정.
2. 작업 트래커 정렬 [완료] — 진행순서 오름차순 기본 정렬.