Communitygithub.com

austin-starks/Public-Portfolio-Challenge

NexusTrade에서 대체 데이터 맞춤 지표(Reddit/WSB 멘션, 의회 공개, 내부자 신고, 뉴스 흐름)를 구축하고 이를 인증된 북에 순위/기울기/필터 신호로 연결합니다.

Public-Portfolio-Challenge란 무엇인가요?

이 스킬은 대체 데이터(alt-data) 신호를 구축하여 주식 전략에 통합하는 방법을 설명합니다. 사용자는 Reddit/WSB 멘션, 의회 거래 공개, 내부자 신고(Form 4), 뉴스 흐름 등과 같은 대체 데이터 소스를 사용하여 맞춤 지표(CustomIndicator)를 만듭니다. 이 스킬은 'compute_session_start/exec'와 같은 컴퓨팅 세션 워크플로우를 선호하며, 'run_compute'는 단순 작업에만 사용합니다. 또한 데이터 포인트가 전략에서 순위(Rank) 입력으로 사용되기 위해 전체 유니버스(예: 21개 종목)에 걸쳐 충분히 '조밀(Dense)'해야 한다는 '희소 계열 규칙(sparse-series rule)'을 강조합니다. 모든 지표는 인증된 북에 연결되기 전에 포인트 수, 티커별 커버리지, 신선도, 미래 데이터 유출(lookahead) 안전성을 확인해야 합니다. 이 스킬은 여러 통합 형태(순위 혼합, 기울기, 진입 필터, 확인 오버레이)를 제공하며, 모멘텀과 대체 데이터를 결합한 S1 앵커 형태를 권장합니다. 마지막으로, 데이터 커버리지는 인증 기간을 제한하므로 커버리지 종료일을 하드 제약 조건으로 처리해야 한다고 설명합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/austin-starks/Public-Portfolio-Challenge/tree/HEAD/skills/alt-data-indicators

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

대체 데이터 맞춤 지표

대체 데이터는 신호 실험이지 구조 실험**이 아닙니다. 이는 순위/가중치/필터링 신호에만 영향을 미칠 수 있으며, 옵션 구조에는 절대 영향을 미치지 않습니다(옵션-구조-규칙 참조). 기존의 기준이 되는 북(bar)은 수준입니다. 대체 데이터는 동일한 OOS(Out-of-Sample) 게이트를 적용받는 인증된 북을 능가하거나 실질적으로 위험을 줄여야만 그 자리를 차지할 수 있습니다. "지표가 멋지다"는 결과가 아닙니다.

조정 가능한 컴퓨팅 세션으로 구축 (선호)

여러 단계의 데이터 구축에는 'compute_session_start' / 'compute_session_exec' → 'compute_session_promote_indicator' / 'compute_session_end'를 선호하세요. '/work'가 유지되고, 모든 단계를 관찰할 수 있으며, 전체 기록이 하나의 승격된 지표로 통합됩니다. 먼저 오래된 세션을 목록화하고 종료('compute_session_list')하세요. 장기 실행 작업 중에는 주기적으로 exec를 보내세요. 일회성 'run_compute'는 작고 단일 쿼리 작업에만 사용합니다. 기타 스택 도구: 'dataset_to_indicator', 'build_signal_indicator', 'create_indicator', 'list_custom_indicators', 'collect_web_data', 'discover_sources', 'enrich_source', 'ingest_content', 'probe_url', 'sec_edgar', 'get_compute_status', 'cancel_compute_job'.

모든 소스는 다음 단계를 거칩니다: 구축 → 포인트 수 + 커버리지 확인 → 미래 데이터 유출 감사 → 기본 소스와의 값 현장 확인 → 기록. 플랫폼 장애는 버그 프로토콜을 따릅니다. 한 소스에 대해 두 번의 뚜렷한 장애가 발생하면 해당 소스를 보류하고 진행하십시오. 하나의 고장난 파이프라인이 캠페인 전체를 지연시키지 않도록 하십시오.

