---
description: 통합 문서 생성 규칙 (일반 문서, 회의록, 대시보드, Task 로그)
---

# 📝 통합 문서 생성 워크플로우

> **목적**: 프로젝트 내 모든 문서(일반, 회의록, 대시보드, 로그)의 생성 위치, 파일명, 형식을 통일하여 관리 효율성을 높임.

---

## 1. 폴더 구조 (Directory Structure)
```
📁 docs/
├── 📁 meetings/   ← 회의록
├── 📁 decisions/  ← 기술/설계 결정 (ADR)
├── 📁 specs/      ← 상세 설계/명세
├── 📁 reviews/    ← 코드/문서 리뷰
├── 📁 reports/    ← 프로젝트 현황 대시보드
└── 📁 tasks/      ← task.md 스냅샷 (Task Log)
```

---

## 2. 파일명 규칙 (Naming Convention)

### 2.1. 일반 문서 (회의록, 결정, 명세, 리뷰)
*   **형식**: `{YYMMDD}-{HH.MM}-{주제}.md`
*   **예시**:
    *   `meetings/260208-20.43-predev-review.md`
    *   `decisions/260209-14.30-firestore-schema.md`

### 2.2. 프로젝트 대시보드 (Dashboard)
*   **형식**: `{YYMMDD}-{HH.MM}-project_status_dashboard.md`
*   **예시**: `reports/260208-22.12-project_status_dashboard.md`
*   **규칙**: 기존 파일은 보존하고, 새 타임스탬프로 **새 파일을 생성**하여 히스토리를 남긴다.

### 2.3. Task 로그 (Task Log)
*   **형식**: `task{번호}-{YYMMDD}-{HH.MM}-{설명}.md`
*   **예시**: `tasks/task00001-260208-22.18-Phase2_Done.md`
*   **규칙**: `task.md`의 내용이 크게 변경되거나 마일스톤 달성 시 스냅샷으로 저장.

---

## 3. 문서 템플릿 (Templates)

### 3.1. 일반 문서 헤더
```markdown
# {제목}

> **일시**: YYYY-MM-DD HH:MM
> **참석자**: (해당 시)
> **안건/주제**: 간단한 설명

---

(본문 내용)
```

### 3.2. 대시보드 구조
*   **헤더**: `Last Updated` (일시), `현재 단계` (Phase)
*   **진행률**: Mermaid Pie Chart 활용
*   **상태**: 🟢(완료), 🟡(진행 중), 🔴(대기) 아이콘 사용한 테이블
*   **상세**: 최근 완료, 진행 중, 예정 작업 기술

---

## 4. 주제 네이밍 규칙
*   영문 소문자 + 하이픈 (`kebab-case`) 사용
*   핵심 키워드 위주로 간결하게 작성
*   예: `auth-flow`, `editor-ui`, `api-endpoints`

## 5. 스크립트 파일 규칙 (참고)
*   **형식**: `task{번호}-{YYMMDD}-{HH.MM}.py`