리서치 프로토콜 (Research Protocol)

빠른 참조

목적

리서치 프로토콜은 소스 검증, 미디어 수집, 인용 관리를 포함하여 aStory 블로그 콘텐츠 생성을 위한 포괄적인 웹 리서치 기능을 제공한다.

핵심 기능

다단계 웹 검색 (Multi-Stage Web Search):

• 핵심 주제를 직접 타겟팅하는 1ì°¨ 검색
• 관련 개념으로 확장하는 2ì°¨ 검색
• 특정 기술 세부사항을 타겟팅하는 3ì°¨ 검색
• 주요 주장을 확인하는 검증 검색

미디어 수집 (Media Collection):

• 라이선스 추적이 있는 검증된 소스에서 이미지 추출
• 타임스탬프 분석이 있는 YouTube 동영상 수집
• 콘텐츠 섹션에 리소스를 매핑하는 사용 계획

소스 검증 (Source Verification):

• WebFetch를 통한 URL 접근성 확인
• 콘텐츠 최신성 검증 (6개월 이상된 소스에 대한 업데이트)
• 여러 소스에서 사실 정확성 교차 검증
• 저자 신뢰도 평가

리서치 브리프 출력

리서치 프로세스는 다음을 포함하는 구조화된 브리프를 생성한다:

• 주요 발견 사항이 포함된 주제 요약
• URL, 유형, 관련성 등급이 있는 번호 매겨진 소스 목록
• URL, 설명, 라이선스 정보가 있는 이미지 컬렉션
• YouTube 링크, 타임스탬프, 사용 계획이 있는 동영상 컬렉션
• 각 콘텐츠 섹션을 지원하는 리소스를 보여주는 섹션 매핑
• 참조 섹션을 위한 형식화된 인용

구현 가이드

리서치 워크플로우

리서치는 광범위한 검색에서 구체적인 리소스 할당으로 구축되는 5단계 프로세스를 따른다.

1단계 – 주제 분석:

• 핵심 개념을 식별하기 위해 주제 검토
• 관련 기술과 권위 있는 소스 식별
• 콘텐츠 유형에 기반한 검색 전략 결정

2단계 – 웹 검색 실행:

• 다양한 쿼리 구성으로 다중 검색 수행
• 주제의 다른 측면 타겟팅
• ê²°ê³¼ 수집 및 중복 제거

3단계 – 소스 검증:

• 각 잠재적 소스를 신뢰성, 최신성, 관련성에 대해 평가
• 검증된 소스만 수집 단계로 진행
• 소스 유형 추적 및 공식 문서 우선

4단계 – 미디어 수집:

• 검증된 소스에서 이미지와 YouTube 동영상 추출
• 모든 미디어의 라이선스 정보 추적
• 맥락과 계획된 사용 문서화

5단계 – 브리프 편집:

• 모든 리소스를 구조화된 브리프로 정리
• 리소스 할당이 있는 섹션 매핑 생성
• 참조 섹션을 위한 인용 형식화

소스 우선순위 계층

공식 문서 (최우선):

• Anthropic 문서, 공식 GitHub 저장소, 회사 블로그 포스트
• 가장 권위 있고 정확한 소스

확립된 기술 출판물 (2순위):

• 인정받는 기술 블로그, 컨퍼런스 논문, 동료 검토 콘텐츠
• 편집 감독이 있는 강한 신뢰성

커뮤니티 리소스 (3순위):

• 높은 점수의 Stack Overflow 답변
• 공식 응답이 있는 GitHub 이슈
• 정확성이 검증된 튜토리얼 사이트

개인 블로그 포스트 (4순위):

• 포함 전 추가 검증 필요
• 가치 있는 통찰이 있을 수 있지만 교차 검증 필요

뉴스 기사 (5순위):

• 맥락을 제공하지만 기술적 깊이는 드뭄
• 타임라인과 산업 맥락에 사용

검증 요구사항

모든 소스는 포함 전 검증 기준을 충족해야 한다:

URL 접근성:

• WebFetch 도구가 각 URL이 유효한 콘텐츠를 반환하는지 확인
• 깨진 링크는 폐기하거나 대체

콘텐츠 최신성:

• 6개월 이상된 소스는 업데이트된 버전 확인
• 기술 버전과 릴리스 날짜 검증

사실 정확성:

• 주요 주장은 최소 하나의 추가 소스에 나타나야 함
• 통계와 벤치마크 교차 참조

저자 신뢰도:

• 알려진 전문가와 공식 대표자에 더 높은 가중치
• 익명 또는 미지의 저자는 더 강한 교차 검증 필요

상세한 검색 프로토콜은 web-search-protocol.md 참조.

고급 패턴

이미지 수집 프로토콜

이미지 수집은 적절한 미디어 사용을 보장하기 위한 특정 가이드라인을 따른다:

우선 이미지:

• 공식 문서의 아키텍처 다이어그램
• 기능을 보여주는 주석이 달린 스크린샷
• 개념을 설명하는 인포그래픽
• 비교 시각화

