# life-helper 작업 로그

> 다음 세션 재개용. 메모리 인덱스(`~/.claude/projects/-Users-joungminko-claude-workspace-life-helper/memory/MEMORY.md`)와 함께 읽으면 전체 컨텍스트 복원 가능.

---

## TL;DR

Andrew Huberman 신경과학 프로토콜을 바탕으로 한 **개인 습관/체크리스트/투두 시스템** 설계 진행 중. SoT 문서 4개 (huberman / methodologies / breaking / nutrition) + JSON Schema 데이터 모델 18개 완료. **현재 dose variant(컨디션·환경별 도즈 변동) 설계 결정 대기 중** — PC 재부팅 후 여기서 재개.

---

## 현재 파일 트리

```
life-helper/
├── SESSION-LOG.md                  ← 본 문서
├── MEMORY.md                       (사용자 메모리 인덱스 사본 — deprecated, 진짜 인덱스는 ~/.claude/projects/.../memory/MEMORY.md)
│
├── huberman-protocols.md           (v4) — 29개 Huberman 원자 프로토콜. §1.9는 nutrition으로 이관됨 (stub)
├── habit-todo-methodologies.md     — 21개 방법론 + 지속가능성 가이드 + 5-Tier Reward + L0~L3 프레임
├── habit-breaking-protocols.md     — 끊기 8개 카테고리 + 공통 프레임 5개 + 의학적 면책
│
├── nutrition/                      ← 식이 모듈 (별도 폴더)
│   └── diet-protocols.md           — 6개 원칙 + 5개 식이 패턴 + 한국 환경 + 한국어 해설자 빈 슬롯
│
└── schema/                         ← JSON Schema 데이터 모델 18개
    ├── _index.json                 (인덱스 + R1~R8 운영 규칙)
    ├── enums.schema.json
    ├── reference.schema.json
    ├── (카탈로그 6) protocol, break_protocol, common_frame, methodology, frame_pattern, reward_menu_item
    └── (유저 10) user, phase, habit, if_then_rule, tracker_entry, lapse_log, urge_log, reward_declaration, reward_claim, reflection
```

추가로 데이터 모델 설계 문서: `data-model.md` (위 schema의 entity 관계 + 운영 규칙 + 예시)

---

## 작업 흐름 (시간 순)

### Phase 1 — Huberman 프로토콜 SoT 구축
1. Huberman의 명상·동기부여·습관·건강 전 자료를 마크다운으로 수집 → `huberman-protocols.md` v1
2. "How to (실행 절차)" 통일 구조로 재작성 → v2 (옵션 B 선택, 7필드 통일)
3. 모든 항목에 참고문헌(scalar) 추가 → v3
4. 미확인 항목 웹 검색 매핑 검증 (33개 항목 검증, 8개 정정) → **v4 (현재 버전)**

### Phase 2 — 방법론 카탈로그
5. 21개 유명 방법론 리서치 (Franklin/GTD/Pomodoro/Atomic Habits/Tiny Habits/Bullet Journal/PARA/Time Blocking/OKR/WOOP/Implementation Intentions 등)
6. Atomic Habits를 "본 프로젝트 핵심 운영 엔진"으로 명시 + "질리지 않게 + 짧고 간단" 6 가드레일 추가
7. 5-Tier Reward Ladder 추가 (T0~T4: 매일/3회 스트릭/주/월/6주). 사용자가 "3회 스트릭" micro-milestone을 직접 발명
8. Lakoff 코끼리 회피 관점에서 L0/L1/L2/L3 언어 프레이밍 변환 추가

### Phase 3 — 끊기 모듈
9. 일반 사용자 대상 끊고 싶은 행동 (AV/자위·담배·술·SNS·설탕·카페인·대마·행동중독) 리서치
10. `habit-breaking-protocols.md` 신규 — 공통 프레임 5개 (Dopamine Reset / Urge Surf / Environment Design / Relapse Recovery / Recovery Stack) + 카테고리 8개 + 의학적 면책 + 한국 상담전화

### Phase 4 — 데이터 모델 (앱화)
11. JSON Schema 형식 선택 (단일/멀티 둘 다 user_id 기반 호환)
12. `data-model.md` 설계 문서 + `schema/*.json` 18개 작성
13. 운영 규칙 R1~R8을 schema enum + application layer + UI 3층으로 강제

### Phase 5 — 식이 모듈 분리
14. 식이를 별도 폴더로 이관: `nutrition/diet-protocols.md`. 폴더명은 사용자 제안 `health-eating` 대신 `nutrition` (학술 톤).
15. `huberman-protocols.md` §1.9 stub만 남기고 nutrition으로 이관. §6 Daily Minimum 참조 경로 갱신.
16. 한국 인플루언서(선시티5스타·최겸)는 §6 *사용자 채움 빈 슬롯*으로 처리 — 본 SoT의 peer-reviewed 톤 유지.

### Phase 6 — Dose Variant (진행 중, 재개 대기)
17. 사용자 제안: "컨디션·환경별 도즈 옵션 (짐 vs 집, 컨디션 좋음 vs 나쁨)"
18. AI 분석 완료 (BJ Fogg Tiny Habits 원전 호환, 본 시스템과 가드레일 친화 검증)
19. **3개 옵션 + tiny 남용 방지 장치 AskUserQuestion 직전에 PC 재부팅 요청 → pending**

