Cs Guide Writer

여러 주제를 한 번에 요청할 때 사용합니다.

처리 방식:

1. 요청된 주제들을 TodoWrite 도구로 TODO 목록에 추가
2. 각 주제별로 순차적으로 문서 작성
3. 완료된 항목은 completed로 표시

사용 예시: "오늘의 CS: 트랜잭션, 인덱스, 정규화 정리해줘"

작업 절차

CS 문서 작성은 **팀 모드(병렬)**를 기본으로 사용합니다.

팀 구성

1단계: 기획

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

• 카테고리 판단: references/category-table.md를 Read 도구로 읽어서 참조하세요
• 난이도 판단: [1] 정의/기초 → [2] 입문 → [3] 중급 → [4] 심화
  • 카테고리 정의 문서("~란?")는 반드시 [1]
  • 선수 지식이 없으면 낮은 레벨, 있으면 높은 레벨
  • 난이도 체계 상세는 references/template.md를 Read 도구로 읽어서 참조하세요
• 다이어그램 스펙: 필요한 다이어그램 목록과 방식(Mermaid/SVG) 결정
  • 다이어그램 방식 선택 기준은 references/template.md를 참조하세요

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

2단계: 병렬 실행

하나의 메시지에서 모든 작업을 동시에 시작합니다.

[다이어그램] 분할 디스패치 규칙

핵심 원칙: 다이어그램 1개 = 에이전트 1개. 무조건 분할한다.

# 다이어그램이 2개인 경우 → 에이전트 2개 병렬 디스패치
[다이어그램 에이전트 A] ──── diagram-1.svg ──── (~30초)
[다이어그램 에이전트 B] ──── diagram-2.svg ──── (~30초)
[인덱스 에이전트]       ──── README 업데이트 ── (~50초)
[Claude 본체]          ──── 문서 작성 ───────── (~5초)
                                         총 ~50초 (병렬 최대값)

[다이어그램 에이전트 프롬프트 템플릿] (에이전트당 1개):

CS 문서용 다이어그램 1개를 생성해줘.

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

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

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

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

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

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

[Claude 본체] 문서 본문 작성

문서 작성 템플릿은 references/template.md를 Read 도구로 읽어서 참조하세요. 키워드 작성 방법은 references/keywords-guide.md를 Read 도구로 읽어서 참조하세요.

• 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에도 링크 추가 (트렌드 인덱스)