---
name: devlog
description: Record development work logs to _devlog/YYYY-MM-DD.md. 작업 로그 기록, 명령어/결정사항/다음 단계 포함. Use with /devlog, /devlog [title], or /devlog --summary.
---

# /devlog - 작업 로그 기록

개발 작업 내용을 devlog 파일에 기록합니다. Git 커밋 여부와 관계없이 작업 내용을 남길 수 있습니다.

## 실행 방법

1. **현재 상태 파악**
   - Git 사용 가능 여부 확인 (`git rev-parse --git-dir 2>/dev/null`)
   - Git 있으면: `git status --short` 결과 참고
   - Git 없으면: 수동 입력 모드

2. **사용자에게 질문** (필요시)
   - "어떤 작업을 하셨나요?" (자유 형식)
   - 또는 이전 대화 컨텍스트에서 작업 내용 요약

3. **devlog 파일 생성/업데이트**
   - 프로젝트 루트: Git repo면 `git rev-parse --show-toplevel`, 아니면 `$PWD`
   - 경로: `{project-root}/_devlog/YYYY-MM-DD.md`
   - _devlog 폴더가 없으면 생성
   - 같은 날짜 파일이 있으면 해당 파일에 append (하루 한 파일)
   - 순번 결정: 파일 내 마지막 `## N.` 헤더를 찾아 N+1 사용

## 로그 형식

```markdown
## N. 작업 제목

### 작업 내용
- 수행한 작업 요약

### 실행한 명령어
```bash
# 주요 명령어 (나중에 복붙 가능하도록)
docker-compose up -d
curl -X POST ...
```

### 확인 결과
| 항목 | 상태 |
|------|------|
| 빌드 성공 | ✅ |
| 테스트 통과 | ✅ |
| API 응답 확인 | ✅ |

### 주요 결정사항
- 왜 이렇게 했는지

### 생성/변경된 파일
- `path/to/file.md`

### 다음 단계
- [ ] TODO 1
- [ ] TODO 2

---
```

## 상세 수준 가이드

**포함할 것:**
- 주요 명령어 (나중에 따라할 수 있도록)
- 핵심 결과 (테이블 형태로 간결하게)
- 결정 사항과 이유
- 다음 단계

**생략할 것:**
- 전체 출력 로그 (너무 길면)
- 시행착오 과정 (최종 성공한 것만)
- 자명한 내용

## 순번 규칙

- 시간 대신 순번 사용: `## 1.`, `## 2.`, `## 3.` ...
- 같은 날 여러 작업 시 순번 증가
- 다음 날은 다시 1번부터

## 사용 예시

```bash
# 대화형으로 로그 작성
/devlog

# 제목과 함께 바로 작성
/devlog Docker 환경 구축 완료

# 현재 세션 작업 전체 요약
/devlog --summary
```

## 자동 요약 모드 (`--summary`)

`/devlog --summary` 실행 시 현재 세션의 작업을 자동으로 요약:

1. **작업 내용 자동 추출**
   - 대화에서 수행한 작업 식별
   - 파일 생성/수정 내역 수집
   - 주요 결정사항 추출

2. **실행한 명령어 수집**
   - Bash 도구로 실행한 명령어 목록화
   - 재현 가능한 형태로 정리

3. **결과 요약**
   - 성공/실패 여부
   - 확인된 동작

4. **사용자 확인 후 저장**
   - 요약 내용 미리보기 제공
   - 수정 요청 가능
   - 확인 후 파일에 저장