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차 소스: docs/archive/{TICKET}/reviews/*.md 파일들을 읽는다 - 2차 소스 (리뷰 파일 미존재 시): git log에서 커밋 메시지와 변경 패턴을 분석하여 반복 지적 패턴을 추론한다 - 반복적으로 지적된 패턴 추출 - 블로커로 분류된 이슈 유형 정리 - Convention Guard가 놓친 패턴 식별
- 사용자에게 발견된 패턴을 제시한다:
- 각 패턴의 발생 빈도 - 대표 사례 - 제안하는 룰 내용
- 사용자 승인 후 다음을 업데이트한다:
- docs/conventions.md: 새 컨벤션 룰을 적절한 섹션에 추가한다. 이 파일이 Convention Guard(OCR 리뷰)의 단일 규칙 소스이므로, 새 체크 항목도 이 파일에 추가한다. 기존 룰은 삭제하지 않는다 (append-only). 기존 룰 보완·구체화만 허용한다. 섹션 분류 규칙: - Core 섹션(아키텍처, 네이밍, 테스트, 코드 스타일)에 해당하면 해당 섹션에 추가 - 기술 특화 패턴이면 concern-area 섹션(UI 패턴, API 패턴, DB 패턴, 보안 패턴, 인프라 패턴)에 추가 - concern-area 섹션이 아직 없으면 해당 섹션 헤딩(## {Name} 패턴)을 새로 생성하여 추가 - 어느 섹션에도 맞지 않으면 가장 관련 높은 Core 섹션에 추가 - CLAUDE.md: Changelog 섹션에 컨벤션 업데이트 이력을 기록한다. 본문(설계 원칙, 핵심 개념 등)은 수정하지 않는다
- git commit을 수행한다:
- 메시지: [{TICKET}] 컨벤션 업데이트
Output Format
- docs/conventions.md 업데이트 (Convention Guard 규칙 포함)
- CLAUDE.md 업데이트 (필요 시)
- git commit