[2026.10.29] GitHub KaTeX 수식 디버깅과 퀀타멘털 스윙 설계
🛠️ Build Log: 아키텍트 × AI 데일리 구축 일지 (Daily Build Log Navigator)
엔지니어링 일지 요약: GitHub 마크다운 파서와 KaTeX 간의 언더스코어(
_) 충돌 현상을 디버깅하여 수식 표기 가이드라인을 확립하고, 재무 팩터와 기술적 모멘텀을 결합한 퀀타멘털 스윙 전략을 설계한 기록입니다.
1. 오늘의 주요 작업 및 설계 결정 (Key Decisions & Changes)
- GitHub KaTeX 수식 렌더링 호환성 헌법 제정:
- 마크다운 파서가 수식 내부의 언더스코어(
_)와 별표(*)를 이탤릭/볼드 태그로 오해하여 수식이 깨지는 현상 해결. - 규칙 1: 첨자 언더스코어는 반드시
_로 이스케이프 처리. - 규칙 2: 수식 블록(
$$...$$)의 전후에는 반드시 빈 줄을 삽입. - 규칙 3: 행렬/분수식 등 다중 연산 수식은 인라인 대신 독립 블록으로 분리.
- 퀀타멘털 스윙(Quantamental Swing) 2계층 필터링 설계:
- 단기 노이즈를 배제하고 실적 턴어라운드 종목을 포착하기 위해 펀더멘털과 모멘텀 결합:
- 1차 펀더멘털 스크리닝: 영업이익 성장률 YoY > 20%, Piotroski F-Score >= 7점, 부채비율 < 150%.
- 2차 기술적 모멘텀 진입: 주가 > 200일 SMA(장기 상승 추세), 20일 모멘텀 양수 전환, 14일 RSI 45~65(과열권 진입 전 눌림목).
2. 핵심 수식 및 파이프라인 (Formula & Pipeline)
🔍 원본 Mermaid 아키텍처 도식 (상시 개방)
flowchart LR
A["전체 상장 종목 유니버스"] --> B["1차: 펀더멘털 필터<br/>(YoY 영업이익 > 20% & F-Score >= 7)"]
B --> C["2차: 기술적 모멘텀 필터<br/>(주가 > 200 SMA & RSI 45~65)"]
C --> D["최종 스윙 편입 포트폴리오<br/>(동일 비중 분산)"]
- 복합 팩터 점수화 수식:
$$Score_i = w_1 cdot Z(Growth_{YoY}) + w_2 cdot Z(F_Score) + w_3 cdot Z(Mom_{20D})$$
3. 트러블슈팅 & 기술 검증 (Troubleshooting & Verification)
- 발생 문제:
quant-research보고서 내 복잡한 수식들이 GitHub 웹 UI에서 깨지거나 파싱 에러로 렌더링되지 않던 문제. - 해결 조치: 수식 검증 스크립트 작성 및
_이스케이프 헌법 일괄 적용 후 전수 검사 완료. - 검증 결과: GitHub 웹 UI 및 워드프레스 블로그 양쪽에서 모든 KaTeX 수식 100% 정상 렌더링 확인.
4. 완료 산출물 및 다음 단계 (Deliverables & Next Steps)
- 완료 산출물:
quant-research/docs/rules/katex-math-guide.md(GitHub KaTeX 표기 헌법)quant-research/specs/02_quantamental_swing_spec.md(퀀타멘털 스윙 전략 명세서)- 다음 작업: 5대 중장기 퀀트 전략 완주 및 3계층 저장소 아키텍처 연동.