---
name: progress-log
description: "작업의 진행 상태를 노션 단일 소스에 기록하여, 새 대화에서 이 페이지만 읽고 작업 목적·맥락·현재 위치·우선순위를 파악해 즉시 이어갈 수 있게 한다. 작업이 완료·중단·종료되었거나, 진행 중인 맥락을 다음 대화로 넘겨야 할 때 발동한다. 대표 트리거: '마무리해', '노션 갱신해', '정리해줘', '이어가기용 정리', '결과 정리'. 노션 직접 기록 + 다음 대화 시작 문구 자동 생성이 이 스킬의 필수 출력. 별도 .md 파일은 출력하지 않는다."
---

# 진행 기록 (Progress Log)

## 이 스킬의 목적
작업의 진행 상태를 노션 단일 소스에 기록하여, 새 대화에서 이 페이지만 읽으면 작업의 목적·맥락·현재 위치·우선순위를 파악하고 즉시 이어갈 수 있게 한다.

## 핵심 원칙

### 노션 단일 소스
- 모든 기록은 노션 프로젝트 진행현황 허브 하위에 페이지로 작성한다
- 별도 .md 파일을 출력하지 않는다
- 노션 접근 실패 시에만 폴백: 사용자에게 오류를 보고하고 인라인으로 내용을 제시한다

### 기록 상세도
- "다음 대화에서 이 페이지만 읽고 바로 작업을 이어갈 수 있는가?"가 상세도 기준이다
- 확정된 결정은 근거를 포함한다 (근거 없는 결정은 다음 대화에서 재논의될 위험)
- 폐기된 방향은 이유를 포함한다 (이유 없는 폐기는 같은 논의가 반복될 위험)
- "계속 진행", "추후 검토" 같은 모호한 표현 금지. 구체적으로 무엇을 어떻게 하는지 명시
- 확정 사항에는 구체값(시간·수치·조건·기준)을 반드시 포함한다. "저녁 고정 확정"이 아니라 "저녁 17:30~21:30 고정 확정"처럼, 다음 대화에서 이 값 없이 작업을 재개할 수 없는 정보는 반드시 기록한다

### 산출물 저장 규칙
- 모든 산출물은 노션에 기록한다
- 맥락 복원에 즉시 필요한 정보(목적, 상태, 결정, 다음 작업)는 페이지 본문에 직접 작성
- 분량이 큰 산출물(코드 전문, 긴 설정 파일 등)은 토글 또는 하위 페이지로 기록
- 토글 vs 하위 페이지 판단 기준:
  - 토글: 해당 페이지 안에서 바로 펼쳐 볼 수 있어야 편한 경우 (짧은 코드, 설정 일부)
  - 하위 페이지: 독립적으로 참조될 수 있는 분량인 경우 (전체 스크립트, 대규모 산출물)
- 사용자가 토글↔하위 페이지를 자유롭게 재구조화해도 접근에 지장 없음

## 실행 절차

### 1단계: 작업 상태 판별
스킬 실행 시 현재 작업의 상태를 판별한다. 불분명하면 사용자에게 확인.

| 상태 | 판별 기준 | 페이지 구조 차이 |
|------|----------|----------------|
| 진행 중 | 미해결 항목이 있거나 다음 작업이 남아 있음 | 미해결 항목 섹션 포함. 현재 위치·우선순위 강조 |
| 단일 완료 | 하나의 작업이 목표를 달성함 | 미해결 항목 없음. 후속 작업(있으면) 분리 |
| 복합 완료 | 하위 작업 2개 이상이 포함된 프로젝트 완료 | 작업 흐름·하위 작업별 결과·교차 의존성 추가 |

### 2단계: 맥락 수집
기록 작성 전 아래 순서로 맥락을 확보한다. 앞 단계에서 충분하면 다음 단계로 넘어가지 않는다.

1. 노션 허브 확인 (최우선) — 프로젝트 진행현황에서 해당 프로젝트 페이지를 찾아 읽는다. 기존 기록이 있으면 갱신, 없으면 신규 생성.
2. 현재 대화 맥락 — 이번 대화에서 논의된 내용을 활용한다.
3. 대화 검색 — 위 두 가지로 부족하면 대화 검색을 사용한다. 3회 검색 후에도 관련 결과가 없으면 사용자에게 보고하고 방향을 확인한다. 무한 검색하지 않는다.

맥락 수집 없이 기록을 작성하지 않는다.

### 3단계: 노션 페이지 작성
허브 페이지(프로젝트 진행현황, ID: 33d5c8337ae6803cb348f51740552e76) 하위에 해당 작업 페이지를 생성 또는 갱신한다.

#### 공통 구조 (모든 상태)

## 작업 목적
[이 작업이 달성하려는 것 — 1-2문장]

## 현재 상태

…[TRUNCATED]