라이선스 추적:

• 크리에이티브 커먼즈 라이선스 선호
• 미지의 라이선스는 직접 이미지 파일이 아닌 소스 페이지를 가리키는 이미지 URL 필요
• 각 이미지의 라이선스 ì¡°ê±´ 문서화

맥락 문서화:

• 이미지가 어디서 발견되었는지 설명
• 무엇을 묘사하는지 설명
• 콘텐츠를 어떻게 지원하는지 명확화
• 적절한 alt 텍스트와 캡션 생성 가능하게 함

사용 계획:

• 각 이미지를 특정 콘텐츠 섹션에 할당
• 동일 위치에 여러 이미지가 경쟁하지 않도록 방지
• 콘텐츠 전반에 걸쳐 이미지 분포 균형

상세한 미디어 수집 절차는 media-collection.md 참조.

YouTube 수집 프로토콜

YouTube 동영상은 적절히 큐레이션될 때 가치 있는 보충 콘텐츠를 제공한다:

우선 동영상:

• 공식 제품 데모
• 인정받는 전문가의 컨퍼런스 발표
• 관련 기능의 튜토리얼 워크스루
• 확립된 채널의 기술 딥다이브

타임스탬프 분석:

• 주제와 관련된 특정 세그먼트 식별
• 전체 동영상보다 타임스탬프 범위 기록
• 독자가 관련 섹션으로 점프할 수 있게 함

임베드 계획:

• 동영상 임베드에 YouTubeCard 컴포넌트 사용
• 각 동영상을 특정 콘텐츠 위치에 할당
• 동영상이 섹션을 지원하는 이유를 설명하는 맥락 제공

리서치 브리프 구조

리서치 브리프는 다운스트림 에이전트가 파싱 가능한 표준화된 형식을 따른다:

수집 요약:

• 주제 식별자
• 수집된 소스, 이미지, 동영상 수
• 검색 전략 개요

소스 섹션:

• ID, URL, 제목이 있는 각 검증된 소스
• 유형 분류 (공식, 출판물, 커뮤니티 등)
• 관련성 등급 (높음, 중간, 낮음)
• 콘텐츠에서 추출된 핵심 포인트

이미지 섹션:

• URL, alt 텍스트가 있는 각 수집된 이미지
• 맥락 설명
• 계획된 사용 위치
• 라이선스 정보

동영상 섹션:

• URL, 제목, 길이가 있는 각 YouTube 동영상
• 관련 세그먼트를 위한 타임스탬프 노트
• 계획된 사용과 근거

섹션 매핑:

• 콘텐츠 구조에 리소스 할당
• 어떤 소스가 도입부를 지원하는지 보여줌
• 미디어 임베드가 어디에 나타나야 하는지 표시

인용 섹션:

• 참조 섹션을 위한 사전 형식화된 항목
• 일관된 인용 표준 따름

모듈 참조

검색 프로토콜:

• web-search-protocol.md – 다단계 검색 전략, 쿼리 구성, ê²°ê³¼ 필터링

미디어 수집:

• media-collection.md – 이미지 추출, YouTube 큐레이션, 라이선스 추적, 사용 계획

함께 사용하면 좋은 것들

스킬:

• writing-standards – 리서치 브리프에서 생성된 콘텐츠에 품질 규칙 적용
• personas – 특성 스타일로 콘텐츠를 생성하기 위해 리서치 브리프 소비
• anti-ai-validator – 소스 인용이 품질 표준을 충족하는지 검증

커맨드:

• post – 리서치부터 글쓰기, 발행까지 전체 워크플로우 조율

품질 표준

소스 검증 요구사항

모든 소스는 다음 기준을 충족해야 한다:

• URL이 WebFetch를 통해 유효하고 접근 가능한 콘텐츠 반환
• 콘텐츠 최신성이 논의되는 기술 버전에 적절
• 사실이 최소 하나의 추가 독립 소스에서 교차 검증됨
• 저자 신뢰도가 평가되고 문서화됨

미디어 검증 요구사항

이미지:

• 모든 이미지 URL이 유효하고 접근 가능
• 라이선스 정보가 완전히 문서화됨
• 맥락 설명이 전체 세부사항 제공
• 사용 계획이 특정 섹션에 할당됨

동영상:

• 모든 YouTube URL이 유효하고 접근 가능
• 타임스탬프가 정확하고 관련됨
• 임베드 위치가 적절히 계획됨

브리프 완전성 요구사항

섹션 매핑:

• 모든 주요 콘텐츠 섹션에 할당된 리소스 있음
• 섹션 할당 없는 고아 리소스 없음
• 인용이 적절히 형식화됨

브리프 구조:

• 구조화된 형식 사용 시 YAML 구문 유효
• 모든 필수 섹션 존재
• 카운트가 실제 수집된 항목과 일치

Version: 2.0.0 Last Updated: 2026-01-06 Category: Content Preparation Type: Research and Verification Status: Production Ready