# Archiving Manual

이 문서는 하나의 작업 사이클(PRD 작성 -> 구현 -> 테스트 통과)이 완전히 끝났을 때, 작업 내역을 보존하고 다음 작업을 준비하는 절차입니다.

---

## 1. Pre-Archiving Checklist (최종 점검)

아카이빙을 수행하기 전에 다음 항목을 반드시 확인하십시오.

1. **Task Completion:** `active_tasklist.md`의 모든 항목이 `[x]`로 체크되어 있는가?
2. **Test Verification:** `uv run pytest`를 실행하여 모든 테스트가 통과하는지 마지막으로 확인했는가?
3. **User Approval:** 사용자가 결과물에 대해 최종 승인(Confirm)을 했는가?
4. **Linting:** `uv run ruff check .` 및 `format`을 수행하여 코드 스타일을 정리했는가?

---

## 2. Knowledge Consolidation (지식 자산화)

**이 단계가 가장 중요합니다.** 파일을 보관하기 전에, 이번 작업에서 얻은 '새로운 지식'과 '재사용 가능한 패턴'을 시스템에 영구적으로 반영하십시오.

- **Manuals Update:** 작업 중 발견된 프로세스 개선점이나 코딩 규칙이 있다면 `manuals/` 폴더의 문서를 업데이트하십시오.
- **References Update (Mandatory):** 새로 구현한 기술적 패턴, 라이브러리 사용법(unreal, pymxs, p4), 도메인 지식은 `references/` 하위 폴더(`max/`, `ue5/`, `integrations/`, `patterns/`)에 문서로 생성하거나 기존 문서를 업데이트하십시오.
- **Reference Map Sync:** 새로운 레퍼런스 문서를 생성했다면, 반드시 `.ai_context/manuals/reference_map.md`에 해당 문서 링크와 키워드를 추가하십시오.

---

## 3. File Archiving (파일 이동)

현재의 `active` 문서들을 `archive` 폴더로 이동하여 역사를 보존합니다.

### **Naming Convention**

- **Format:** `YYYYMMDD_{FeatureName}_{Type}.md`
- **Example:** `20240520_StatSystem_PRD.md`, `20240520_StatSystem_Tasks.md`

### **Action**

1. `.ai_context/planning/active_prd.md` → `.ai_context/planning/archive/YYYYMMDD_{FeatureName}_PRD.md`
2. `.ai_context/planning/active_tasklist.md` → `.ai_context/planning/archive/YYYYMMDD_{FeatureName}_Tasks.md`
3. Active 파일 내용 비움 (다음 작업 준비)

---

## 4. Report Complete (완료 보고)

아카이빙이 완료되면 작업 완료를 선언하십시오.

```
[Feature Complete]
기능 개발이 완료되었습니다.
- 보관 문서: archive/YYYYMMDD_{FeatureName}_*.md
- 업데이트된 지식: (예: references/ue5/path_rules.md, reference_map.md)
```
