Codebase Update Skill

프로젝트에 변경사항이 있을 때

.codebase/

지침

1단계: 변경사항 파악

최근 변경된 내용을 확인하세요:

# 최근 변경된 파일 확인
git status
git diff --name-only HEAD~5

# 또는 특정 커밋 이후 변경사항
git diff --name-only <commit-hash>

2단계: 영향 받는 문서 식별

변경 유형에 따라 업데이트할 문서를 결정하세요:

API.md

DIRECTORY.md

MODULES.md

DATABASE.md

ARCHITECTURE.md

PATTERNS.md

3단계: 문서 업데이트

해당 문서를 읽고 변경사항을 반영하세요:

1. 기존 문서 내용 확인
2. 변경된 코드 분석
3. 문서에 변경사항 반영
4. 일관된 형식 유지

4단계: 검증

업데이트된 문서가 실제 코드와 일치하는지 확인하세요.

문서 템플릿

ARCHITECTURE.md

# 아키텍처 개요

## 레이어 구조
- Presentation Layer (Controllers/Routes)
- Business Layer (Services)
- Data Layer (Repositories/Models)

## 의존성 흐름
[다이어그램 또는 설명]

## 주요 컴포넌트
[컴포넌트 목록 및 역할]

DIRECTORY.md

# 디렉토리 구조

\`\`\`
src/
├── controllers/    # API 컨트롤러
├── services/       # 비즈니스 로직
├── models/         # 데이터 모델
├── routes/         # 라우팅 정의
├── middlewares/    # 미들웨어
├── utils/          # 유틸리티 함수
└── config/         # 설정 파일
\`\`\`

API.md

# API 엔드포인트

## 인증 (Auth)
- POST /api/auth/login - 로그인
- POST /api/auth/register - 회원가입

## 사용자 (Users)
- GET /api/users - 사용자 목록
- GET /api/users/:id - 사용자 상세

DATABASE.md

# 데이터베이스 스키마

## 엔티티
- User: 사용자 정보
- Post: 게시글

## 관계
- User 1:N Post

MODULES.md

# 주요 모듈

## AuthModule
- 역할: 인증/인가 처리
- 위치: src/modules/auth/
- 주요 파일: auth.service.ts, auth.controller.ts

PATTERNS.md

# 코드 패턴 및 컨벤션

## 네이밍 규칙
- 파일: kebab-case (user-service.ts)
- 클래스: PascalCase (UserService)
- 함수: camelCase (getUserById)

## 에러 처리
[에러 처리 패턴 설명]

자동 업데이트 트리거

다음 상황에서 이 스킬을 사용하세요:

1. 기능 구현 완료 후: 새로운 기능이 추가되면 관련 문서 업데이트
2. 리팩토링 후: 구조 변경이 있으면 DIRECTORY.md, ARCHITECTURE.md 업데이트
3. PR 생성 전: 변경사항이 문서에 반영되었는지 확인
4. 코드 리뷰 시: 문서 업데이트 누락 여부 확인

주의사항

• 문서는 간결하게 유지하세요 (핵심 정보만)
• 자동 생성 가능한 정보는 문서화하지 마세요 (예: 타입 정의)
• 문서 형식과 스타일을 일관되게 유지하세요

• .codebase/

  디렉토리가 없으면 먼저 생성하세요