bf-update-conventions

Original：🇺🇸 English

Translated

스프린트 중 코드 리뷰에서 발견된 반복 패턴을 conventions.md에 반영한다. Convention Guard의 규칙 소스를 축적하여 다음 스프린트의 리뷰 품질을 높인다.

2installs

Sourcekhaki4/my_skills

Added on2026-02-19

NPX Install

npx skill4agent add khaki4/my_skills bf-update-conventions

SKILL.md Content

View Translation Comparison →

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