Communitygithub.com

austin-starks/Public-Portfolio-Challenge

퍼블릭 포트폴리오 챌린지 에피소드 또는 애드엔덤 실행 전반을 오케스트레이션하는 단일 진입점입니다. 에피소드 10, 배이크오프, 또는 애드엔덤을 실행/재생할 때 사용하며, 각 단계를 기능 스킬에 위임합니다. 대상 실행 문서를 읽고 실제 아티팩트(ID, 기준 지표)를 고정한 후 단계를 순차적으로 실행하며, 배포 게이트에서 멈춥니다.

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

이 스킬은 Public Portfolio Challenge(공개 포트폴리오 챌린지)의 오케스트레이터 진입점입니다. 각 에피소드는 특정 실제 아티팩트에 대한 구체적인 작업이지만, 수행 절차(discipline)는 동일하며 기능 스킬들에 구현되어 있습니다. 이 스킬은 올바른 실행 문서(runbook)를 선택하고, 해당 아티팩트를 고정(pin)한 후, 각 단계를 소유 스킬에게 위임하여 순서대로 실행합니다. 절차를 재구현하지 않고 시퀀싱만 담당합니다. 지원 플랫폼: Claude Code, Cursor, Codex 등 AI 에이전트 환경. 주요 기능: 실행 문서 기반 단계 오케스트레이션, 배포 게이트(gated deploy) 통제, 버그 프로토콜 적용, 검증 기반(verify-don't-assert) 접근법. 에피소드 10의 Bakeoff(멀티 패밀리 전략 배틀)와 Addendum(진입/진출 재설계)을 지원하며, 각각 고유한 실행 문서와 단계 순서를 가집니다.

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

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

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

문서

Run Episode

Public Portfolio Challenge의 오케스트레이터 진입점입니다. 각 에피소드는 특정 실제 아티팩트에 대한 구체적인 작업이지만, 수행 절차는 동일하며 기능 스킬에 구현되어 있습니다. 이 스킬은 올바른 실행 문서를 선택하고, 해당 아티팩트를 고정(pin)한 후, 각 단계를 순서대로 실행하며 각 단계를 소유 스킬에게 위임합니다. 수행 절차를 재구현하지 않고 시퀀싱만 담당합니다.

호출 방법

/run-episode <에피소드>[ <시도>]

예시: /run-episode 10 · /run-episode 10 addendum · "에피소드-10 배이크오프 실행"

첫 번째: 실제 실행 문서 로드 (이번 실행의 진실 공급원)

대상 실행 문서를 읽고 작업 + 아티팩트에 대한 권위 있는 정보로 취급합니다 (이 스킬은 순서와 위임만 인코딩함):

에피소드실행 문서형태
10episode-10/BAKEOFF_RUNBOOK.md다중 패밀리 배이크오프 (검색→인증→록박스→배포)
10 / addendumepisode-10/addendum/RUNBOOK.md진입 + 진출 재설계, 매도 동작 증명 및 기준 우위 유지

실행 문서에서 무엇보다 먼저 고정(pin): SUBJECT (라이브 북/빌드) ID, 기준 지표 (인증 연구 ID + 폴드별 수치), 고정 유니버스 + 자본, 전달된 아티팩트. 실행 문서 자체의 단계 목록이 아래 일반 순서와 다르면 실행 문서를 따릅니다.

고정된 북엔드 규칙 (모든 에피소드에 적용)

  • Stage A가 먼저 — FIELD로 SUBJECT 확인 (get_portfolio → conditionFieldAudit), 기준 지표 재검증, 신선한 백테스트 한 번 스팟 체크, (라이브인 경우) 미결 주문 + automaticOrderApproval 확인. 한 문단의 이전 상태 전달.
  • 배포는 마지막, 게이트 적용 — 사람이 에피소드의 명시적 실행 문구("deploy + clean up")를 말하기 전까지 클론, 리컨사일, 주문 없음. deploy-gate 참조.
  • 버그는 모든 단계에서 전달 가능 — 모든 실패 시 bug-protocol 적용; 오염된 결과 격리.
  • 단언하지 말고 검증 — 모든 엔진 동작 주장은 이벤트/필드/재현을 통해 확인된 후에만 로그에 기록 ( portfolio-certification의 첫 원칙 사용).

에피소드 10 — 배이크오프 시퀀스

순서대로 위임:

  1. engine-sanity — S0 계약 검사. 실패 시 중단. (인증 본체에 포함되지 않음)
  2. lockbox-holdout — A/B/C 기준선을 OOS 막대로 로드 (S1); S1.5 게이트 일관성 자동 완화 실행.
  3. strategy-bakeoff — SEARCH→CERTIFY 깔때기: ≥3개 패밀리, 패밀리별 원장, 평결 무결성. 각 승격된 시드는 walk-forward-oos + breadth-audit을 통해 인증되며, options-structure-rules(하드 게이트) 및 sweep-reoptimization(클린 시드에서 재스위프)에 묶입니다.
  4. lockbox-holdout — 동결된 최종 후보자에 대한 단일 터치 록박스 확인 (S2).
  5. deploy-gate — 게이트 적용. fetch_portfolios를 통해 라이브 타겟 발견, 소유자 확인, 클론, 필드 검증, 모니터링 재연결.

에피소드 10 애드엔덤 — 진입 및 진출 재설계

애드엔덤은 재설계된 중간 부분과 동일한 인증 골격을 따릅니다:

  1. Stage A 기준선 + 인벤토리 (위 북엔드 규칙).
  2. 진입 + 진출 재설계: 현재 엔진 작성/스위프 인벤토리 → 일치된 진입/진출 메커니즘 패밀리 → 이벤트 수준 진출 바인딩 감사 → 승격된 설계에 대한 sweep-reoptimization → 신선한 컨트롤 대비 고정 구성 walk-forward-oos.
  3. 모든 최종 후보자에 대한 options-structure-rules 하드 게이트 + breadth-audit 게이트.
  4. 제시 후 중단 — 상단에 평결, 폴드별 OOS 테이블, 기준 대비 나란히 비교, 출처 레이블, 정직한 한계, 버그 장부. 배포 없음.
  5. deploy-gate — 명시적 실행 문구 시 게이트 적용, 지정된 최종 후보자만.

이 스킬이 보장하는 것

  • 북엔드는 절대 건너뛰지 않음 (Stage-A 필드 검증 먼저; 배포는 마지막에 게이트 적용).
  • 각 단계는 해당 검사를 소유한 스킬을 통해 실행되므로 평결은 전체 OOS이며, 폭(breadth)은 고정 $25k, 구조적 변경은 재스위프를 강제하며, 모든 파라미터는 출처를 가집니다.
  • 널(null) 결과도 유효한 결과 — 오케스트레이터는 승리를 강제하기 위해 변형을 조작하지 않습니다.

대상 실행 문서가 단계를 추가, 이름 변경, 또는 재정렬하는 경우 실행 문서를 따르십시오 — 이 스킬은 기본 골격일 뿐, 재정의가 아닙니다.

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

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.

관련 스킬