확인되지 않은 지표는 절대 연결하지 마십시오 (교훈 #10/#11)

어떤 'CustomIndicator'를 전략에서 참조하기 전에, 'list_custom_indicators'와 소스 현장 확인을 통해 다음 네 가지를 모두 확인하십시오.

  1. 포인트 수 — 0포인트 잔해를 제거합니다.
  2. 티커별 커버리지가 전체 유니버스(샘플이 아닌 21개 이름 모두)에 걸쳐 있는지 확인합니다.
  3. 신선도 — 최대 날짜; 데이터가 오래된 신호는 실시간 북을 구동해서는 안 됩니다.
  4. 미래 데이터 유출 안전성 — 아래 참조.

희소 계열 규칙

순위/가중치 표현은 전체 유니버스에 걸쳐 조밀한 계열에서만 작동합니다. 희소하거나 부분적으로만 커버하는 계열(예: 한 정치인의 매수로 21개 중 약 1개 이름만 커버)은 기울기나 오버레이로만 사용할 수 있으며, 절대 순위 입력으로 사용할 수 없습니다. 그리고 그 위에 구축된 순위는 거래량이 ZERO가 됩니다(변질된 연결). 이 사실을 말하고 우선순위를 낮추십시오. 강제로 진행하지 마십시오.

미래 데이터 유출 안전성은 양보할 수 없습니다 (교훈 #11)

모든 대체 데이터 포인트는 정보가 공개된 날짜(제출/공개/게시일)에 기록되며, 거래/이벤트 날짜가 아닙니다. 의회 거래는 최대 약 45일의 STOCK Act 지연이 있습니다. 신호는 이 지연을 내장해야 합니다. 어떤 백테스트에서 사용하기 전에 지표별로 명시적으로 감사하십시오. 가능하면 독립적으로 생성된 두 번째 구축과 값을 교차 검증하십시오(WSB-카운트 계열이 이 방식으로 검증되었습니다. 두 독립적인 구축이 정확히 일치했습니다). 과거 게시물의 소급 스크래핑은 괜찮습니다. 소급 감정 모델 적용도 괜찮습니다(주의 사항으로 기록). 삭제 생존자 사용은 기록해야 할 주의 사항입니다.

데이터 커버리지가 인증 기간을 제한합니다

먼저 소스 레이크의 최대 월을 확인하고 신호의 커버리지 종료를 인증 기간과 배포 가능성에 대한 하드 제약 조건으로 취급하십시오. 워크-포워드 엔진은 폴드 캘린더를 표시기의 커버리지에 맞추어 자르므로, 인증 비교는 캘린더 정렬되어야 합니다. 변형의 잘린 캘린더에서 기본 제어를 실행하십시오(워크-포워드-OOS 참조).

통합 형태 (커버리지에 따라 선택)

#통합위치필요한 커버리지
S1순위에 혼합 — 대체 신호와 모멘텀 ROC를 'weightIndicator' / SelectTop 메트릭으로 결합순위넓음 (대부분 21개)
S2기울기 — 모멘텀 순위; 대체 데이터가 최근 신호가 있는 이름을 과소/과대 가중가중치부분 허용
S3진입 필터 — N일 이내 / X 이상의 대체 신호가 발생한 경우에만 이름 오픈조건부분 허용 (콜드 스타트 폭 감사 재확인!)
S4확인 오버레이 — 대체 신호가 기존 게이트(예: VIX)를 완화/강화조건모든

모멘텀은 기본으로 유지되고, 버즈는 기울기입니다. 주의만으로 구성된 순위는 크게 손실을 보았습니다. 모멘텀 위에 로그-감쇠된 주의 기울기가 승리했습니다. 입증된 S1 앵커 형태: 'weightIndicator = Multiply(ROC63, Plus(1, Log(base 10, Plus(1, IndicatorSimpleMovingAverage(21d, CustomIndicator)))))'. 그리드 축으로 가치 있는 변형: SMA 창(10/21/42), 기울기 강도(로그 vs 선형 캡).

통합은 수동으로 구축되며, 자동 스위핑되지 않습니다('CustomIndicator'는 스위핑 가능한 유형이 아닙니다). 'create_portfolio_variant'(딥 카피 베이스 + JSON-Pointer 패치, 먼저 'dry_run')를 통해 변형 그리드를 구축하고, 라벨은 수동 설정(호박색)하며, 각각을 하나의 12개월 $25,000 백테스트로 폴드에 비용을 들이기 전에 연기 테스트하십시오(거래량이 0 또는 거의 없으면 순위/필터가 해결되지 않는 것 → 수정 또는 폐기). (스위프-재최적화 참조).

소스 레시피

  • 'references/reddit-wsb-recipe.md' — 입증된 Reddit Arctic 레이크 멘션 카운트 파이프라인.
  • 'references/congressional-disclosures.md' — 하원 서기 PTR 파이프라인 (전 의회 집계).
  • 'references/other-sources.md' — 내부자 Form 4, 뉴스 흐름, 주의; 그리고 'sec_edgar' 범위.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

austin-starks/Public-Portfolio-Challenge

Measure a NexusTrade options book's TRUE participation at a fixed cold-start capital base, defeating the compounded-NAV breadth illusion. Use whenever a book's headline \"holds N/21 names\" needs validating, when a live book collapses to a single name (the OSCR trap), when checking whether a SelectTop / per-name-allocation / total-budget change degraded simultaneous participation, or when a certification needs a breadth gate. Uses audit_backtest_breadth at held-fixed $25k.

austin-starks/Public-Portfolio-Challenge

The \"loudly declare\" protocol for platform, engine, or data bugs during a NexusTrade certification campaign — bugs are a first-class deliverable, not something to route around. Use whenever a NexusTrade tool errors, hangs, or returns numbers that contradict the config; whenever you're tempted to write \"probably an engine quirk\"; or when a discovered bug invalidates prior backtests and results must be quarantined. Includes the bug hand-off doc template (see references/BUG_TEMPLATE.md).

austin-starks/Public-Portfolio-Challenge

The GATED deploy + cleanup flow for a NexusTrade live book — clone the finalist, preview a delta reconcile, stage UNAPPROVED orders, verify fills. Use ONLY after the human explicitly says \"deploy + clean up\" and names a finalist. Covers the clone-before-reconcile ordering, the single-tick reconcile expectation, stale-pending-order hygiene, the signal-freshness gate, and why you can never approve orders yourself. Nothing here runs during certification.

austin-starks/Public-Portfolio-Challenge

The mandatory pre-flight contract checks (Stage S0) that must pass before trusting NexusTrade's certification engine for any strategy work. Use at the start of a bakeoff or certification campaign to prove the walk-forward engine runs end-to-end, windows don't leak, fold winners persist, and the engine doesn't fabricate values for dead/not-yet-listed names. Each check has a STOP-and-report failure mode; these runs do NOT count toward any certification minimum.

austin-starks/Public-Portfolio-Challenge

The single-touch lockbox — a final anti-overfitting holdout run once, after design freeze, on a window held out from every fold, sweep, and search. Use when finalizing a bakeoff winner before deploy, setting up the A/B/C baselines as OOS bars, or running the S1.5 gate-coherence auto-relax. Covers why looking at the lockbox twice burns it, the lockbox pass conditions, and the three baselines. The lockbox is distinct from the walk-forward OOS folds.

austin-starks/Public-Portfolio-Challenge

The hard structural constraints for the Public Portfolio Challenge momentum-LEAP options book — the spread-shape rule, the take-profit convexity-cap footgun, the affordability ladder, and the known losers not to re-test. Use whenever building or auditing an options strategy structure, checking spread-shape compliance before a certification, choosing DTE/strike rungs, or deciding whether a proposed structure change is even allowed. A violation is an automatic certification FAIL.

austin-starks/Public-Portfolio-Challenge

Orchestrate an out-of-sample certification of a NexusTrade trading strategy or live book — the master discipline behind the Public Portfolio Challenge. Use whenever you must decide PASS/FAIL on whether a portfolio holds up out of sample before deploying real money, replaying the Episode 10 runbooks, or running a \"certify my book\" / \"prove it out of sample\" / \"re-certify the fix\" task with the NexusTrade MCP connected. Pulls in walk-forward-oos, breadth-audit, sweep-reoptimization, options-structure-rules, bug-protocol, and deploy-gate.

austin-starks/Public-Portfolio-Challenge

The single entry point that executes a Public Portfolio Challenge episode or addendum runbook end-to-end, delegating each stage to the functional skills. Use when asked to run/execute/replay Episode 10, its bakeoff, or its addendum with the NexusTrade MCP connected. Reads the target runbook, pins its real artifacts (IDs, the incumbent bar), sequences the stages, and stops at the gated deploy. It orchestrates; the functional skills do the work.

austin-starks/Public-Portfolio-Challenge

Run a multi-family strategy bakeoff — the SEARCH→CERTIFY funnel that screens many candidate mechanisms down to a certified deploy winner without letting the cheap search layer issue a verdict. Use when replaying the Episode 10 bakeoff, when exploring several distinct strategy families before certifying, when deciding whether \"no deployable winner\" is even a legal conclusion, or when building the per-family certification ledger. Enforces verdict-integrity: only certification can end a campaign.

austin-starks/Public-Portfolio-Challenge

Re-optimize a NexusTrade strategy with a walk-forward SWEEP and label parameter provenance — the discipline that prevents deploying inherited knobs. Use whenever a structural change (sizing, rung depth, universe membership, DTE family, adding a rank signal) forces a re-sweep, when authoring gene_intents from get_sweep_surface, when choosing sweep over GA for a deploy cert, or when selecting the cross-fold-robust winner instead of the per-fold argmax. Invoke with the NexusTrade MCP connected.

austin-starks/Public-Portfolio-Challenge

Run and read a NexusTrade walk-forward out-of-sample study — the certification engine behind the Public Portfolio Challenge. Use when certifying a fixed portfolio (backtest_only) or re-optimizing one (sweep), when setting fold_count / anchored / validation / embargo params, when monitoring a run_walk_forward_study to completion, when reading per-fold OOS returns/Sortino/drawdown, or when a variant's fold calendar needs calendar-alignment against a base control. Invoke with the NexusTrade MCP connected.

관련 스킬