gc-guide/.claude/rules/release-notes-guide.md
htlee 72a7655aa5 feat: 워크플로우 v1.5.0 기준 가이드 콘텐츠 최신화
- Claude Code 활용 가이드 신규 추가 (스킬 8종 + 에이전트 3종)
- 릴리즈 관리 가이드 신규 추가 (2계층 릴리즈 노트)
- 초기 환경 설정에 GITEA_TOKEN 설정 섹션 추가
- Git 워크플로우에 /push, /mr 스킬 추천 보강
- 프로젝트 시작하기 템플릿 파일 구조 v1.5.0 업데이트
- chat 봇 연동/디자인 시스템 섹션 임시 주석처리
- 팀 워크플로우 v1.5.0 동기화 (스킬, 에이전트, 규칙)
2026-03-01 17:59:33 +09:00

1.4 KiB

릴리즈 노트 관리 정책

원칙

  • MR은 반드시 /mr 또는 /release 스킬을 통해 생성한다
  • 웹에서 직접 생성한 MR은 릴리즈 노트 누락으로 리뷰에서 반려한다
  • 코드 리뷰 시 docs/RELEASE-NOTES.md 변경 여부를 확인한다

2계층 구조

Tier 1: 내부 릴리즈 노트 — docs/RELEASE-NOTES.md

  • 대상: 내부 개발자
  • 형식: Keep a Changelog 기반
  • 관리: /mr → [Unreleased] 항목 추가, /release → 날짜 버전 전환 + 압축
  • 모든 커밋 타입 기록

Tier 2: 버저닝 릴리즈 노트 — docs/VERSION-HISTORY.md

  • 대상: 개발자 + 비개발자 + 외부 공유
  • 형식: Semantic Versioning, 사용자 관점의 변화 중심
  • 관리: /version 스킬로 RELEASE-NOTES.md 기반 생성

변경 타입 매핑 (RELEASE-NOTES.md)

Conventional Commits 릴리즈 노트 섹션
feat 추가
fix 수정
refactor, perf 변경
docs 문서
test 테스트
style, chore, ci 기타

권한 기반 스킬 접근

  • /push, /mr: permissions.push (write 이상)
  • /release, /version: permissions.admin (프로젝트 관리자)
  • 권한은 Gitea API repos/{owner}/{repo}permissions 필드로 확인
  • Gitea site admin이 아닌 리포 단위 팀 권한 기준