stock-oracle/dev/phase5_deliverables/README.md

Phase 5 Deliverables — Attention Overlay Development Docs

목적

Phase 5는 Phase 0~4에서 구축한 공식 이벤트 + 가격 확인 기반 코어 전략 위에, 무료 attention/crowding 데이터를 보조 신호(overlay) 로 추가하는 단계입니다.

핵심 원칙:

• 코어 신호 없이 overlay만으로 진입하지 않는다.
• overlay는 후보 우선순위 조정, 보유기간 조절, 포지션 추가/축소 보조 에만 사용한다.
• 무료 데이터 정책을 유지한다.
• 소스별 약관/쿼터/지연/신뢰도 차이를 명시적으로 반영한다.

포함 문서

• attention_overlay_architecture.md
• source_integration_specs.md
• feature_design_and_entity_resolution.md
• overlay_scoring_policy.md
• implementation_plan.md
• testing_checklist.md
• operations_and_monitoring.md
• youtube_channel_registry_spec.md
• overlay_feature_record.schema.json
• overlay_config.schema.json

범위

포함

• Yahoo Finance RSS headline burst
• YouTube whitelist channel monitoring
• Wikimedia pageview shock
• Google Trends experimental theme heat
• FINRA crowding feature integration (Phase 2 데이터 재사용)
• attention overlay score 산출
• backtester/live trader에 overlay score 연결

제외

• X/Twitter API 연동
• Reddit 라이브 핵심 의존성화
• Stocktwits 신규 핵심 의존성화
• 실시간 초단타 소셜 트리거 매매
• 자막 전체 전수 수집 기반 파이프라인

성공 기준

• overlay 미사용 대비 후보 정렬 품질이 개선되어야 한다.
• overlay 추가 후 코어 전략 수익성이 악화되더라도 원인을 attribution 가능해야 한다.
• overlay 장애 발생 시 자동으로 core-only 모드로 degrade 되어야 한다.