Communitygithub.com

austin-starks/Public-Portfolio-Challenge

다중 전략군 배틀오프를 실행합니다 — 저렴한 검색 계층이 판결을 내리지 못하게 하면서, 많은 후보 메커니즘을 검증된 배포 우승자로 걸러내는 SEARCH→CERTIFY 퍼널입니다. 에피소드 10 배틀오프 재현, 여러 전략군 탐색 후 인증, '배포 가능한 우승자 없음'을 합법적 결론으로 내릴 수 있는지 판단, 또는 전략군별 인증 원장 구축 시 사용합니다. 판결 무결성을 강제합니다: 오직 인증만이 캠페인을 종료할 수 있습니다.

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

이 스킬은 최소 작업량을 의무화하는 2계층 **SEARCH → CERTIFY** 퍼널을 구현합니다. 핵심 규칙은 **검색 계층에서 판결이 금지**되며, 오직 워크포워드 인증(walk-forward-oos)만이 캠페인을 종료할 수 있다는 것입니다. SEARCH 계층(저비용)은 아이디어를 죽이거나(KILL) 승격(PROMOTE)만 할 수 있으며, CERTIFY 계층(고비용)만이 PASS/FAIL 또는 '배포 가능한 우승자 없음'을 선언할 수 있어 판결 무결성을 보장합니다. Claude Code, Cursor, Codex 등 AI 에이전트 플랫폼에서 사용 가능하며, SKILL.md에 정의된 최소 3개의 서로 다른 메커니즘 전략군 인증과 각 전략군당 최대 3번의 인증 시도, 그리고 각 인증 시도마다 3개 이상의 gene_intents 축과 각 3개 이상의 값을 요구합니다. 이 스킬은 또한 판결 무결성 규칙을 강제하여, 인증 최적화 없이 '우승자 없음' 판결을 내리는 것을 무효화하며, 각 킬(KILL)마다 단일 실패 게이트와 인증 증거를 명시하도록 합니다.

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

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

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

문서

다중 전략군 배틀오프

최소 작업량을 의무화하는 2계층 SEARCH → CERTIFY 퍼널입니다. 핵심 규칙: 검색 계층에서 판결이 금지됩니다. 오직 워크포워드 인증(walk-forward-oos)만이 캠페인을 종료할 수 있습니다.

두 도구, 두 역할

  • SEARCH 계층 (저비용): backtest_portfolio, create_portfolio_variant, optimize_portfolio, systematic_sweep. 이 계층은 아이디어를 죽이거나(KILL) 승격(PROMOTE) 만 할 수 있습니다. 이 계층은 "순위가 매겨진 SEED 집합"을 출력하며 절대 판결을 내릴 수 없습니다.
  • CERTIFY 계층 (고비용): 승격된 SEED에 대한 워크포워드 스위프 인증입니다. 이 계층만이 PASS / FAIL 또는 "배포 가능한 우승자 없음"을 결론내릴 수 있습니다.

어떤 이웃이 죽었다고 선언되기 전에 배포 × 구조 × DTE × 델타 그리드에 대한 systematic_sweep은 검색 계층에서 필수입니다.

의무 최소 작업량

  • "우승자 없음" 판결 전에 ≥ 3개의 서로 다른 메커니즘 전략군 인증. 한 전략군의 세 가지 변형이 아닌, 진정으로 다른 메커니즘이어야 합니다. 전략군 메뉴(≥3개 선택): (a) 모멘텀 롱 콜/수직형; (b) 레짐 전환 롱/플랫; (c) 정의된 신용/숏 프리미엄 (횡보/하락장에서 수익); (d) 캘린더/대각선 시간 스프레드; (e) 보호형 칼라 또는 풋 스프레드 자금 조달 롱.
  • 전략군당 최대 3회 인증 시도 (정제된 gene_intents, 더 세밀한 그리드, 또는 더 넓은 검증으로 깨끗한 SEED에서 재스위프) 후 "소진"됩니다.
  • 현실적 총계: ~3–9회 스위프 인증, 기존 인증된 SEED 포함.
  • 각 스위프는 비사소적: ≥3개 gene_intents 축 × 각 ≥3개 값 (정확한 필드 매핑은 스위프 재최적화 참조). 1축 또는 2값 스위프는 자격이 없습니다.

전략군별 인증 원장 (필수)

실행 로그에 다음 표를 기록하세요. 원장 행이 없는 전략군은 탐색되지 않은 것입니다:

| 전략군 | Seed ID | get_sweep_surface ✓ | gene_intents 축 | Study ID | crossFoldRobustSelection 키 | 조립된 북 ID | 폴드별 OOS 게이트 결과 | PROMOTE / KILL (이유) |

SEED별 인증 루프

get_sweep_surface → run_walk_forward_study (먼저 preview_only) → aggregate.crossFoldRobustSelection 읽기 → 배포 형태 북 조립 → 조립된 객체 게이트 → 원장 행 기록. 인증 하한(certification:true): 참여율 ≥ 0.35, 고유 이름 ≥ 9, 검증 수익률 ≥ 0, 검증 Sortino ≥ 0.5.

판결 무결성 규칙 (캠페인의 핵심 규율)

  • 인증 최적화 제로 = 무효, "정직한 배포 불가"가 아님. 인증 최적화 없이 어떤 판결 — 특히 "배포 가능한 우승자 없음" / "구조적 실행불가" — 을 내리는 것은 캠페인을 무효화합니다. (이전 실행에서 제로 인증 최적화를 실행하고 실행불가를 선언했습니다.)
  • N개의 수동 구축 포인트로 실행불가 주장 불가 — systematic_sweep + ≥3개 전략군 작업량과 전략군당 단일 바인딩 게이트를 study-ID 증거와 함께 명시해야 합니다.
  • 자체 데이터에 하나의 반례가 있으면 포괄적 실행불가 주장이 금지됩니다 — 바인딩 제약 조건을 국소화하고 일반화하지 마세요.
  • 바인딩 제약 조건 귀속: 모든 킬은 단일 실패 게이트 + 인증 증거를 명명합니다. "일반적으로 성과가 저조함"은 킬 이유가 아닙니다.
  • 후보당 하나의 메커니즘 변경 — 킬/승격이 깔끔하게 귀속됩니다.
  • 해결책 일관성: 제안된 해결책은 죽은 후보의 측정된 상태와 모순되어서는 안 됩니다. (포지션 한도 아래에서 실패한 북에 "배포 증가"를 제안하지 마세요; 하락률에서 실패한 북에 "볼록성 추가"를 제안하지 마세요.)

감당 가능성 사다리 킬 경로와 알려진 손실에 대해서는 옵션-구조-규칙을, 기준선(A/B/C)과 최종 단일 터치 확인에 대해서는 lockbox-holdout을 참조하세요.

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

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.

관련 스킬