JW's AI_Stash

SKILL

13 min read

gemini-researcher로 웹 조사를 수행한 뒤 문서 세트를 작성한다. $ARGUMENTS에 주제, 모드(--mode), 저장 경로(--path)를 지정할 수 있다.

STEP 1 — 모드 판별

사용자 메시지와 $ARGUMENTS를 분석해 모드를 결정한다.

OVERVIEW 모드 — 단일 기술·개념을 깊이 학습할 때:

  • “~이 뭐야”, “~에 대해 알려줘”, “~을 알고 싶어”, “~개요”, “~찾아봐”
  • --mode overview 명시

PIPELINE 모드 — 동작 흐름·내부 구조를 분석할 때:

  • “~어떻게 동작해”, “~파이프라인”, “~흐름”, “~과정이 궁금해”, “~내부 구조”, “~동작 원리”
  • --mode pipeline 명시

SURVEY 모드 — 여러 서비스·방식을 비교 조사해 업계 현황을 파악할 때:

  • “~비교해줘”, “업계 표준”, “어떤 방식들이 있어”, “현황 조사”, “종류가 뭐야”
  • “어디서는 어떻게 하는지”, “~들을 정리해줘”, “리서치해줘”, “~사례 조사”
  • --mode survey 명시

판별 기준: OVERVIEW는 하나를 깊이 이해, PIPELINE은 흐름을 추적, SURVEY는 여러 대상을 비교·지도화. 모드가 불분명하면 사용자에게 확인한다.

STEP 2 — 주제 및 저장 경로 확인

  1. $ARGUMENTS 또는 사용자 메시지에서 주제명을 추출한다 (영문/한글 모두 가능)
  2. 저장 경로 결정:
    • --path {경로} 인수가 있으면 해당 경로 사용
    • 없으면 사용자에게 저장할 폴더 경로를 묻는다
  3. 파일명 prefix 결정:
    • 저장 폴더 내 숫자.숫자.*.md 패턴 파일 확인
    • 폴더 내 최대 숫자 + 1로 다음 인덱스 계산 (없으면 1)
    • 예: 기존 2.3.whatIsMCP.md가 있으면 다음은 2.4.

STEP 3 — 웹 조사 (gemini-researcher)

gemini-researcher 에이전트를 실행해 아래 항목을 조사한다. 에이전트 호출 시 모드별 조사 요청을 명확히 전달한다.

OVERVIEW 모드 조사 항목

  • 주제의 정의 및 핵심 개념
  • 주요 특징과 장단점
  • 관련 도구·기술·플랫폼
  • 실전 사용 예제 (코드 포함)
  • 공식 문서·참고 자료 URL

PIPELINE 모드 조사 항목

  • 주제 관련 핵심 용어 정의 (라이브러리·API 포함)
  • 전체 아키텍처 및 구성 요소
  • 단계별 처리 흐름 (입력 → 처리 → 출력)
  • 각 단계에서 호출되는 함수·API·모듈
  • 실전 예제 코드
  • 공식 문서·참고 자료 URL

SURVEY 모드 조사 항목

  • 주제가 해결하려는 문제 정의 및 배경
  • 존재하는 방식·기술·서비스의 전체 분류 (카테고리 지도)
  • 각 방식·서비스별 상세 정보: 동작 원리, 장단점, 실제 채택 사례
  • 주요 플레이어(기업·서비스·표준 기관) 현황 테이블
  • 관련 규정·표준·가이드라인 (있는 경우)
  • 상황별 선택 기준 및 권장 구성
  • 공식 문서·참고 자료 URL (각 서비스·방식마다)

조사 완료 후 결과를 받아 STEP 4로 진행한다.

STEP 4 — 문서 작성

STEP 3 결과 + 사용자 제공 자료 + Claude 지식을 합쳐 문서를 작성한다. 모든 문서는 D:\99.개인\git\quartz\content\personalSetting\CLAUDE.md의 문서 템플릿 (Sample B) 및 말투 스타일 규칙을 따른다.

