Cs Guide Writer

CS 문서 작성 도우미

CS-GUIDE.md 템플릿에 맞춰 학습 문서를 작성하는 Skill입니다.

트리거 키워드

• "오늘의 CS: {주제}" - 특정 주제로 문서 작성
• "오늘의 CS" - 주제 미지정 시 옵션 제안 (아래 참고)
• "CS 정리: {주제}"
• "{주제} 정리해줘" (CS 관련 주제인 경우)
• "최근 이슈 CS" - 최신 기술 트렌드 주제

"오늘의 CS" 주제 미지정 시 처리

주제 없이 "오늘의 CS"만 요청한 경우, AskUserQuestion 도구를 사용하여 다음 옵션을 제안:

옵션 1: 최신 트렌드 (Recommended)

• 웹 검색으로 현재 연도(시스템 날짜 기준) 최신 기술 트렌드 조사
  • 검색 쿼리에 반드시 현재 연도를 포함 (예: "2026 software engineering trends")
  • 하드코딩된 연도 사용 금지 — 항상 실행 시점의 연도를 동적으로 사용
• 가장 관련성 높은 주제 1개 선택하여 문서 작성
• 문서 상단에 Trend 마크 추가

옵션 2: 카테고리 선택

아래 카테고리 중 선택하면 해당 분야의 핵심 주제 추천:

옵션 3: TODO 목록

여러 주제를 한 번에 요청할 때 사용. 작성해야 할 문서를 리스트로 관리:

사용 예시:

• "오늘의 CS: 트랜잭션, 인덱스, 정규화 정리해줘"
• "Network 카테고리 기초 문서들 정리해줘"
• "면접 준비용으로 OS 핵심 5개 정리해줘"

처리 방식:

1. 요청된 주제들을 TodoWrite 도구로 TODO 목록에 추가
2. 각 주제별로 순차적으로 문서 작성
3. 완료된 항목은 completed로 표시
4. 전체 진행 상황을 사용자에게 표시

질문 형식 예시

오늘의 CS 주제를 어떻게 선택할까요?

1. 최신 트렌드 (Recommended) - 2025년 기술 트렌드에서 주제 선정
2. 카테고리 선택 - 관심 분야에서 핵심 주제 추천
3. TODO 목록 - 여러 주제를 리스트로 작성 (예: "트랜잭션, 인덱스, 정규화")

카테고리 판단 기준

난이도 체계

난이도는 3개로 고정하지 않고 유연하게 세분화할 수 있습니다.

핵심 원칙:

1. 카테고리 정의가 최우선 - 각 카테고리는 "~란?" 정의 문서로 시작
2. 선수 지식 기반 순서 - 선수 지식이 없는 것 → 있는 것 순서

문서 작성 템플릿

# {주제명}

> `[N] {레벨명}` · 선수 지식: [선수 문서](./path.md) 또는 "없음"

> `Trend` {연도}  ← 트렌드 주제인 경우에만 추가

> 한 줄 정의 (명확하고 간결하게)

`#핵심한글` `#CoreEnglish` `#약어` `#FullName` `#관련기술1` `#관련기술2` `#하위개념` `#사용사례` `#면접키워드` ... (최대 30개)

## 왜 알아야 하는가?

{이 개념을 왜 배워야 하는지}

- **실무**: {실무에서 어떻게 활용되는지}
- **면접**: {면접에서 왜 자주 나오는지}
- **기반 지식**: {이 개념이 다른 개념의 기반이 되는 이유}

## 핵심 개념

- {핵심 1}
- {핵심 2}
- {핵심 3}

## 쉽게 이해하기

{실생활 비유로 개념 설명}

## 상세 설명

### {소주제 1}

{내용}

**왜 이렇게 하는가?**
{이유 설명}

## 동작 원리 (해당 시)

{Mermaid 다이어그램으로 시각화 - mermaid-diagram 스킬 참조}

![{다이어그램 설명}](./images/{diagram-name}.svg)

## 예제 코드 (해당 시)

