Update Conventions

Overview

스프린트 완료 후, 코드 리뷰에서 발견된 패턴과 교훈을 docs/conventions.md에 축적한다. conventions.md는 Convention Guard (Open Code Review 기반 리뷰)의 단일 규칙 소스이다.

When to Use

• 사용자가 /bf-update-conventions를 입력했을 때
• /bf-archive-sprint 완료 후

Prerequisites

• 아카이브된 스프린트 존재: docs/archive/{TICKET}/
• 아카이브 내 stories, tech-specs 디렉토리 존재
• docs/archive/{TICKET}/reviews/ 디렉토리 존재 (리뷰 결과 파일) — 미존재 시 git log에서 리뷰 관련 커밋 히스토리를 대안으로 분석
• docs/conventions.md (없으면 신규 생성 — /bf-spec이 초기 seed를 생성했어야 하나, 미생성 시 이 스킬이 빈 템플릿으로 생성)
• 권장 실행 순서: /bf-archive-sprint → /bf-metrics (선택) → /bf-update-conventions. 아카이빙 후 실행해야 리뷰 결과에 접근 가능

Error Handling

• 아카이브 디렉토리 미존재: "docs/archive/가 없습니다. /bf-archive-sprint를 먼저 실행하세요." 안내
• 리뷰 파일도 git log도 분석할 데이터가 없으면: "분석할 리뷰 데이터가 없습니다. 스프린트 리뷰 이력이 없으면 건너뛰어도 됩니다." 안내

Instructions

1. 아카이브된 스프린트의 리뷰 이력을 분석한다:

   • 1차 소스: docs/archive/{TICKET}/reviews/*.md 파일들을 읽는다
   • 2차 소스 (리뷰 파일 미존재 시): git log에서 커밋 메시지와 변경 패턴을 분석하여 반복 지적 패턴을 추론한다
   • 반복적으로 지적된 패턴 추출
   • 블로커로 분류된 이슈 유형 정리
   • Convention Guard가 놓친 패턴 식별

2. 사용자에게 발견된 패턴을 제시한다:

   • 각 패턴의 발생 빈도
   • 대표 사례
   • 제안하는 룰 내용

3. 사용자 승인 후 다음을 업데이트한다:

   • docs/conventions.md: 새 컨벤션 룰을 적절한 섹션에 추가한다. 이 파일이 Convention Guard(OCR 리뷰)의 단일 규칙 소스이므로, 새 체크 항목도 이 파일에 추가한다. 기존 룰은 삭제하지 않는다 (append-only). 기존 룰 보완·구체화만 허용한다. 섹션 분류 규칙:
     • Core 섹션(아키텍처, 네이밍, 테스트, 코드 스타일)에 해당하면 해당 섹션에 추가
     • 기술 특화 패턴이면 concern-area 섹션(UI 패턴, API 패턴, DB 패턴, 보안 패턴, 인프라 패턴)에 추가
     • concern-area 섹션이 아직 없으면 해당 섹션 헤딩(## {Name} 패턴)을 새로 생성하여 추가
     • 어느 섹션에도 맞지 않으면 가장 관련 높은 Core 섹션에 추가
   • CLAUDE.md: Changelog 섹션에 컨벤션 업데이트 이력을 기록한다. 본문(설계 원칙, 핵심 개념 등)은 수정하지 않는다

4. git commit을 수행한다:

   • 메시지: [{TICKET}] 컨벤션 업데이트

Output Format

• docs/conventions.md 업데이트 (Convention Guard 규칙 포함)
• CLAUDE.md 업데이트 (필요 시)
• git commit