공통 문서 규칙

  • 파일 네이밍: {인덱스}.camelCase.md (예: 3.1.whatIsMCP.md)
  • 언어: 한국어 (코드·용어는 원문 유지)
  • 말투: 설명체 (~된다, ~한다, ~가능하다)
  • Mermaid 방향: 반드시 세로 (TD/TB), 가로(LR) 금지
  • Mermaid 줄바꿈: 노드 텍스트 안에서 줄바꿈할 때 \n 사용 금지, 반드시 <br/>를 사용한다 (예: A["첫째 줄<br/>둘째 줄"])
  • Wikilinks: [[파일명|표시텍스트]] (테이블 안에서는 [[파일명\|표시텍스트]])
  • 문서 탐색 테이블: 각 문서의 이전·다음 링크를 작성 (같은 세트 내 순서로 연결)
  • 코드 예제 언어: 사용자가 언어를 지정하지 않으면 Vanilla JS(순수 JavaScript, ESM) 를 기본값으로 사용한다. 백엔드 코드는 Node.js(ESM) 까지 허용한다. TypeScript, React 등은 사용자가 명시한 경우에만 사용한다.

OVERVIEW 모드 — 문서 3개

폴더 구조는 CLAUDE.md Basic 폴더 (도구 학습형) 패턴을 따른다.

문서 1 — whatIs[주제].md

x.x.1.whatIs[주제]

포함 내용:

  • 핵심 요약 테이블 (정의, 핵심, 대상, 주의)
  • 배경 및 등장 이유
  • 핵심 개념 설명 (테이블 또는 설명 + 도식)
  • 주요 특징 및 장단점 비교 테이블
  • 관련 기술·도구·플랫폼 현황 테이블
  • 문서 탐색 (이전: —, 다음: 핵심내용 문서)
  • 참고 자료

문서 2 — [주제]핵심내용.md

x.x.2.[주제]핵심내용

포함 내용:

  • 핵심 요약 테이블
  • 주요 기능 목록 및 상세 설명
  • 설정·사용법 가이드 (단계별)
  • 자주 쓰는 패턴·옵션 테이블
  • Mermaid로 구조/관계 시각화 (해당할 경우)
  • 주의사항 및 팁
  • 문서 탐색 (이전: whatIs 문서, 다음: samples 문서)
  • 참고 자료

문서 3 — [주제]samples.md

x.x.3.[주제]samples

포함 내용:

  • 핵심 요약 테이블
  • 실전 예제 목록 (어떤 예제인지 인덱스 형태로 소개)
  • 각 예제: 시나리오 설명 + 코드 블록 + 실행 결과(있으면)
  • 예제 간 비교 또는 응용 팁
  • 문서 탐색 (이전: 핵심내용 문서, 다음: —)
  • 참고 자료

PIPELINE 모드 — 문서 3~4개

폴더 구조는 CLAUDE.md Advanced 폴더 (개념 탐구형) 패턴을 따른다.

문서 1 — [주제]definition.md

x.x.1.[주제]definition

포함 내용:

  • 핵심 요약 테이블
  • 용어 정의 테이블 (용어 / 설명 / 비고)
    • 핵심 개념 용어
    • 사용 라이브러리·API·모듈 목록 (이름 / 역할 / 버전/링크)
  • 문서 탐색 (이전: —, 다음: overview 문서)
  • 참고 자료

문서 2 — [주제]overview.md

x.x.2.[주제]overview

포함 내용:

  • 핵심 요약 테이블 (정의, 핵심, 대상, 주의)
  • 이 기술/코드가 해결하는 문제 (배경)
  • 전체 아키텍처 구성 요소 테이블 (구성 / 역할 / 비고)
  • Mermaid로 전체 구조 시각화 (graph TD)
  • 주요 특징 및 한계
  • 문서 탐색 (이전: definition 문서, 다음: pipeline 문서)
  • 참고 자료

문서 3 — [주제]pipeline.md

x.x.3.[주제]pipeline

