---
name: kickoff-guide
description: 착수보고서 작성 기준 문서를 Markdown으로 생성하고, /visualize로 인터랙티브 HTML 가이드를 만든다. PM 표준 기반 9개 섹션별 작성법·좋은 예·나쁜 예·흔한 실수를 시각화. Keywords: 착수보고서 작성법, kickoff guide, project charter template, 작성 기준, 작성 가이드, 예시, 템플릿, 시각화.
allowed-tools: Read, Write, Skill
---

# /kickoff-guide — 착수보고서 작성 기준 가이드 생성

PMI/PRINCE2 표준 기반 작성 가이드를 **Markdown 파일**로 생성한 뒤 **HTML로 시각화**한다.

## 사용법

```
/kickoff-guide
/kickoff-guide --path ./docs        # 저장 위치 지정
/kickoff-guide --md-only            # Markdown만 생성 (HTML 생략)
```

---

## 실행 절차

### Step 1. 저장 경로 결정

- `--path` 인자가 있으면 해당 경로 사용
- 없으면 현재 작업 디렉토리에 저장
- 생성 파일명: `착수보고서_작성기준.md`

---

### Step 2. Markdown 작성 기준 문서 생성

[references/writing-guide.md](references/writing-guide.md)를 기반으로 아래 구조의 Markdown 파일을 작성한다.

생성 파일: `{경로}/착수보고서_작성기준.md`

```markdown
# 착수보고서 작성 기준

> PMI/PRINCE2 표준 기반 | 9개 섹션 | 작성일: {오늘 날짜}

이 문서는 착수보고서를 처음 작성하거나 검토하는 PM·개발 리더를 위한 실전 작성 기준입니다.
각 섹션별 필수 항목, 좋은 예·나쁜 예, 체크리스트를 포함합니다.

---

## 목차

1. [프로젝트 개요](#1-프로젝트-개요-15점)
2. [범위 정의](#2-범위-정의-15점)
3. [일정·마일스톤](#3-일정마일스톤-15점)
4. [조직·R&R](#4-조직rr-10점)
5. [예산·자원](#5-예산자원-10점)
6. [리스크·대응 계획](#6-리스크대응-계획-15점)
7. [전제조건·제약사항](#7-전제조건제약사항-10점)
8. [성공 기준](#8-성공-기준-10점)
9. [커뮤니케이션 계획](#9-커뮤니케이션-계획-보너스-5점)
10. [흔한 실수 Top 7](#흔한-실수-top-7)
11. [빠른 체크리스트](#빠른-체크리스트)

---

{references/writing-guide.md의 9개 섹션 내용 전문 포함}

---

## 빠른 체크리스트

착수보고서 제출 전 최종 점검:

- [ ] 기대 효과에 수치가 있는가?
- [ ] Out-of-scope가 명시되어 있는가?
- [ ] 마일스톤에 날짜와 완료 기준이 있는가?
- [ ] PM 이름과 연락처가 있는가?
- [ ] 예산이 세분화되어 있는가?
- [ ] 리스크마다 대응 전략이 있는가?
- [ ] 전제조건과 리스크가 연결되어 있는가?
- [ ] 성공 기준이 수치로 정의되어 있는가?
```

---

### Step 3. HTML 시각화

`--md-only` 옵션이 없으면 `claude-visualize:visualize` 스킬을 호출하여 HTML 파일을 생성한다.

```
Skill: claude-visualize:visualize
입력: 방금 생성한 착수보고서_작성기준.md
출력: 착수보고서_작성기준.html (같은 경로)
```

**visualize 스킬 호출 시 힌트**:

> 이 문서는 착수보고서 작성 가이드다. `report` 타입으로 시각화하되 다음 레이아웃을 따른다:
>
> - **Hero**: "착수보고서 작성 기준" + 부제 + 총 배점(100점) + 섹션 수(9개) KPI
> - **섹션 카드 그리드**: 9개 섹션을 3-col 카드로 나열. 각 카드에 배점 chip, 필수 항목 수, 아이콘 포함
> - **섹션별 상세**: 각 섹션을 펼쳐서 필수 항목 + 좋은 예(초록) + 나쁜 예(빨강) 나란히 표시
> - **흔한 실수**: danger 컬러 카드 7개
> - **빠른 체크리스트**: 인터랙티브 체크박스 (체크 시 취소선 효과)
>
> 좋은 예는 `--accent-2(#70e1cb)` 계열, 나쁜 예는 `--danger(#ff8c9f)` 계열로 구분한다.
> 체크리스트는 JS로 체크박스 토글 기능을 추가한다.

---

### Step 4. 결과 출력

```
✅ 착수보고서 작성 기준 문서가 생성되었습니다.

📄 Markdown: {절대경로}/착수보고서_작성기준.md
🌐 HTML:     {절대경로}/착수보고서_작성기준.html

사용법:
- HTML 파일을 브라우저에서 열어 작성 가이드를 확인하세요.
- /kickoff-review @"착수보고서.md" 로 실제 문서를 검토할 수 있습니다.
```

---

## 주의사항

- Markdown 파일은 `writing-guide.md`의 내용을 그대로 복사하지 않고, 독자가 읽기 쉽도록 목차·빠른 체크리스트를 추가하여 완성된 문서로 재구성한다.
- HTML은 반드시 단일 파일(self-contained)로 생성한다.
- 외부 폰트 로딩 실패 시에도 읽을 수 있도록 fallback 폰트를 포함한다.