# 업무일지 표준화 템플릿

> 작성일: 2026-03-19
> 버전: v1.0
> 담당: 테크 리드
> 적용 대상: FE 팀 전원

---

## 개요

FE 팀원 개인이 매일 작성하는 업무일지의 표준 템플릿을 정의합니다.
일관된 형식으로 작성하면 AI 자동 요약 연동 및 주간 회고 자동화가 가능합니다.

---

## 일일 업무일지 템플릿

> 파일명 규칙: `YYYY-MM-DD_이름.md` (예: `2026-03-19_홍길동.md`)
> 작성 시점: 업무 종료 전 (17:30~18:00 권장)

```markdown
# 업무일지 - YYYY-MM-DD (요일)

**작성자**: 이름
**팀**: FE팀
**작성 시각**: HH:MM

---

## ✅ 오늘 완료한 일

<!-- 태스크 ID와 함께 작성하면 자동 연동 가능 -->

- [ ] [T0-X] 태스크 제목: 간략한 작업 내용
- [ ] [T0-X] 태스크 제목: 간략한 작업 내용
- [ ] (태스크 외) 코드 리뷰, 회의, 기타 업무

**완료 요약**: 오늘 주요 성과를 1~2문장으로 요약

---

## 📋 내일 예정 작업

- [ ] [T0-X] 태스크 제목: 예상 작업 내용
- [ ] [T0-X] 태스크 제목: 예상 작업 내용

**예상 완료 비율**: X% (태스크 단위 예상)

---

## 🚧 블로커 / 의존성

<!-- 진행을 막는 이슈나 다른 팀원의 작업 완료를 기다리는 항목 -->

| 블로커 내용 | 영향 태스크 | 해결 담당 | 예상 해결일 |
|-------------|-------------|-----------|-------------|
| 예: Copilot 라이선스 미할당 | T0-3 | 시니어 Dev | 2026-03-20 |

블로커 없음 시: `없음`

---

## 📝 메모 / 학습 기록

<!-- 오늘 배운 것, 참고할 링크, 팀 공유 사항 등 -->

- 참고 링크:
- 학습 내용:
- 팀 공유 사항:

---

## 🔢 시간 배분 (선택)

| 업무 분류 | 소요 시간 |
|-----------|-----------|
| 개발 | Xh |
| 코드 리뷰 | Xh |
| 회의 | Xh |
| 문서 작업 | Xh |
| 기타 | Xh |
| **합계** | **8h** |
```

---

## 주간 요약 템플릿

> 파일명 규칙: `YYYY-WXX_이름_주간요약.md` (예: `2026-W12_홍길동_주간요약.md`)
> 작성 시점: 금요일 업무 종료 전

```markdown
# 주간 업무 요약 - YYYY년 XX주차 (MM/DD ~ MM/DD)

**작성자**: 이름
**작성일**: YYYY-MM-DD

---

## 이번 주 완료 태스크

| 태스크 ID | 태스크명 | 완료일 | 비고 |
|-----------|---------|--------|------|
| T0-X | 태스크명 | MM/DD | - |

---

## 이번 주 주요 성과

1.
2.
3.

---

## 다음 주 계획

| 우선순위 | 태스크 ID | 태스크명 | 예상 소요 |
|----------|-----------|---------|-----------|
| 높음 | T0-X | 태스크명 | X일 |
| 중간 | T0-X | 태스크명 | X일 |

---

## 블로커 / 리스크

-

---

## 기술 메모 / 학습

-
```

---

## AI 자동 요약 연동 방안

### 1. 일일 요약 자동화 (Claude API 활용)

업무일지 원문을 Claude API에 전달하여 핵심 요약을 자동 생성합니다.

#### 프롬프트 템플릿

```
당신은 FE 팀의 업무일지를 요약하는 AI 어시스턴트입니다.
아래 업무일지를 다음 형식으로 요약해주세요:

[요약 형식]
- 오늘의 핵심 성과: (1~2문장)
- 주요 완료 태스크: (태스크 ID와 함께 3개 이내)
- 내일 예정: (1~2문장)
- 블로커 여부: (있음/없음, 있을 경우 간략 설명)

[업무일지 내용]
{work_log_content}
```

#### 연동 방식 (검토 결과)

