name	cs-sync
description	CS-GUIDE.md 업데이트 시 기존 CS 문서들을 새로운 가이드에 맞춰 동기화합니다. "CS 동기화", "CS 싱크", "가이드 반영" 요청 시 사용하세요.

CS 문서 동기화 도우미

CS-GUIDE.md가 업데이트되면 기존에 작성한 CS 문서들을 새로운 가이드 형식에 맞춰 동기화하는 Skill입니다.

트리거 키워드

"CS 동기화" / "CS 싱크"
"가이드 반영"
"CS 문서 업데이트"
"템플릿 동기화"
"{카테고리} 동기화" (예: "DB 동기화", "Network 동기화")

동기화 대상

필수 섹션 체크

CS-GUIDE.md 템플릿에 정의된 필수 섹션이 각 문서에 있는지 확인:

섹션	필수 여부	체크 방법
난이도 표기	필수	`> \`[N]` 형식 존재 여부
한 줄 정의	필수	제목 아래 `>` 인용구 존재
왜 알아야 하는가?	필수	`## 왜 알아야 하는가?` 섹션
핵심 개념	필수	`## 핵심 개념` 섹션
쉽게 이해하기	필수	`## 쉽게 이해하기` 섹션
상세 설명	필수	`## 상세 설명` 섹션
면접 예상 질문	필수	`## 면접 예상 질문` 섹션
연관 문서	필수	`## 연관 문서` 섹션
참고 자료	필수	`## 참고 자료` 섹션
트러블슈팅	권장	`## 트러블슈팅` 섹션 (실무 주제인 경우)
트레이드오프	권장	`## 트레이드오프` 섹션 (비교 주제인 경우)
예제 코드	권장	`## 예제 코드` 섹션 (구현 주제인 경우)

작업 절차

1단계: 현황 분석

# 전체 CS 문서 목록 확인
find cs/ -name "*.md" -not -name "README.md" -not -name "CS-GUIDE.md"

각 문서에 대해:

필수 섹션 존재 여부 체크
섹션 순서 확인
난이도 표기 형식 확인
연관 문서 링크 유효성 확인

2단계: 동기화 우선순위 결정

AskUserQuestion 도구로 동기화 범위 확인:

CS 문서 동기화 범위를 선택해주세요:

1. 전체 동기화 - 모든 CS 문서 업데이트
2. 카테고리별 - 특정 카테고리만 선택
3. 누락 섹션만 - 필수 섹션이 없는 문서만
4. 새 섹션 추가만 - 트러블슈팅 등 새로 추가된 섹션만

3단계: 동기화 실행

누락 섹션 추가

필수 섹션이 없는 경우 템플릿에 맞게 추가:

## {누락된 섹션명}

{TODO: 내용 작성 필요}

섹션 순서 정렬

CS-GUIDE.md 템플릿 순서대로 재정렬:

제목 (H1)
난이도 표기
한 줄 정의
왜 알아야 하는가?
핵심 개념
쉽게 이해하기
상세 설명
동작 원리 (해당 시)
예제 코드 (해당 시)
트레이드오프 (해당 시)
트러블슈팅 (해당 시)
면접 예상 질문
연관 문서
참고 자료

형식 통일

항목	기존 형식	새 형식
난이도	`난이도: 중급`	`> \`[3] 중급` · 선수 지식: 문서`
면접 질문	`- Q: 질문`	`### Q: 질문\n\nA: 답변`
트레이드오프	텍스트 나열	표 형식

4단계: 검증

동기화 후 체크:

모든 필수 섹션 존재
섹션 순서 올바름
난이도 표기 형식 통일
연관 문서 링크 유효
README.md 목차와 일치

5단계: 결과 보고

동기화 완료 후 보고서 출력:

## CS 문서 동기화 결과

### 전체 현황
- 총 문서 수: {N}개
- 동기화 완료: {N}개
- 수동 작업 필요: {N}개

### 카테고리별 상세

#### db/ (N개)
| 문서 | 상태 | 변경 사항 |
|------|------|----------|
| redis-caching.md | 완료 | 트러블슈팅 섹션 추가됨 |
| jpa.md | 수동 필요 | 연관 문서 링크 누락 |

#### network/ (N개)
...

### 수동 작업 필요 목록
1. `cs/db/jpa.md` - 연관 문서 섹션 내용 작성 필요
2. `cs/os/process.md` - 트러블슈팅 사례 추가 권장

동기화 규칙

자동 동기화 (안전)

다음 항목은 자동으로 수정:

항목	동작
누락 섹션 추가	`{TODO}` 마커와 함께 빈 섹션 추가
섹션 순서 정렬	템플릿 순서대로 재정렬
난이도 형식 변환	기존 형식 → 새 형식 자동 변환

수동 확인 필요

다음 항목은 사용자 확인 후 수정:

항목	이유
내용 수정	기존 내용 손실 방지
섹션 삭제	의도적 생략일 수 있음
링크 변경	연관 관계 판단 필요

트러블슈팅 섹션 추가 기준

실무 관련 주제에만 트러블슈팅 섹션 추가를 권장:

카테고리	트러블슈팅 권장 주제
db/	인덱스, 트랜잭션, 캐싱, 커넥션 풀
network/	HTTP, TLS, 타임아웃, DNS
system-design/	캐싱, 로드밸런싱, 메시지 큐
language/	JVM, GC, 메모리, 동시성

다음 주제는 트러블슈팅보다 이론 중심:

카테고리	이론 중심 주제
algorithm/	정렬, 탐색, DP, 그래프
data-structure/	배열, 리스트, 트리, 해시
programming/	SOLID, 디자인 패턴, OOP

사용 예시

전체 동기화

사용자: CS 동기화
Claude:
1. 전체 CS 문서 스캔 (32개)
2. 누락 섹션 분석
3. 동기화 범위 질문
4. 선택에 따라 동기화 실행
5. 결과 보고서 출력

특정 카테고리 동기화

사용자: DB 동기화
Claude:
1. cs/db/ 문서만 스캔 (8개)
2. 각 문서별 누락 섹션 확인
3. 동기화 실행
4. 결과 보고

새 섹션만 추가

사용자: 트러블슈팅 섹션 추가
Claude:
1. 트러블슈팅 권장 주제 문서 필터링
2. 해당 문서에 트러블슈팅 섹션 템플릿 추가
3. {TODO} 마커로 내용 작성 필요 표시

주의사항

백업 우선: 대량 수정 전 git status 확인
점진적 수정: 한 번에 모든 문서 수정보다 카테고리별 진행 권장
내용 보존: 기존 내용은 최대한 유지, 형식만 수정
수동 검토: 자동 동기화 후 반드시 수동 검토

cs-sync

Install Skill

SKILL.md