---
allowed-tools: [Read, Edit, Bash, Glob, Grep]
description: "프로젝트 진행 상황 조회, 업데이트, 분석"
---

# /progress - 프로젝트 진행 상황 관리

## 사용법
```
/progress              — 현재 진행 상황 조회
/progress update       — 코드 상태 분석 후 PROGRESS.md 자동 업데이트
```

## 실행 흐름

### 조회 (인자 없음)
1. `PROGRESS.md` 파일을 읽는다
2. 완료/진행 중/대기 항목 수를 집계한다
3. 진행률(%)과 함께 요약을 출력한다
4. 진행 중 항목을 ▶ 마커와 함께 나열한다 (없으면 생략)
5. 대기 항목을 번호와 함께 나열한다
6. 최근 변경 이력 3건을 표시한다

### 업데이트 (`update` 인자)
1. `git log --oneline -10`으로 최근 커밋을 확인한다
2. `src/` 디렉토리를 Glob/Grep으로 분석하여 실제 구현 상태를 파악한다:
   - `src/stores/` 에 `.ts` 파일이 있으면 → Zustand 스토어 완료
   - `src/components/` 에 `.tsx` 파일이 있으면 → UI 컴포넌트 완료
   - `src/screens/` 에 `.tsx` 파일이 있으면 → 화면 구현 완료
   - `src/hooks/` 에 `.ts` 파일이 있으면 → 훅 구현 완료
3. 분석 결과에 따라 `PROGRESS.md`의 체크리스트를 업데이트한다:
   - 완료된 항목: `[ ]` → `[x]`, 해당 섹션을 "완료"로 이동
   - 새로 발견된 작업이 있으면 "대기"에 추가
4. 변경 이력 테이블에 오늘 날짜와 변경 내용을 추가한다
5. 업데이트된 내용을 요약 출력한다

## 출력 형식

```
📊 프로젝트 진행 상황
━━━━━━━━━━━━━━━━━━
완료: N개 | 진행 중: N개 | 대기: N개
진행률: ██████░░░░ XX%

진행 중:
  ▶ 게임 루프 통합

대기 작업:
  1. UI 컴포넌트 (common/, game/)
  2. 화면 구현 (MainMenu, Game, RunResult, MetaShop)

최근 변경:
  2026-02-08  프로젝트 초기 설정 + 게임 엔진 구현
```