Issue

---
name: issue
description: Use when writing GitHub issues or issue comments in this project — 이슈 생성, 본문 갱신, 코멘트 작성 시점. 이슈는 할 일 정리와 히스토리 축적 용도 — 본문(확정 사실·결론·결정사항, 두괄식)과 코멘트(히스토리)의 역할 분리를 다룬다. Triggers on "이슈 따자", "이슈 만들어", "이슈에 정리해", "코멘트 남겨". Does NOT trigger on PR 본문 작성(pr 스킬), 커밋 메시지 작성(commit 스킬), 킥오프 절차 자체(kickoff 스킬).
---

# Issue — 이슈 본문·코멘트

**이슈의 용도는 할 일 정리와 히스토리 축적이다.** 본문과 코멘트의 역할을 나눈다.

## 본문 — 확정된 것

- 확정된 사실·결론·결정사항을 담는다. 두괄식 — 첫 문단에서 **목표가 한 문장으로 추출**돼야 한다 (킥오프가 이 문장을 읽고 시작한다).
- 결정이 뒤집히면 본문을 갱신한다 — 본문은 항상 최신 확정 상태를 반영한다. 갱신은 덧붙이기가 아니다: 뒤집힌 결정과 거기 이르렀던 경위는 **지운다.**
- 하위 이슈 본문은 목표 한두 줄 + 상위 좌표 (`상위 이슈: #N / DP-<x.y>` — 작전계획 campaign.md 9항의 DP 좌표. 계획 없는 단순 하위면 `상위 이슈: #N`) — 디테일은 그 이슈의 킥오프 정찰과 opord·campaign 질문 단계에서 채워진다. DP 이슈 생성 시 campaign 원장의 이슈# 칸을 채우고 상태를 `착수` 로 올린 뒤, 상위 이슈 본문 미러를 재조립한다(campaign §5).

## 코멘트 — 히스토리

- 진행 기록·논의 경과·중간 결정 같은 히스토리성 내용은 코멘트로 쌓는다. 결론 먼저 — 첫 문단이 결론이다.
- 고려했지만 채택 안 한 대안·검토 경위·시행착오는 **적지 않는다.** 최종 결정만 남긴다 — 결정이 확정된 순간 거기 이르는 과정은 읽는 사람에게 값이 없다.
- 문제 서술·배경은 결론을 이해하는 데 필요한 최소량까지만 — 결론보다 앞에 깔지 않는다.
- 킥오프 마커 코멘트(`<!-- kickoff -->` 류) 포맷은 kickoff 스킬 소관 — 여기서 재정의하지 않는다.
- 클로즈 시 한 줄 코멘트를 남긴다: 뭘로 해소됐는지(커밋 sha·PR#) 또는 왜 안 하는지.

## 보드

이슈를 **새로 생성하면** 개발 대시보드(Project #2)의 `Todo`에 올린다:

```bash
.claude/scripts/project-board.sh <이슈번호> "Todo"
```

- 본문 갱신·코멘트 작성에는 적용하지 않는다 — 생성 시점만이다.
- 이후 단계 이동(`In Progress`·`Review + QA`)은 kickoff·pr 스킬 소관 — 여기서 옮기지 않는다.
- 배선이 실패해도 이슈 작업은 계속한다. 실패 사실만 유저에게 한 줄로 알린다.

## 다이어그램

구조·플로우가 글보다 그림이 명확할 땐 mermaid 다이어그램을 본문·코멘트에 넣는다 (GitHub 렌더 지원).