---
name: dz-project-tracker
description: >
  This skill should be used when the user asks "프로젝트 현황 알려줘",
  "전체 프로젝트 보여줘", "가온 프로젝트 어떻게 돼가", "프로젝트 등록해줘",
  "프로젝트 업데이트해줘", "진행현황 추가해줘", "프로젝트 완료 처리해줘",
  "대시보드 보여줘", "PRJ-XXX 상세 알려줘",
  or when managing the project portfolio across modules.
  Manages the projects/ folder: dashboard, project detail files, and templates.
version: 0.1.0
---

# 프로젝트 포트폴리오 트래커

`projects/` 폴더를 통해 전체 프로젝트를 포트폴리오 레벨에서 관리한다.

## 핵심 파일

| 파일 | 역할 |
|------|------|
| `projects/_dashboard.md` | 전체 프로젝트 현황 대시보드 (항상 최신 유지) |
| `projects/PRJ-{YYYY}-{모듈코드}-{NNN}_제목.md` (신규) 또는 `PRJ-YYYY-NNN_제목.md` (구규칙) | 개별 프로젝트 상세 (PDF "프로젝트 상세" 대응) |
| `projects/_templates/project-detail.md` | 새 프로젝트 생성 시 복사하는 템플릿 |
| `projects/_archive/` | 완료된 프로젝트 보관소 |

## 작업별 절차

### 1. 전체 현황 조회

1. `projects/_dashboard.md` 읽기
2. 진행 중 프로젝트 목록을 표 형태로 요약
3. 리스크가 있는 프로젝트 강조

### 2. 특정 프로젝트 상세 조회

1. `projects/PRJ-YYYY-NNN_*.md` 읽기
2. 01. 프로젝트 개요 → 현재 상태 요약
3. 02. TASK 목록 → 미완료 TASK 강조
4. 03. 상세 진행현황 → 최근 3일 로그 요약
5. 이슈·리스크 요약

### 3. 새 프로젝트 등록

1. `projects/_dashboard.md`에서 최신 PRJ ID 확인 → 다음 순번 채번
   - **신규 규칙** (2026-04-20~): `PRJ-{YYYY}-{모듈코드}-{NNN}` — 모듈별 독립 채번
     - 모듈 코드: LTE(법무관리), CRM, KISS(업무관리), BOARD(게시판), AB(연락처), GA(총무), PUB(퍼블리싱), DSPORTS — 상세는 `_dashboard.md` "ID 채번 규칙" 참조
     - 예: `PRJ-2026-LTE-010` (법무관리 2026년 10번째)
   - **구규칙**: 수명업무·크로스모듈 등 단일 모듈 귀속 불가 시 `PRJ-{YYYY}-{NNN}`
2. `projects/_templates/project-detail.md` 복사
3. 파일명: `PRJ-{YYYY}-{모듈코드}-{NNN}_{프로젝트명}.md` (신규) 또는 `PRJ-YYYY-NNN_{프로젝트명}.md` (수명업무 등)
4. 사용자에게 필수 정보 확인:
   - 프로젝트명, 유형, 모듈, 기간, PM, 담당자
5. 01. 프로젝트 개요 작성
6. 02. TASK 목록 초안 작성 (기획/개발 병렬)
7. `_dashboard.md`에 행 추가
8. 해당 모듈 `tasks/_current.md`에 프로젝트 참조 추가
9. **연쇄 업데이트 (Cascade R2)** — 프로젝트 `04. 연결 정보`에 관련 모듈 리소스 링크 추가:
   - `{모듈}/context/` — 관련 GNB _overview.md, LNB.md
   - `{모듈}/history/_timeline.md` — 개발 이력 타임라인
   - `{모듈}/문서/INDEX.md` — 문서 전체 인덱스
   - `{모듈}/context/_tech-reference.md` — 기술 참조 (소스 분석 연결)
   - Google Sheets 시트가 있으면 `sheets-config.json`의 시트 ID도 기록

### 4. 상세 진행현황 업데이트

사용자가 일일보고·주간회의 내용을 전달하면:

1. 해당 프로젝트 파일의 `03. 상세 진행현황` 섹션에 일자별 로그 추가
   - 최신순 (새 항목을 기존 항목 위에 추가)
   - TASK#으로 연결 가능한 것은 연결
   - TASK에 없는 사소한 작업은 TASK# 없이 기록
2. `02. TASK 목록`의 진행률 갱신
3. `01. C. 진행률` 전체 수치 갱신
4. 이슈 발생 시 `01. D. 이슈 & 리스크`에 추가
5. `_dashboard.md` 테이블의 진행률·상태·리스크 갱신

### 5. 프로젝트 완료 처리

1. 프로젝트 파일의 상태를 "완료"로 변경
2. `_dashboard.md`에서 "진행 중" → "최근 완료" 테이블로 이동
3. 프로젝트 파일을 `projects/_archive/`로 이동
4. 해당 모듈 `tasks/_current.md`에서도 "최근 완료" 섹션으로 이동

## TASK ↔ 상세 진행현황 관계

```
TASK (계획 단위)
├── 기획-01: 설계방향성 정의 (01.07~01.12, 100%)
│   ├── [01.07] 0순위 요구사항 분석 시작
│   ├── [01.10] 설계 방향 초안 완료
│   └── [01.12] 설계 방향 확정
│
├── 개발-24: 일지 등록 방식 개선 (03.20~03.25, 100%)
│   ├── [03.20] 공통 일지 등록 개발 시작
│   ├── [03.24] 개발 완료, 검수 진행
│   └── [03.25] 검수 수정 완료
│
└── (TASK 없음)
    └── [03.15] 긴급 버그 수정 (사소한 작업)
```

- TASK#은 `기획-NN` 또는 `개발-NN` 형태로 부여
- 상세 진행현황의 TASK# 컬럼에서 연결
- 검수 결과표는 blockquote로 상세 로그 아래에 포함

## 진행률 계산

- 기획 진행률: 기획 TASK 개별 진행률의 가중 평균 (또는 사용자 제공 수치)
- 개발 진행률: 개발 TASK 개별 진행률의 가중 평균 (또는 사용자 제공 수치)
- 전체 진행률: 기획 + 개발 종합 (사용자 제공 수치 우선)

## 모듈 tasks와의 관계

| 항목 | `projects/PRJ-XXX.md` | `{모듈}/tasks/_current.md` |
|------|----------------------|--------------------------|
| 시점 | PM 포트폴리오 뷰 | 실무 레벨 뷰 |
| 초점 | 일정·진행률·이슈·리스크 | 개별 태스크 기술 상세 |
| 중복 금지 | TASK 상세 내용은 여기 안 씀 | 프로젝트 전체 현황은 여기 안 씀 |
| 상호 참조 | `04. 연결 정보`에서 tasks 경로 | 프로젝트 ID로 projects/ 참조 |

## 마크다운 링크 규칙 (필수)

프로젝트 파일 작성·업데이트 시 **모든 경로·파일 참조는 클릭 가능한 상대 링크**로 작성한다.

```markdown
# 나쁜 예
법무관리/tasks/_current.md에서 확인

# 좋은 예 (_projects/ 파일 기준)
[법무관리/tasks/_current.md](../법무관리/tasks/_current.md)에서 확인
```

상대 경로 기준:
- `projects/*.md` → 루트 접근 시 `../`
- 같은 `projects/` 내 파일 → 파일명만 (예: `[대시보드](_dashboard.md)`)
- 코드블록 안의 폴더 구조 다이어그램은 예외 (링크 불필요)