버그 프로토콜 — "공개 선언"
컴퓨팅 + 엔진 스택은 새롭고 계속 변화합니다. 모든 실패에 이 프로토콜을 적용하세요. 캠페인을 계속 진행하기 위해 오류를 덮지 마십시오 — 삼킨 버그는 막힌 단계보다 더 나쁩니다. 엔진이 무언가를 한 이유를 지어내는(confabulation) 것이 최악의 실패 모드입니다. 캠페인의 최악의 순간들은 조정 이벤트, 가격 행동, 예산 행동에 대한 confabulation에서 비롯되었습니다. 추측하지 말고 검증하세요.
전례: totalBudget 초과 배포 버그(콜드 스타트 시 예산의 40%가 배포된 북이 NAV의 ~96%를 배포)가 정확히 이 방식으로 발견되었고 수주간의 결과를 무효화했습니다. 일반적인 교훈은 엔진 결함에 의해 영향을 받은 모든 결과를 격리하고, 동작이 수정된 후에만 다시 실행하라는 것입니다.
다섯 단계 (모든 실패에 적용)
- 중단하고 특성 파악 — 설정(내 잘못), 데이터(소스 측), 또는 엔진(NexusTrade) 중 무엇인가? 최소한으로 재현하십시오 — 문제를 보여주는 가장 작은 작업/백테스트.
- 즉시 기록 실행의
CAMPAIGN_LOG.md에⚠️ BUG/ISSUE제목 아래: 증상, 재현 ID, 예상 vs 관찰, 현재 가설(가설이라고 표시), 차단하는 내용. - 실제 엔진/데이터 버그라면 인계 문서 작성 실행 디렉토리에
<NAME>_BUG.md를 작성하고,references/BUG_TEMPLATE.md의 템플릿을 따릅니다(한 줄 요약, 예상 vs 관찰, ID를 포함한 재현, 주요 가설, 배제할 대안, 확인할 위치, 결과에 미치는 영향). - 영향받은 결과 격리 — 수정 전에 실행된 모든 백테스트/연구를 의심/무효로 표시하십시오. 수정 후 다시 실행하십시오. 버그가 레버리지를 부풀렸다면, 수익률과 인출액 모두 부풀려진 것이며, 접촉한 모든 스윕 유전자는 차별화되지 않을 수 있습니다 — 모두 재검증하십시오.
- 대화에서 사람에게 눈에 띄게 알리십시오. 버그는 거래 결과와 동등한 에피소드의 산출물입니다 — 부끄러워서 우회할 것이 아닙니다.
버그가 아닌 경우 (정직한 신호 실패 — 기록하지 마십시오)
- 폴드가
NoEligibleCandidate를 반환 = 정직한 신호, 버그가 아닙니다. 검증 기준을 넓히고 인증 기준을 낮추지 마십시오. - 거래가 중단되었거나 아직 상장되지 않은 종목(예: 2022년 SNDK)이 부재하거나, 조작된 값 없이 거부 목록에 있는 경우 = 올바른 동작입니다. 엔진이 거래되지 않은 종목에 대해 가격/지표 값을 조작하는 것은 버그입니다(engine-sanity 참조).
- 단일 틱 조정 대상 = 실시간 전략은 일일 리밸런싱을 통해 나머지를 축적합니다 — 그렇게 말하고, 버그로 재진단하지 마십시오(deploy-gate 참조).
검증-추정금지 체크리스트
산출물에 엔진 동작에 대한 어떤 주장을 쓰기 전에, 다음 중 하나로 뒷받침하십시오: query_backtest_events / query_portfolio_events, conditionFieldAudit, 또는 최소 재현. "엔진이 아마..."는 증거가 아닙니다.