/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 사용

로그 형식

## 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. 사용자 확인 후 저장

   • 요약 내용 미리보기 제공
   • 수정 요청 가능
   • 확인 후 파일에 저장