Communitygithub.com

austin-starks/Public-Portfolio-Challenge

パブリックポートフォリオチャレンジのエピソードまたはアドエンダムの実行計画をエンドツーエンドで実行する単一エントリポイント。各ステージを機能スキルに委譲します。

Public-Portfolio-Challenge とは?

このスキルは、Public Portfolio Challenge(公開ポートフォリオチャレンジ)におけるエピソードやアドエンダムの実行計画をオーケストレーションするためのエントリポイントです。ユーザーが「Episode 10を実行して」「ベイクオフを再現して」などと依頼した際に、対応する実行計画(RUNBOOK)を読み込み、その計画に定義された実際のアーティファクト(銘柄ID、インカンベント基準など)を固定し、各ステージを順番に実行します。各ステージの具体的な処理は、エンジン健全性チェック、ロックボックス保持、戦略ベイクオフ、デプロイゲートといった専用の機能スキルに委譲されます。このスキル自体は処理を再実装せず、順序付けと委譲のみを行います。また、すべてのエピソードに共通するブックエンドルール(最初にフィールド検証、最後にゲート付きデプロイ)を厳守し、バグが発生した場合は即座に隔離・報告します。Claude Code、Cursor、CodexなどのAIエージェント環境で動作し、NexusTrade MCPと連携して実際のポートフォリオに対して操作を行います。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

エピソードの実行

Public Portfolio Challenge のオーケストレーターエントリポイントです。各エピソードは特定の実アーティファクトに対する特定のジョブですが、規律は共通であり、機能スキルに実装されています。このスキルは適切な実行計画を選択し、そのアーティファクトを固定し、ステージを順番に実行し、各ステージを所有するスキルに委譲します。規律を再実装するのではなく、順序付けを行います。

呼び出し

/run-episode <エピソード>[ <試行>]

例: /run-episode 10 · /run-episode 10 addendum · "episode-10 のベイクオフを実行して"。

最初に: 実際の実行計画を読み込む(これが今回の実行における真実の情報源です)

対象の実行計画を読み込み、ジョブとアーティファクトに関する権威ある情報源として扱います(このスキルは順序付けと委譲のみをエンコードしています):

エピソード実行計画形状
10episode-10/BAKEOFF_RUNBOOK.mdマルチファミリーベイクオフ(検索→認定→ロックボックス→デプロイ)
10 / addendumepisode-10/addendum/RUNBOOK.mdエントリーとエグジットの再設計、売り行動を証明し、インカンベントの優位性を維持

実行計画から、何をするよりも先に固定するもの: SUBJECT(ライブブック/ビルド)のID、インカンベント基準(認定スタディID + フォルダごとの数値)、固定されたユニバース+資本、および引き継がれたアーティファクト。実行計画自体のステージリストが、以下の汎用的な順序と異なる場合は、実行計画が優先されます。

ブックエンドルール(すべてのエピソードに固定)

  • ステージAを最初に — SUBJECTをFIELDによって確認し(get_portfolio → conditionFieldAudit)、インカンベント基準を再検証し、1つの新しいバックテストをスポットチェックし、(ライブの場合は)保留中の注文と automaticOrderApproval を確認します。1段落の前の状態を提供します。
  • デプロイは最後に、かつゲート付きで — 人間がエピソードの明示的な実行フレーズ(「デプロイしてクリーンアップ」)を言うまで、クローン、調整、注文は行いません。デプロイゲートを参照してください。
  • バグはすべてのステージで成果物 — 障害が発生した場合はバグプロトコルを適用し、汚染された結果は隔離します。
  • 主張するのではなく検証する — エンジンの動作に関する主張はすべて、ログに記録される前にイベント/フィールド/再現(ポートフォリオ認定の第一原理による)に対してチェックされます。

エピソード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. ステージA ベースライン+インベントリ(上記のブックエンドルール)。
  2. エントリー+エグジットの再設計: 現在のエンジンオーサリング/スイープインベントリ → マッチングされたエントリー/エグジットメカニズムファミリー → イベントレベルのエグジットバインディング監査 → プロモートされた設計に対する sweep-reoptimization → 新しいコントロールとの固定設定 walk-forward-oos。
  3. options-structure-rules ハードゲート + 各ファイナリストに対する breadth-audit ゲート。
  4. 提示して停止 — 上部に判定、フォルダごとのOOSテーブル、インカンベントとの比較、出典ラベル、正直な注意点、バグ台帳。デプロイはしません。
  5. deploy-gate — 明示的なゴー指示で、指定されたファイナリストのみに対してゲート付き。

このスキルが保証すること

  • ブックエンドは決してスキップされない(最初にステージAのフィールド検証、最後にゲート付きデプロイ)。
  • 各ステージはそのチェックを所有するスキルを通じて実行されるため、判定は全体的なOOS、幅は固定の$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.

関連スキル