```java
// 예제 코드

코드 블록 언어 가이드

웹 뷰어(cs-web)의 Highlight.js 호환성을 위해 아래 언어를 사용합니다.

권장 언어 태그

주의사항

• powershell 사용 금지: Highlight.js 기본 빌드에 포함되지 않아 웹에서 하이라이팅 안됨
• Windows 명령어도 shell 또는 bash로 표기
• 언어 미지정 시 하이라이팅 없이 표시됨

트레이드오프 (해당 시)

트러블슈팅 (해당 시)

사례 1: {증상/문제 요약}

증상

{에러 메시지, 로그, 현상}

원인 분석

{왜 발생했는지 - 기술적 근거 포함}

해결 방법

{구체적인 명령어/코드와 함께 해결법 제시}

예방 조치

{모니터링, 설정 변경 등 재발 방지 방법}

면접 예상 질문

Q: {질문}

A: {답변 - "왜?"에 대한 설명 포함}

연관 문서

참고 자료

• {출처}

## 키워드 작성 가이드

문서 상단에 검색용 키워드를 작성합니다. 나중에 검색 시 해당 문서를 쉽게 찾을 수 있도록 합니다.

### 키워드 작성 원칙

1. **최대 30개**까지 작성 가능 (내용에 맞게 충분히 작성)
2. **한글/영문** 모두 포함 (검색 편의)
3. **약어와 전체 명칭** 모두 포함
4. **관련 기술/도구/서비스/프레임워크** 포함
5. **동의어/유사어/대체 용어** 포함
6. **사용 사례/시나리오** 관련 키워드 포함
7. **면접 키워드** 포함 (자주 나오는 질문 관련)

### 키워드 분류 체계

키워드는 다음 카테고리별로 작성합니다:

| 분류 | 설명 | 예시 |
|------|------|------|
| **핵심 개념** | 주제의 핵심 용어 (한글/영문) | `#트랜잭션` `#Transaction` |
| **약어/전체명** | 약어와 풀네임 | `#MSA` `#마이크로서비스` `#Microservices` |
| **관련 기술** | 함께 사용되는 기술/도구 | `#Spring` `#JPA` `#Hibernate` |
| **하위 개념** | 세부 개념/종류 | `#ReadCommitted` `#Serializable` |
| **사용 사례** | 실제 적용 시나리오 | `#분산락` `#동시성제어` `#데드락` |
| **비교 대상** | 대안/경쟁 기술 | `#MySQL` `#PostgreSQL` `#Oracle` |
| **면접 키워드** | 면접 빈출 주제 | `#ACID` `#격리수준` `#락` |

### 카테고리별 키워드 예시 (확장)

| 카테고리 | 주제 | 키워드 (최대 30개) |
|----------|------|-------------------|
| **AI/Agent** | AI Agent | `#AI에이전트` `#AIAgent` `#LLM` `#대규모언어모델` `#Claude` `#GPT` `#Gemini` `#ChatGPT` `#Anthropic` `#OpenAI` `#Google` `#자율AI` `#Agentic` `#ToolUse` `#FunctionCalling` `#ReAct` `#CoT` `#ChainOfThought` `#프롬프트` `#RAG` `#벡터DB` `#임베딩` `#파인튜닝` `#토큰` `#컨텍스트윈도우` |
| **Network** | WebSocket | `#웹소켓` `#WebSocket` `#WS` `#WSS` `#실시간통신` `#양방향통신` `#FullDuplex` `#Socket.io` `#STOMP` `#SockJS` `#채팅` `#푸시알림` `#게임서버` `#Polling` `#LongPolling` `#SSE` `#ServerSentEvents` `#HTTP업그레이드` `#핸드셰이크` `#연결유지` `#Stateful` `#Spring` `#Netty` |
| **DB** | 트랜잭션 | `#트랜잭션` `#Transaction` `#ACID` `#원자성` `#Atomicity` `#일관성` `#Consistency` `#격리성` `#Isolation` `#지속성` `#Durability` `#커밋` `#Commit` `#롤백` `#Rollback` `#격리수준` `#IsolationLevel` `#ReadUncommitted` `#ReadCommitted` `#RepeatableRead` `#Serializable` `#락` `#Lock` `#데드락` `#Deadlock` `#동시성` `#MVCC` |
| **OS** | 프로세스 | `#프로세스` `#Process` `#스레드` `#Thread` `#PCB` `#ProcessControlBlock` `#컨텍스트스위칭` `#ContextSwitch` `#스케줄링` `#Scheduling` `#fork` `#exec` `#IPC` `#프로세스간통신` `#공유메모리` `#파이프` `#소켓` `#메시지큐` `#좀비프로세스` `#고아프로세스` `#멀티프로세스` `#멀티스레드` |
| **System Design** | MSA | `#MSA` `#마이크로서비스` `#Microservices` `#분산시스템` `#DistributedSystem` `#API게이트웨이` `#APIGateway` `#서비스메시` `#ServiceMesh` `#Istio` `#Envoy` `#서비스디스커버리` `#로드밸런싱` `#서킷브레이커` `#Resilience4j` `#Saga패턴` `#CQRS` `#이벤트소싱` `#EventDriven` `#Kafka` `#RabbitMQ` `#Docker` `#Kubernetes` `#컨테이너` `#오케스트레이션` |
| **Programming** | OOP | `#OOP` `#객체지향` `#ObjectOriented` `#캡슐화` `#Encapsulation` `#상속` `#Inheritance` `#다형성` `#Polymorphism` `#추상화` `#Abstraction` `#SOLID` `#SRP` `#OCP` `#LSP` `#ISP` `#DIP` `#클래스` `#Class` `#인터페이스` `#Interface` `#추상클래스` `#오버라이딩` `#오버로딩` `#디자인패턴` `#의존성주입` `#DI` |
| **Security** | JWT | `#JWT` `#JsonWebToken` `#토큰` `#Token` `#인증` `#Authentication` `#인가` `#Authorization` `#AccessToken` `#RefreshToken` `#Bearer` `#Claim` `#Payload` `#Header` `#Signature` `#HS256` `#RS256` `#만료시간` `#토큰탈취` `#토큰무효화` `#블랙리스트` `#OAuth` `#OIDC` `#세션` `#Stateless` |

