Communitygithub.com

오스틴-스타크/퍼블릭-포트폴리오-챌린지

단일 터치 락박스 — 설계 동결 후, 모든 폴드, 스윕, 검색에서 제외된 윈도우에서 단 한 번 실행되는 최종 과적합 방지 홀드아웃입니다. 베이크오프 우승자를 배포하기 전에 확정하거나, A/B/C 기준선을 OOS 기준으로 설정하거나, S1.5 게이트 일관성 자동 완화를 실행할 때 사용합니다. 락박스를 두 번 보면 무효화되는 이유, 락박스 통과 조건, 세 가지 기준선을 다룹니다. 락박스는 워크포워드 OOS 폴드와는 구별됩니다.

퍼블릭-포트폴리오-챌린지란 무엇인가요?

이 스킬은 금융 포트폴리오 전략 개발에서 최종 검증 단계를 관리하기 위해 설계된 단일 터치 락박스 및 기준선 시스템입니다. 설계 동결(Stage S2) 후, 모든 이전 폴드, 스윕, 검색에서 전혀 접근하지 않은 마지막 홀드아웃 윈도우(126일)에서 모델을 단 한 번 평가하여, 캘린더 피팅 선택 압력으로 인한 과적합을 방지합니다. 또한 Stage S1에서 세 가지 기준선(A: 지분 매수 후 보유, B: 단순 LEAP 래더, C: 동결된 기존 기준)을 로드하여 상대적 성과를 측정하며, S1.5에서는 '기준선 B 돌파'와 '55% 포지션 한도'가 동시에 충족 가능한지 자동으로 확인하고, 충족 불가능 시 예산을 조정합니다. Claude Code, Cursor 등 AI 에이전트와 함께 사용되며, 설계 루프의 마지막 단계에서 규율 있는 배포 결정을 지원합니다.

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

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

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

문서

단일 터치 락박스 및 기준선

락박스는 어떤 폴드, 스윕, 검색도 절대 건드리지 않는 최종 홀드아웃입니다 — 캘린더 피팅 선택 압력에 대한 최후의 방어선입니다. 이는 검색 중에 반복적으로 사용되는 워크포워드 OOS 폴드(워크포워드-oos)와 구별되며, 락박스는 정확히 한 번만 접근합니다.

락박스

  • 정의: 워크포워드 구간은 실행일 lockbox_width_days = 126(약 6개월) 이전에 끝납니다. 해당 최종 윈도우 (실행일 − 126d) → 실행일이 락박스입니다 — 모든 폴드, 모든 스윕, 모든 검색에서 제외됩니다.
  • 방법: 워크포워드 집계의 모든 게이트를 통과한 조립된 배포 형태 북만 락박스 위에서 정확히 한 번, 설계 동결 후(Stage S2) 실행됩니다.
  • 통과 조건(S0에서 동결, 결과 확인 후 절대 변경하지 않음):
    • 락박스 OOS 수익률 ≥ 최악의 단일 폴드 워크포워드 OOS 수익률;
    • 락박스 maxDD ≤ 55%;
    • 포지션 상태 양호(audit_backtest_posture, 네 가지 조건 모두);
    • 폭 ≥ 9개 적격 종목(audit_backtest_breadth — 폭-감사 참조).

단일 터치는 절대적입니다

락박스를 본 후 설계를 반복하면 락박스는 무효화됩니다 — 배포 전에 워크포워드 구간을 뒤로 이동하고 새 꼬리 부분을 홀드아웃하세요. 락박스 실패는 캘린더 피팅 선택 압력으로 간주되며 배포 불가를 의미합니다. 단, 락박스를 명시적으로 명명한 기록된 소유자 재정의가 있는 경우는 예외입니다.

세 가지 기준선(A/B/C)을 OOS 기준으로 사용 (Stage S1)

create_portfolio를 통해 커밋된 snapshots/*.json 파일에서 로드됩니다. 현재 엔진에서 A와 B를 점수화하고, C의 고정된 공개 수치를 복사하여 달성 목표로 삼습니다.

  • A — 지분 매수 후 보유 (전체 유니버스). 수익률 기준만, 절대 Sortino 기준이 아님 — A의 Sortino는 레버리지 롱 프리미엄 북이 따라잡을 수 없는 지수 랠리의 매끄러움을 반영합니다.
  • B — 단순 LEAP 래더 (표준 명세: 모든 종목, 순위/필터 없음, 14일 주기, 95% 예산 내에서 종목당 포트폴리오의 8%, 구조 = [Δ0.50 콜 → Δ0.55/0.25 → Δ0.55/0.40 → Δ0.50/0.42 수직] 중 첫 번째 감당 가능한 단계, 모두 180–365 DTE, DTE ≤ 45에서 단일 청산). 폭이 9/20 이상인 폴드에서만 Sortino 기준으로 사용.
  • C — 동결된 기존 기준 게시된 폴드별 OOS 수치와 함께 제공되며, 그대로 복사합니다(개선을 위해 재실행하지 않음).

S1.5 — 게이트 일관성 자동 완화 (결정론적, 소유자 왕복 없음)

설계 전에 '기준선 B 돌파'와 '≤55% 포지션 한도'가 동시에 충족 가능한지 확인합니다 — B는 약 95% 배치된 북이므로, 포지션 한도가 적용된 최종 후보가 B를 능가할 수 없습니다. 충족 불가능한 경우 기준선 B 자동 완화(AUTO-RELAX Baseline B): B의 totalBudget을 자체 중앙값 일일 배치 비율이 55%가 될 때까지 낮추고, S1 점수를 다시 계산한 후 원본과 포지션 조정된 B를 기록합니다. 이는 게이트 완화도 아니고 소유자 결정도 아닙니다 — 벤치마크만 비교 가능하게 만드는 것이며, 임계값은 동결된 상태로 유지됩니다.

Individual skills in this repo

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

austin-starks/Public-Portfolio-Challenge

Build alternative-data custom indicators on NexusTrade (Reddit/WSB mentions, congressional disclosures, insider filings, news-flow) and wire them into a certified book as a rank/tilt/filter signal. Use when adding alt-data to a strategy, building a CustomIndicator via compute sessions, auditing lookahead safety or per-ticker coverage, or deciding whether a data series is dense enough to drive a rank. Covers the compute-session workflow, the sparse-series rule, and source recipes (see references/). Invoke with the NexusTrade MCP connected.

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 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.

관련 스킬