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 (분해 브리프의 리스트업 k번)) — 디테일은 그 이슈의 킥오프 게이트에서 채워진다.

코멘트 — 히스토리

• 진행 기록·논의 경과·중간 결정 같은 히스토리성 내용은 코멘트로 쌓는다. 결론 먼저.
• 킥오프 마커 코멘트(<!-- kickoff --> 류) 포맷은 kickoff 스킬 소관 — 여기서 재정의하지 않는다.
• 클로즈 시 한 줄 코멘트를 남긴다: 뭘로 해소됐는지(커밋 sha·PR#) 또는 왜 안 하는지.

다이어그램

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