포함 내용:

  • 핵심 요약 테이블
  • 파이프라인 단계 개요 테이블 (단계 번호 / 단계명 / 설명 / 입출력)
  • Mermaid sequenceDiagram 또는 flowchart TD로 전체 흐름 시각화
  • 각 단계 상세 설명:
    • 무엇을 하는가
    • 어떤 함수·API·모듈이 개입하는가
    • 입력값과 출력값
    • 주의사항 (있을 경우)
  • 문서 탐색 (이전: overview 문서, 다음: examples 문서 또는 —)
  • 참고 자료

문서 4 — [주제]examples.md (선택)

예제 코드가 충분한 경우에만 작성한다. 조사 결과에 실전 예제가 없거나 빈약하면 생략하고 사용자에게 알린다.

x.x.4.[주제]examples

포함 내용:

  • 핵심 요약 테이블
  • 전체 파이프라인을 실행하는 예제 코드 (단계별 주석 포함)
  • 각 단계 출력 결과 (코드 블록)
  • 변형 예제 또는 엣지 케이스
  • 문서 탐색 (이전: pipeline 문서, 다음: —)
  • 참고 자료

SURVEY 모드 — 문서 3개

여러 서비스·방식을 비교 조사해 업계 현황을 지도화하는 구조다.

문서 1 — [주제]landscape.md

x.x.1.[주제]landscape

포함 내용:

  • 핵심 요약 테이블 (정의, 핵심, 대상, 주의)
  • 문제 정의 — 왜 이 주제가 중요한가, 어떤 위협·필요에서 출발하는가
  • 전체 기술·방식·서비스 분류 (Mermaid flowchart TD로 카테고리 지도화)
  • 주요 플레이어 현황 테이블 (서비스명 / 유형 / 인증 방식 / 특이사항)
  • 관련 규정·표준·가이드라인 현황 (있는 경우)
  • 문서 탐색 (이전: —, 다음: comparison 문서)
  • 참고 자료

문서 2 — [주제]comparison.md

x.x.2.[주제]comparison

포함 내용:

  • 핵심 요약 테이블
  • 각 방식·서비스 상세 설명 (항목마다: 동작 원리 → Mermaid 흐름도 → 장단점 → 실제 채택 사례)
  • 종합 비교 테이블 (방식 / 강점 / 약점 / 적합 상황 / 주요 사용처)
  • 문서 탐색 (이전: landscape 문서, 다음: guide 문서)
  • 참고 자료

문서 3 — [주제]guide.md

x.x.3.[주제]guide

포함 내용:

  • 핵심 요약 테이블
  • 상황별 선택 기준 (Decision Tree — Mermaid flowchart TD 또는 조건 테이블)
  • 권장 구성 레벨별 정리 (기본 / 표준 / 고급)
  • 구현 체크리스트 테이블 (항목 / 확인 방법 / 통과 기준)
  • 핵심 코드 스니펫 또는 설정 예시 (있는 경우)
  • 문서 탐색 (이전: comparison 문서, 다음: —)
  • 참고 자료

STEP 5 — 완료 보고

모든 문서 작성 완료 후 사용자에게 아래를 알린다.

  • 작성된 파일 목록 (전체 경로)
  • 각 문서의 한 줄 요약
  • 조사에서 발견된 주요 참고 자료 URL 목록
  • 예제 문서(문서 4)를 생략했다면 그 이유

문서 템플릿 참조

각 문서는 아래 frontmatter와 구조를 사용한다.

---
title: 문서 제목
author: Claude Code
date: YYYY-MM-DD
tags: [주제태그, 관련태그]
---
 
# 문서 제목
 
> 한 줄 요약.
> 업데이트: YYYY-MM-DD
 
---
 
## 핵심 요약
 
| 구분 | 내용 |
|---|---|
| 📖 **정의** | ... |
| 💡 **핵심** | ... |
| 🎯 **대상** | ... |
| ⚠️ **주의** | ... |
 
---
 
## 목차
 
1. [섹션1](#섹션1)
2. [섹션2](#섹션2)
 
---
 
## 섹션1
 
...
 
---
 
## 문서 탐색
 
| 이전 | 다음 |
|------|------|
| [[이전파일명\|이전 제목]] | [[다음파일명\|다음 제목]] |
 
---
 
## 참고 자료
 
- [출처명](URL)

Graph View