---

## 핵심 결정사항 (메모리 인덱스)

본 프로젝트의 모든 메모리는 `~/.claude/projects/-Users-joungminko-claude-workspace-life-helper/memory/MEMORY.md`에서 자동 로드됨. 6개 엔트리:

1. **life-helper 프로젝트 목표** (`project_life_helper_goal.md`)
2. **지속가능성 & 최소 운영 원칙** (`feedback_sustainable_minimal.md`) — 6 가드레일
3. **5-Tier Reward Ladder 채택** (`feedback_reward_ladder.md`) — 매일 보상 X, 누적 milestone ✓
4. **언어 프레이밍 — 코끼리 회피** (`feedback_positive_framing.md`) — L2/L3 강제
5. **습관 없애기(Break) 모듈** (`project_habit_breaking_module.md`)
6. **데이터 모델 v1 결정사항** (`project_data_model_decisions.md`)
7. **식이·영양 모듈** (`project_nutrition_module.md`)

**핵심 운영 가드레일 요약**:
- 동시 active build habit ≤ 3 + active break habit ≤ 1
- 일일 운영 ≤ 2분 (tracker 30~60초)
- frame.level ∈ {L2, L3} (L0/L1 거부)
- tracker_entry.value = done/blank 2값
- phase = 6주 사이클, 중간 anchor 변동 X
- reward는 매일 직후 X, 누적 milestone(T0~T4) ✓ + 사전 선언
- "Never miss twice" (1회 결석은 데이터, 2회 연속이 패턴)
- 끊기는 일반 사용자 대상. 임상 중독은 의료진 우선

---

## 진행 중 / 재개점 (Pending)

### Pending #1 — Dose Variant 설계 결정 (재개 1순위)

**문제**: 현재 `tracker_entry.value` = done/blank 2값. 사용자가 컨디션 나쁘거나 짐 못 갔을 때 풀 도즈 못 하면 blank → lapse → 자책 → abandonment 위험.

**제안**: habit당 dose variant 여러 개 등록 → 컨디션·환경에 맞춰 선택 → tiny variant로도 스트릭 유지.

**학술 근거**: BJ Fogg *Tiny Habits* "Recipe" 챕터 + Lally 2010 자동화 곡선 (빈도 > 강도) + Guise *Mini Habits* (2013).

**호환성 검토 완료**: 6 가드레일 모두 통과. Never miss twice 가드레일은 *오히려 강화*.

**결정 대기 옵션 (재개 시 사용자에게 다시 제시)**:

| 옵션 | 구조 | 평가 |
|------|------|------|
| **A. 표준 3단계 + 컨텍스트 태그** (Recommended) | level: tiny/normal/strong enum + context_tags 자유입력 (짐/집/출장) | 직관 + 교차 집계 + UI default=normal |
| B. 자유 variant 배열 | level enum 없이 habit당 1~4개 variant 자유 정의 (label + dose_text + is_minimum) | 유연성 최대 |
| C. 컨디션 × 컨텍스트 매트릭스 | 2축 독립 관리 | 가장 정밀하지만 가드레일 #2 위반 위험 |

**Tiny 남용 방지 옵션**:
- a. 주간 알림만 (Recommended) — reflection에 "지난 주 normal 비율" 표시
- b. 장치 없음
- c. Streak 가중치 (tiny는 0.5x)

**작업 시 변경 위치 (옵션 A 채택 가정)**:
1. `schema/habit.schema.json` — `dose_variants[]` 추가
2. `schema/tracker_entry.schema.json` — `variant_id` 옵션 추가
3. `schema/enums.schema.json` — `DoseVariantLevel` enum 추가
4. `data-model.md` §3 R9 (variant ≤ 4) 추가
5. SoT 마크다운 4개에 "도즈 변동" 가이드 짧게 추가
6. 신규 메모리 `feedback_dose_variants.md`

### Pending #2 — 다음 단계 옵션 (Dose variant 후 진행)

- (A) `seed/*.json` — Huberman 29 + diet 6 + break 8 + methodology 21 카탈로그 데이터 채우기
- (B) Ajv 등 schema 검증기
- (C) UI 와이어프레임 (트래커 30초 화면)
- (D) §6 한국어 해설자 빈 슬롯 채우기 (사용자 직접)
- (E) 알림/cron 트리거 설계
- (F) Apple Health / Google Fit 통합

---

## 재개 가이드 (다음 세션 시작 시 AI에게)

> "PC 재부팅 후 재개. `SESSION-LOG.md` 읽고 Pending #1 (dose variant) 결정부터 다시 물어봐 줘."

또는 더 간단히:

> "dose variant 디자인 결정부터 다시 시작하자."

AI는 자동으로 메모리 인덱스에서 운영 원칙(L2/L3, 6 가드레일, 5-Tier, ≤3 빌드+≤1 브레이크 등)을 로드함. 본 문서로 진행 흐름 보강.

---

**문서 생성일**: 2026-06-08
**다음 재개 예상 작업**: Dose Variant 옵션 A/B/C 결정 → schema 확장 → 4개 SoT 마크다운에 가이드 추가