| 방식 | 장점 | 단점 | 권장 여부 |
|------|------|------|-----------|
| Claude API 직접 연동 (서버 스크립트) | 자동화 완전, 커스터마이징 자유 | 구현 비용, API 키 관리 필요 | **권장** (Sprint 1 이후 구현) |
| GitHub Actions + Claude API | PR/커밋 이벤트 트리거 가능 | GitHub 의존성 | 권장 (CI 파이프라인과 통합) |
| Notion AI 내장 기능 | 별도 구현 불필요 | Notion 플랜 필요, 커스터마이징 제한 | Notion 선택 시 단기 대안 |
| ChatGPT/Claude 수동 붙여넣기 | 즉시 사용 가능 | 자동화 불가, 수작업 | Sprint 0 임시 방안 |

### 2. 주간 요약 자동화 방안

```
매주 금요일 18:00에 GitHub Actions가 실행:
1. 해당 주의 일일 업무일지 파일 5개 수집
2. 파일 내용을 Claude API에 일괄 전달
3. 주간 팀 요약 자동 생성
4. Slack #daily-log 채널에 자동 게시
```

#### 주간 요약 자동화 프롬프트

```
당신은 FE 팀의 주간 업무를 요약하는 AI 어시스턴트입니다.
아래는 이번 주 팀원들의 업무일지 모음입니다.
팀 관리자를 위한 주간 요약을 작성해주세요:

[요약 형식]
1. 이번 주 팀 주요 성과 (3~5개)
2. 완료된 주요 태스크 목록
3. 현재 진행 중인 블로커
4. 다음 주 팀 계획 요약
5. 팀원별 기여 요약 (간략)

[업무일지 목록]
{work_logs_combined}
```

### 3. 단계별 도입 계획

| 단계 | 시점 | 방식 | 상태 |
|------|------|------|------|
| Phase 1 | Sprint 0 (현재) | 수동 작성 + 수동 AI 요약 | ✅ 즉시 적용 |
| Phase 2 | Sprint 1 | GitHub Actions + Claude API 자동 요약 스크립트 | 📋 계획됨 |
| Phase 3 | Sprint 2 이후 | Slack 연동 자동 게시, 주간 리포트 대시보드 | 📋 계획됨 |

---

## 작성 규칙 및 가이드라인

### 필수 작성 항목
- ✅ 오늘 완료한 일 (최소 1개)
- ✅ 내일 예정 작업 (최소 1개)
- ✅ 블로커 여부 (없음이라도 명시)

### 선택 작성 항목
- 📝 메모 / 학습 기록
- 🔢 시간 배분

### 작성 팁
1. **태스크 ID 명시**: `[T0-X]` 형식으로 로드맵 태스크와 연결
2. **구체적 작성**: "개발함" 대신 "Copilot 설정 가이드 VSCode 섹션 완료"
3. **블로커 조기 공유**: 하루 이상 막히면 즉시 팀에 공유
4. **시간 기록 권장**: 주간 회고 시 실제 소요 시간 파악에 활용

---

## Confluence/Notion 등록 가이드

### Notion 사용 시
1. 팀 워크스페이스 > FE팀 > 업무일지 페이지 생성
2. 위 템플릿을 Notion 템플릿으로 저장
3. 매일 새 페이지 생성 시 템플릿 적용

### Confluence 사용 시
1. FE팀 Space > 업무일지 > YYYY-MM 폴더 구조
2. 페이지 템플릿으로 등록 (Space 관리자 권한 필요)
3. 매일 새 페이지 생성 시 템플릿 적용

### Git 기반 (권장 - 자동화 용이)
```
docs/
└── work-logs/
    ├── 2026-03/
    │   ├── 2026-03-23_홍길동.md
    │   ├── 2026-03-24_홍길동.md
    │   └── weekly/
    │       └── 2026-W12_홍길동_주간요약.md
    └── templates/
        ├── daily-template.md
        └── weekly-template.md
```

> Git 저장소에 업무일지를 저장하면 GitHub Actions를 통한 자동 요약 연동이 가장 용이합니다.

---

## 검토 이력

| 날짜 | 버전 | 변경 내용 | 작성자 |
|------|------|-----------|--------|
| 2026-03-19 | v1.0 | 최초 작성 | 테크 리드 |