name: devlog description: Record development work logs to _devlog/YYYY-MM-DD.md. 작업 로그 기록, 명령어/결정사항/다음 단계 포함. Use with /devlog, /devlog [title], or /devlog --summary.
/devlog - 작업 로그 기록
개발 작업 내용을 devlog 파일에 기록합니다. Git 커밋 여부와 관계없이 작업 내용을 남길 수 있습니다.
실행 방법
-
현재 상태 파악
- Git 사용 가능 여부 확인 (
git rev-parse --git-dir 2>/dev/null) - Git 있으면:
git status --short결과 참고 - Git 없으면: 수동 입력 모드
- Git 사용 가능 여부 확인 (
-
사용자에게 질문 (필요시)
- "어떤 작업을 하셨나요?" (자유 형식)
- 또는 이전 대화 컨텍스트에서 작업 내용 요약
-
devlog 파일 생성/업데이트
- 프로젝트 루트: Git repo면
git rev-parse --show-toplevel, 아니면$PWD - 경로:
{project-root}/_devlog/YYYY-MM-DD.md - _devlog 폴더가 없으면 생성
- 같은 날짜 파일이 있으면 해당 파일에 append (하루 한 파일)
- 순번 결정: 파일 내 마지막
## N.헤더를 찾아 N+1 사용
- 프로젝트 루트: Git repo면
로그 형식
## 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 실행 시 현재 세션의 작업을 자동으로 요약:
-
작업 내용 자동 추출
- 대화에서 수행한 작업 식별
- 파일 생성/수정 내역 수집
- 주요 결정사항 추출
-
실행한 명령어 수집
- Bash 도구로 실행한 명령어 목록화
- 재현 가능한 형태로 정리
-
결과 요약
- 성공/실패 여부
- 확인된 동작
-
사용자 확인 후 저장
- 요약 내용 미리보기 제공
- 수정 요청 가능
- 확인 후 파일에 저장