---
title: "📌 달록 개발 운영 핵심지침"
notion_id: "364229620868814e9af5e01ae8b44069"
notion_url: "https://app.notion.com/p/364229620868814e9af5e01ae8b44069"
category: "guideline"
parent: "달록 PaceLog"
updated: "2026-05-30"
priority: "High"
purpose: "달록 개발 운영 철학·관리 방식·역할분업·파트섹션트리·프롬프트 템플릿 핵심지침서"
read_when: ["운영규칙·프롬프트작성","프로젝트개요"]
---

## 이 문서의 목적
달록 PaceLog 개발 프로젝트의 **운영 철학과 관리 방식**을 명시한 핵심지침서.
추후 다른 프로젝트에도 동일한 체계를 도입·적용하기 위한 템플릿으로 활용.

---

## 1. 왜 이 체계를 만들었는가
프로젝트 오너(최창용)는 비개발자다. 방대한 섹션 트리를 머릿속에 담고 "이 작업이 어느 파트의 후속인지"를 직접 판단하는 것이 현실적으로 불가능하다.
따라서 [**Claude.ai**](http://Claude.ai)**가 그 역할을 대신한다.**

- [Claude.ai](http://Claude.ai)는 전체 맥락을 언제든 빠르게 복원할 수 있어야 한다
- 새 작업이 생겼을 때 오너가 "이게 어느 파트야?"를 고민할 필요 없이, [Claude.ai](http://Claude.ai)가 먼저 "이건 C파트 후속이니 C-5입니다"라고 제시한다
- 오너는 방향과 결정에만 집중하고, 맥락 추적·구조 관리는 [Claude.ai](http://Claude.ai)가 담당한다

---

## 2. 분업 구조

| 역할 | 담당 |
| --- | --- |
| 개발 방향 결정 | 오너 (최창용) |
| 기능 구현 | Claude Code / Codex |
| 맥락 추적·섹션트리 관리 | [Claude.ai](http://Claude.ai) |
| 핸드오프·개발일지 작성 | [Claude.ai](http://Claude.ai) |
| 파트-섹션 분류·후속작업 제시 | [Claude.ai](http://Claude.ai) |

---

## 3. 집-사무실 멀티 환경 동기화 운영 룰 (260524 확정)
달록 개발은 **집 환경**(`C:\!claude_home_worksapce\claude_code\dallog_git_home`)과 **사무실 환경**(`D:\dallog\dallog_git`) 두 위치에서 병행 진행된다. 환경 간 코드 동기화는 **GitHub 원격(**[**github.com/ccy-hansbridge/dallog**](http://github.com/ccy-hansbridge/dallog)**)을 단일 기준**으로 하며, zip 스냅샷·노션 업로드·외부 드라이브 동기화 등 보조 백업 체계는 사용하지 않는다.

### 3-1. 결정 배경
보조 백업 계층을 추가하는 대신 GitHub remote 단일 인프라만 활용한다.
- 사용자 작업 폼이 이미 포화 — 컨텍스트관리·작업시퀀스관리·git 선별 커밋 3종으로 운영 중. 보조 백업 추가 시 인지부담 증가 → 실수율 상승 우려.
- GitHub remote가 이미 인프라로 존재하므로 추가 도구 0.
- `git push/pull` + force push 금지만 지키면 **백섭(downgrade/rollback)이 구조적으로 불가능**.

### 3-2. 기본 미사용 옵션 (사용자 합의 시 도입 가능)
다음 보조 백업 방식은 기본적으로 도입하지 않는다 — 도입 필요 시 사용자 명시 합의 후 §3-6에 등재한다.
- zip 스냅샷 외부 드라이브 보관
- 노션 zip 업로드 보관
- 외부 클라우드(Google Drive, OneDrive 등) 동기화 폴더
→ 향후 [Claude.ai](http://Claude.ai), GPT, Claude Code 어느 주체도 위 보조 백업 도입을 먼저 제안하지 않는다. 사용자가 직접 요청한 경우에만 검토.

### 3-3. 확정 운영 룰 (양 환경 공통)
작업 시작 시 원격 동기화, 종료 시 즉시 push, force push 금지 — 이 4줄을 양 환경에서 동일하게 지킨다.
```javascript
[작업 시작]   git status  →  git pull --ff-only
[작업 중]    평소 선별 커밋 그대로 유지
[작업 종료]  git push  ← 자리 뜨기 전 무조건. 미루지 말 것.
[금지]       git push --force, 강제 머지 옵션
```
**핵심 안전장치:**
- `git pull --ff-only` — 원격이 앞서 있고 머지가 필요한 상황이면 자동으로 멈춰 알려준다 (그냥 `git pull`은 의도치 않은 머지를 만들 수 있어 금지).
- `git push` 즉시 수행 — 미푸시 커밋을 다음 환경 작업 시작 전까지 방치하지 않는다.
- `git push --force` 절대 금지 — 원격 히스토리 덮어쓰기는 백섭의 유일한 구조적 경로다.

### 3-4. 환경별 일회성 셋업
각 환경에서 한 번씩만 수행하면 영구 적용된다.
1. `git clone https://github.com/ccy-hansbridge/dallog.git`
2. `npm install`
3. `.env` 직접 작성 — `.env.example` 참고. Supabase URL/anon key는 Dashboard > Project Settings > API에서 복사. **anon key는 사용자가 Rotate 버튼 누르기 전까지 불변**이므로 한 번 채우면 평생 그대로 사용.
4. 작업 디렉토리 = git 저장소 루트가 일치하는지 확인 (서브폴더에 `.git`이 있는 이중 구조 금지).

### 3-5. 사고 복구 카드
GitHub 단일 기준이라도 사고 발생 시 다음 경로로 복구 가능하다.
- 실수로 force push로 덮음 → `git reflog`로 잃어버린 커밋 찾기 (90일 보존)
- 잘못된 머지 → `git reset --hard <이전커밋>`으로 되돌리기
- 로컬 통째로 날림 → 원격에 push만 돼 있었으면 다시 clone

### 3-6. 도입된 운영 자동화 (사용자 합의 기반)
사용자 명시 합의를 거쳐 도입된 보조 자동화는 아래에 등재한다. 미등재 자동화는 §3-2 원칙대로 도입 금지.
- **노션 체크리스트 자동 동기화 routine** (2026-05-24 도입)
	- Routine ID: `trig_01DxNE7MGrN9qBLCH9EmZPkR` — [관리 UI](https://claude.ai/code/routines/trig_01DxNE7MGrN9qBLCH9EmZPkR)
	- 대상: ✅ 작업 체크리스트 v6 페이지
	- 스케줄: 평일 08:03 KST 자동 실행 (Anthropic remote routine — 세션 종료·만료 무관 영구 작동)
	- 작업: ① v3 토글 안 코드블록을 본문 raw 최신본으로 교체 (사용자 체크·코멘트 자동 반영) ② 페이지 제목을 `✅ 작업 체크리스트_yymmdd-hhmm` 형식으로 갱신 ③ v3 헤더 직후에 "마지막 자동 갱신: YYYY-MM-DD HH:mm KST" timestamp 표기
	- 보존: 본문 체크박스·코멘트·다른 섹션은 사용자 변경 그대로 유지 (routine이 직접 수정 X)
	- GUI 편집 금지: v3 토글 안 코드블록은 자동 덮어쓰기 대상이므로 사용자가 직접 편집하지 않는다 (체크박스·코멘트는 노션 GUI에서 자유롭게 편집 → routine이 다음 실행 시 자동 동기화)

*추가: *[*Claude.ai*](http://Claude.ai)* × 최창용 | 2026-05-24*

---

## 4. 파트-섹션 트리 관리 원칙
1. **파트는 성격 기준으로 분류한다** — 기능 영역(인증, UI, 기록탭 등)이 같으면 같은 파트
2. **후속 작업은 파트를 새로 만들지 않는다** — 연관 파트에 C-5, F-5 형태로 추가
3. **파트 증식은 최소화한다** — 성격이 완전히 다른 신규 영역일 때만 새 파트 생성
4. **완료·예정 모두 트리에 표시한다** — ✅ 완료 / ⏳ 예정으로 구분
5. **진행 순서와 의존성을 명시한다** — 병렬 가능 여부, 선행 조건 표기

---

## 5. 개발노트·일지 체계 원칙
1. **컨텍스트 종료 시마다 핸드오프 발행** — 다음 컨텍스트가 재서칭 없이 시작 가능하도록
2. **대화록은 주기적으로 작성** — 1섹션 종료마다 / 1시간 단위 / 요청 시
3. **핸드오프 하위에 대화록 링크** — `yymmdd-hh:mm대화록_N` 형식
4. **Claude Code 작업보고는 노션에 raw 전체 업로드** — 이슈 추적·개발 스터디 목적
5. **파트-섹션 트리는 핸드오프마다 최신화** — 완료 항목 ✅, 신규 예정 항목 추가

---

## 6. 컨텍스트 전환 시 [Claude.ai](http://Claude.ai)의 의무
새 컨텍스트를 시작한 [Claude.ai](http://Claude.ai)는 반드시:
1. 핸드오프 노션 페이지 읽기
2. 파트-섹션 트리 현황 파악
3. 다음 작업(⏳)과 선행 조건 확인
4. 오너에게 "현재 위치"와 "다음 할 일"을 먼저 브리핑

---

## 7. 파트-섹션 트리 (최신화: 2026-05-18)
```javascript
A파트 — Claude.ai 직접 개발 (5/13, git 도입 전) ✅
  A-1: dallog-v0.1.0 — 프로젝트 최초 생성 (Dashboard/LogEntry/History/CoachNotes 4탭)
  A-2: dallog-main — main 브랜치 베이스 스냅샷
  A-3: dallog-v0.2.0 — Settings 탭 추가
  A-4: dallog-v1.0.0 — StrengthLog 탭 추가
  A-5: dallog-v1.1.0 — RunningSummary + Settings ChangeLog 추가

B파트 — v2.0 기반 구축 (섹션1~3) ✅
  B-1: 섹션1 1단계 DB타입 + 2단계 기록탭 3탭 통합
  B-2: 섹션1 2~4단계 기록탭·히스토리·대시보드
  B-3: 섹션1 4·5단계 + 섹션2 UI개편 + 피드백 반영
  B-4: 기록탭 통합 및 기록하기 버튼 신설

C파트 — 인증·백엔드 인프라 ✅→⏳
  C-1: 로그인 기능 구현 ✅
  C-2: CF Workers AI 브리프 프록시 구축 ✅
  C-3: 마스터로그인 수정 + 데모타이틀 변경 ✅
  C-4: 데모버전 구축 및 main 통합 ✅
  C-5: 로그아웃 버튼 + 계정설정 UI 실기능 ⏳ ← 다음 개발 재개점

D파트 — 기록탭 고도화 ✅
  D-1: 기록탭 달력 UX + 체성분 Summary 혼합차트
  D-2: 러닝·근력 summary 개선 + 종목 선택 2단계
  D-3: 체성분 상세 증감수치 부수표기
  D-4: 근력운동 v2 저장/루틴 + 운동종목 등록 개편

E파트 — 코치노트·AI브리프 기능 ✅
  E-1: 코치노트 3컬럼/체중차트/달력축소/키워드 드롭다운
  E-2: AI에게보내기/AI브리프지침/시각화카드/런타임잠금해제
  E-3: AI브리프 에이전트 화법·구조 개편 + 관리UI
  E-4: 코칭브리프 마크다운 통일 + 체성분-only 시각화
  E-5: 설정탭 AI에게 보내기 버튼 추가

F파트 — UI/UX 조정 ✅→⏳
  F-1: 대시보드 BODY 증감수치 + 기록일 표기 (16+17 합본) ✅
  F-2: 버튼 위치 변경 4종 ✅
  F-3: AI에게보내기 클립보드 전환 + 핸드오프 재구성 ✅
  F-4: 아이콘·스플래시 + AI브리프 CORS 수정 ✅
  F-5: 체성분 Summary Y축 재설계 ✅ (v1~v5 완료, 커밋 d83f1fc)
  F-6: 데스크탑 1920px 레이아웃 최적화 ⏳ (진행 중)
  F-6b: 하단Nav·설정탭 아이콘 교체 SVG ⏳ (F-6 병렬, GPT 제작)
  F-6c: 데스크탑 사이드바 전환 ⏳ (F-6 완료 후)
  F-7: 다크/라이트/시스템 테마 설정 ⏳ (I-0 완료 후)
  F-8: 기록탭 Supabase 서버사이드 집계 성능 최적화 ⏳ (퇴근 후 홈워크)

G파트 — 브랜딩·배포·피트니스 연동 ✅→⏳
  G-1: 데모버전 파비콘 SVG 교체 ✅
  G-2: 로그인페이지 달록 브랜딩 + 병렬 에이전트 커밋 충돌 ✅
  G-3: 체성분 피트니스 프로젝트 연동 UI 통합 ✅
  G-4: 멀티유저 + 지인 배포 ⏳ (보안점검 전항목 완료 후)

I파트 — 사용자 프로필 기능 ⏳
  I-0: 프로필 더미페이지 + 기본 아이콘 사전 준비 ⏳ (F-6c 직후)
  I-1: 프로필 대시보드 (공개여부 선택 가능) ⏳ (G-4 이후)
  I-2: SNS형 타임라인 공개 ⏳
  I-3: 하단 우측 프로필 아이콘 진입점 ⏳

진행 순서: F-6 → (F-6b 병렬) → F-6c → I-0 → F-7 → F-8(홈워크) → H → G-4
인코딩 정상화: 정식배포 직전 또는 외부 협업 필요 시점에 별도 작업 예정
```

---

## 8. 다른 프로젝트 적용 시
이 체계는 달록에 국한되지 않는다. 아래 요소를 갖추면 어느 프로젝트에든 동일하게 적용 가능:
- 노션 워크스페이스 (프로젝트 루트 페이지)
- 핸드오프 페이지 (컨텍스트 간 맥락 이전)
- 개발일지/대화록 페이지
- Claude Code 작업보고 페이지
- 파트-섹션 트리 (이 문서 또는 별도 페이지)

---

*작성: *[*Claude.ai*](http://Claude.ai)* × 최창용 | 2026-05-18*
*이 체계는 달록 PaceLog를 기반으로 정립되었으며, 추후 모든 프로젝트에 확장 적용 예정.*

---

## 9. Claude Code 프롬프트 작성 템플릿 (매 프롬프트 준수)
> 실제 G-2 작업보고 기준으로 정립된 표준 템플릿. 모든 Claude Code 프롬프트는 아래 구조를 준수할 것.

### 9-1. 프롬프트 작성 전 선행 절차 (필수)
프롬프트 작성 전 반드시 PowerShell로 실제 파일 구조를 먼저 파악할 것.
```javascript
Get-ChildItem -Path D:\dallog\dallog_git\src -Recurse -Include *.tsx,*.ts | Select-Object FullName | Sort-Object FullName
```
파일 구조 미확인 시 파일 지시 오류 → 병렬 에이전트 충돌 발생 사례 있음 (BodySection.tsx 등 서브컴포넌트 분산 구조).

### 9-2. 프롬프트 구조 템플릿
**① 병렬 작업 주의 문구 (맨 앞 고정 — 항상 포함)**
```javascript
※ 주의: 동일 작업을 수행 중인 다른 에이전트가 있을 수 있음.
작업 시작 전 git status로 작업트리 상태를 확인한다.
미커밋 변경사항이 있으면 작업을 중단하고 보고한다.

원격 최신 여부 확인은 git fetch로만 수행한다.
git pull은 임의 실행하지 않는다.
단, 사용자가 명시적으로 최신 원격 기준 동기화를 지시한 경우에만,
작업트리가 깨끗한 상태에서 git pull --ff-only를 실행한다.
충돌 또는 merge 필요 상황이면 즉시 중단하고 보고한다.
```
> ⚠️ 수정 이유 (260520): 기존 `git pull` 지시는 "git 작업 없음" 원칙과 충돌. git pull은 작업트리를 변경할 수 있는 git 작업이므로 `git fetch` + 조건부 `git pull --ff-only`로 교정. (GPT 2차 검수 반영)

**② 작업 목표** — 1~2줄 핵심 요약
**③ 수정 파일** — 사전 파일구조 확인 후 대상 파일 명시 (추정 금지)
**④ 구현 내용** — 번호 리스트, 구체적 스펙 기술
**⑤ 레이아웃 설계 원칙 (UI 작업 시 고정 포함)**
```javascript
데스크탑 최적 컨테이너 우선 설계 후 모바일 반응형(햄버거/스택) 적용.
모바일 퍼스트 설계 금지.
```
**⑥ 주의사항** — 건드리지 말 것, 유지할 것 명시
**⑦ 완료 기준** — 체크 가능한 항목으로 명시 (npm run build 포함)
**⑧ git 스테이징 원칙 (코드 수정 작업에만 적용)**
```javascript
git add <수정파일 경로> 형식으로만 스테이징할 것.
git add . 또는 git add -A 절대 금지.
```
> ※ 읽기 전용 작업(노션 문서 산출, 분석 등)에서는 ⑧을 적용하지 않는다.
> 읽기 전용 작업 프롬프트에는 스테이징 문구를 완전히 제거하고, git add / commit / push 전면 금지를 명시한다.

**⑨ 노션 자기 업로드 (맨 뒤 고정 — 항상 포함)**
```javascript
완료 후 노션 Claude Code 작업보고 페이지
(#/doc/workreport-index)에
전체 대화 raw 그대로 새 하위 페이지로 업로드할 것.
페이지 제목: yymmdd-hh:mm_파트섹션-작업명
(예: 260519-10:30_C5-로그아웃버튼)
```

### 9-3. 병렬 에이전트 운영 원칙
- 같은 파일을 동시에 수정하는 에이전트 조합 금지
- 각 에이전트 작업 시작 전 수정 예정 파일 목록 먼저 확인
- 섹션 간 의존성이 있는 경우 선행 작업 완료 확인 후 후행 작업 시작
- [Claude.ai](http://Claude.ai)는 프롬프트 제공 전 반드시 실제 디렉토리/파일 구조 먼저 확인

---

## 10. 달록 개발 현황 문서 체계 (2026-05-20 확정)
### 10-1. 노션 구조
"📁 달록 PaceLog" 하위에 **"달록 개발 현황"** 페이지를 생성한다.
기존 핸드오프 / 개발일지 / Claude Code 작업보고 / 달록 개발 운영 핵심지침과 동격.
"달록 개발 현황" 하위 4개 메인 페이지 (고정 페이지명 — 날짜 붙이지 않음):
1. **달록(PaceLog)설명서** — 외부 설명자료 원천 문서 (PPT·카탈로그·리플렛 등)
2. **기능설명서** — Claude Code가 소스코드 기반으로 산출한 기능 설명 문서
3. **UI시각화 내용 설명서** — Claude Code가 소스코드·레이아웃 구조 기반으로 산출한 UI 구조 설명 문서
4. [**Claude.ai**](http://Claude.ai)** MCP브라우징 보고서** — [Claude.ai](http://Claude.ai)가 MCP 브라우징으로 실제 화면 확인 후 작성하는 리포트

### 10-2. 이전버전 보관 규칙
- 메인 페이지는 항상 최신 상태로 덮어쓴다
- 덮어쓰기 전 기존 본문은 해당 메인 페이지의 **하위 페이지**로 보관
- 보관 페이지명 형식: `문서명_yymmdd_n`
	- 예: `기능설명서_260520_1`, `UI시각화 내용 설명서_260521_2`
	- yymmdd = 한국시간 기준 작성일 / n = 같은 날 동일 문서 버전 순번
- 초기 생성 시 기존 본문 없으면 보관 페이지 생성 생략
- 메인 페이지 하단에 **이전버전 링크 리스트** 섹션 항상 유지

### 10-3. 최신화 트리거 운영 규칙 (공통)
Claude Code는 임의로 자동 업데이트·예약 실행하지 않는다.
**기능설명서 / UI시각화 내용 설명서 최신화 흐름:**
[Claude.ai](http://Claude.ai)가 주요 기능·UI 업데이트로 최신화 필요 판단 → 사용자 승인 → [Claude.ai](http://Claude.ai) 프롬프트 산출 → 사용자가 Claude Code에 전달 → Claude Code 수행
[**Claude.ai**](http://Claude.ai)** MCP브라우징 보고서 최신화 흐름:**
[Claude.ai](http://Claude.ai)가 주요 기능·UI 업데이트로 최신화 필요 판단 → 사용자 승인 → [Claude.ai](http://Claude.ai)가 직접 MCP 브라우징 후 보고서 작성·업로드

### 10-4. 각 문서 역할 요약

| 문서 | 작성 주체 | 이번 초기 작업 |
| --- | --- | --- |
| 달록(PaceLog)설명서 | 향후 종합 작성 | 빈 페이지 + 작성 의도 placeholder만 |
| 기능설명서 | Claude Code (소스코드 기반) | 실제 본문 작성·업로드 |
| UI시각화 내용 설명서 | Claude Code (소스코드 기반) | 실제 본문 작성·업로드 |
| [Claude.ai](http://Claude.ai) MCP브라우징 보고서 | [Claude.ai](http://Claude.ai) (MCP 브라우징) | 빈 페이지 + 작성 의도 placeholder만 |

---

### 10-5. 달록(PaceLog)설명서 최신화 트리거 (2026-05-20 확정)
"달록(PaceLog)설명서"는 외부 설명자료(PPT, 카탈로그, 리플렛, 소개서)의 원천 문서이므로,
단순 기능 수정이나 UI 일부 변경만으로 자동 최신화하지 않는다.
최신화 트리거는 아래 조건 중 하나가 충족될 때로 한다.
1. 기능설명서, UI시각화 내용 설명서, [Claude.ai](http://Claude.ai) MCP브라우징 보고서 중 **2개 이상**이 새 버전으로 갱신되었을 때
2. 달록의 **핵심 기능, 사용 흐름, 타깃 사용자, 서비스 포지셔닝, 과금/상품화 방향**이 변경되었을 때
3. 사용자가 PPT, 카탈로그, 리플렛, 소개서 등 **외부 설명자료 제작을 준비**한다고 판단될 때
4. [Claude.ai](http://Claude.ai)가 컨텍스트상 최신화가 필요하다고 판단하고 사용자에게 추천했으며, **사용자가 승인**했을 때

**최신화 흐름:**
[Claude.ai](http://Claude.ai)가 최신화 필요 판단
→ 사용자에게 업데이트 추천
→ 사용자 승인
→ [Claude.ai](http://Claude.ai)가 기능설명서 + UI시각화 내용 설명서 + [Claude.ai](http://Claude.ai) MCP브라우징 보고서 + 핸드오프/대화록의 사용자 개발 의도를 종합
→ [Claude.ai](http://Claude.ai)가 "달록(PaceLog)설명서" 본문 초안 작성
→ 사용자가 검토 및 승인
→ 필요 시 Claude Code가 노션의 "달록(PaceLog)설명서" 메인페이지를 최신화

**제한:**
Claude Code는 소스코드만 근거로 "달록(PaceLog)설명서"를 임의 작성하지 않는다.
이 문서는 제품 소개·외부 전달·사업적 설명을 포함하므로, [Claude.ai](http://Claude.ai)가 사용자 의도와 대화 맥락을 반영해 작성하는 것을 원칙으로 한다.

### 10-6. 참조 프롬프트
달록 개발 현황 문서 체계 산출을 위한 Claude Code 프롬프트(A안) 확정판 + 보완 히스토리는 아래 페이지에 저장되어 있다.
상세 내용: [**📋 달록 개발 현황 산출 프롬프트 (A안) — 확정판 v1 (260520)**](https://www.notion.so/36622962086881b1ae1cf7af55ca1c27)
(v0 초안 → GPT 1차 검수 반영 v1 → GPT 2차 검수 반영 v2 = 현행 확정판)

---

*추가: *[*Claude.ai*](http://Claude.ai)* × 최창용 | 2026-05-20*

- 📄 [📋 달록 개발 현황 산출 프롬프트 (A안) — 확정판 v1 (260520)](https://app.notion.com/p/36622962086881b1ae1cf7af55ca1c27)

---

## 11. MCP브라우징 보고서 작성 방식 변경 (260520 확정)
> ⚠️ MCP브라우징 보고서는 Claude Code가 직접 수행·작성·업로드한다.
> [Claude.ai](http://Claude.ai)는 MCP브라우징 보고서 작성 주체에서 제외한다.

**작성 주체:** Claude Code
**Claude Code 역할:**
Playwright MCP 브라우징 수행 → 전체 기능·UI 보고서 Markdown 작성 → 지정 경로에 보고서 파일 저장 → 노션 지정 페이지에 업로드
[**Claude.ai**](http://Claude.ai)** 역할:**
MCP브라우징 보고서 작성·수행·업로드에 관여하지 않는다.
단, 사용자가 요청할 경우 Claude Code에 전달할 프롬프트 초안 검수 또는 보고서 품질 검수만 수행한다.

**보고서 범위 (불변 템플릿 — 기능/UI 업데이트에도 구조 변경 금지):**
- 전체 기능 해석: 각 페이지·기능의 목적과 작동 방식
- 전체 기능 정상작동 여부: 각 인터랙션, 데이터 연동, 오류 여부
- UI 시각 전체 평가: 레이아웃, 컨테이너, 셀 구성, 아이콘 적용 적절성, 각 요소의 크기, 디자인 적절성
- 심미적 평가: 사용자(인간) 관점에서의 깔끔함, 어우러짐, 어색하지 않음, 전반적 디자인 완성도
- 반응형 평가: Desktop / Tablet / Mobile 기준 레이아웃 안정성, 터치 영역, 가독성, 가로 스크롤 여부

**최신화 흐름:**
기능/UI 주요 업데이트 발생
→ 사용자 판단 또는 [Claude.ai/GPT](http://Claude.ai/GPT) 검수 과정에서 MCP브라우징 보고서 최신화 필요성 확인
→ 사용자 승인
→ Claude Code가 Playwright MCP 브라우징 수행
→ Claude Code가 Markdown 보고서 작성
→ Claude Code가 지정 경로에 보고서 파일 저장
→ Claude Code가 노션의 `Claude.ai MCP브라우징 보고서` 페이지를 최신화
→ 기존 본문이 있는 경우 하위 이전버전 페이지로 복사 보관 후 메인 페이지 교체

**주의사항:**
- 보고서는 수정결과 체크 보고서가 아니라, 브라우징 시점 기준의 전체 기능·UI 상태 보고서로 작성한다.
- 기능/UI가 업데이트되어도 보고서 구조는 변경하지 않는다.
- Claude Code는 브라우징 중 발견한 문제를 직접 수정하지 않고 보고서에만 기록한다.
- 코드 수정, git add, git commit, git push는 별도 작업 지시가 없는 한 수행하지 않는다.

---

## 12. 컨텍스트 포화도 보고 트리거 (260520 확정)
30% / 50% / 80% / 90% 초과 시마다 사용자에게 현재 포화도를 보고한다.
모든 달록 컨텍스트에 공통 적용. 생략 금지.

*추가: *[*Claude.ai*](http://Claude.ai)* × 최창용 | 2026-05-20*

---

## 13. 역할 분업 구조 전환 (260520 확정)
기존 [Claude.ai](http://Claude.ai)가 담당하던 프롬프트 직접 작성 역할을 GPT로 이관한다.

| 역할 | 담당 |
| --- | --- |
| 플래닝 / 의사결정 지원 | 창용님 |
| 맥락 추적 / 섹션트리 / 핸드오프·대화록 | [Claude.ai](http://Claude.ai) |
| GPT에게 프롬프트 작성 가이드 제공 | [Claude.ai](http://Claude.ai) |
| 프롬프트 실제 작성 + 교차검수 | GPT |
| 코드 작업 / 브라우징 / 리포팅 / 노션 업로드 | Claude Code / Codex |

[Claude.ai](http://Claude.ai)가 GPT에게 제공하는 가이드 형식:
- 작업 목표 요약
- 수정 대상 파일 또는 노션 경로
- 적용할 체크리스트 항목 번호 명시
- 읽기전용 여부 명시
- 특이사항 또는 예외 규칙

이 구조의 목적:
- [Claude.ai](http://Claude.ai) 컨텍스트 소모 최소화
- [Claude.ai](http://Claude.ai)는 맥락 추적·방향 판단에 집중
- 프롬프트 작성·검수 부담은 GPT가 전담
- Claude Code / Codex는 실행, 브라우징, 리포팅, 노션 업로드에 집중

**운영 원칙:**
- 사용자는 작업 목표와 예외사항만 간단히 전달한다.
- [Claude.ai](http://Claude.ai)는 맥락과 작업 의도를 정리해 GPT에게 전달할 가이드를 만든다.
- GPT는 확정 체크리스트 기준으로 Claude Code / Codex용 프롬프트를 작성한다.
- Claude Code / Codex는 제공된 프롬프트에 따라 실행한다.
- 복잡한 신규 체계, git 작업, 노션 구조 변경, 외부 시스템 연동 작업은 GPT 교차검수 후 투입한다.

*추가: *[*Claude.ai*](http://Claude.ai)* × 최창용 | 2026-05-20*

- 📄 [🗄️ SQL 쿼리 관리 지침 (골든셋 체계)](https://app.notion.com/p/36f2296208688118b1d4d98a95bfd186)