### 키워드 포맷

```markdown
`#핵심한글` `#CoreEnglish` `#약어` `#관련기술1` `#관련기술2` `#하위개념1` `#하위개념2` `#사용사례` `#비교대상` `#면접키워드`

키워드 개수 가이드

작업 절차

CS 문서 작성은 **팀 모드(병렬)**를 기본으로 사용한다. Claude 본체가 문서를 작성하는 동안, 전문 에이전트가 다이어그램 생성과 README 업데이트를 동시에 처리한다.

팀 구성

1단계: 기획

카테고리, 난이도, 문서 구조, 다이어그램 스펙을 결정한다.

• 카테고리 판단: 주제에 맞는 카테고리 선택
• 난이도 판단: [1] 정의/기초 → [2] 입문 → [3] 중급 → [4] 심화
  • 카테고리 정의 문서("~란?")는 반드시 [1]
  • 선수 지식이 없으면 낮은 레벨, 있으면 높은 레벨
• 다이어그램 스펙: 필요한 다이어그램 목록과 방식(SVG/Mermaid) 결정

기획 결과:
- 카테고리: cs/{category}/
- 파일명: {topic}.md
- 난이도: [N] {레벨명}
- 선수 지식: {목록}
- 다이어그램 목록:
  1. {name} ({유형}, "{설명}", {방식})
  2. {name} ({유형}, "{설명}", {방식})
  3. {name} ({유형}, "{설명}", {방식})

2단계: 병렬 실행

하나의 메시지에서 3개 작업을 동시에 시작한다:

[Task 1] cs-diagram-generator (백그라운드)

CS 문서용 다이어그램을 생성해줘.

카테고리: cs/{category}/
다이어그램:
1. {filename} ({유형}, "{설명}", {방식: SVG 직접 / Mermaid})
2. {filename} ({유형}, "{설명}", {방식})

에이전트 정의의 작업 흐름과 품질 기준을 따라서 결과를 반환해줘.

[Task 2] cs-index-manager (백그라운드)

CS 문서 인덱스를 업데이트해줘.

카테고리: cs/{category}/
파일명: {topic}.md
제목: {H1 제목}
난이도: [N] {레벨명}
선수 지식: {목록 또는 "없음"}
트렌드: {여부}
한 줄 설명: {요약}

에이전트 정의의 작업 흐름을 따라서 결과를 반환해줘.

[Claude 본체] 문서 본문 작성

• cs/{category}/{topic}.md 파일 직접 Write
• 위 문서 작성 템플릿 준수
• 다이어그램 참조는 ![설명](./images/{name}.svg) 로 미리 삽입
• 정의: 한 문장으로 명확하게
• 키워드: 검색용 키워드 10~30개
• 왜 알아야 하는가: 실무/면접/기반지식 관점
• 난이도 태그 + 연관 문서 필수

3단계: 통합

모든 작업 완료 후:

1. 에이전트 결과 확인 (생성된 파일 목록, README 변경 내용)
2. git add 실행 (문서 + 이미지 + README 모두 staging)

품질 기준

트러블슈팅 품질 기준

최근 이슈 CS 처리

"최근 이슈 CS" 요청 시:

1. 웹 검색으로 현재 연도(시스템 날짜 기준) 최신 기술 트렌드 조사
   • 검색 쿼리에 반드시 현재 연도를 포함 (예: "{현재연도} technology trends developer")
2. 가장 관련성 높은 주제 1개 선택
3. 적절한 카테고리에 문서 생성 (주로 ai-agent/ 또는 주제에 맞는 카테고리)
4. 문서 상단에 Trend 마크 추가
5. cs/trend/README.md에도 링크 추가 (트렌드 인덱스)

다이어그램 가이드

다이어그램 생성은 cs-diagram-generator 에이전트에 위임한다. 기획 단계에서 다이어그램 스펙만 결정하면 된다.

방식 선택 기준 (기획 시 참고)

다이어그램 스펙 작성법

기획 단계에서 아래 형식으로 스펙을 정의하면 에이전트가 생성한다:

다이어그램:
1. {파일명} ({유형}, "{설명}", {방식: SVG 직접 / Mermaid})

마크다운 삽입

문서 본문에서 미리 참조를 삽입한다 (에이전트가 파일을 생성):

![{설명}](./images/{name}.svg)