Communitygithub.com

austin-starks/Public-Portfolio-Challenge

アウトオブサンプルでのNexusTrade取引戦略またはライブブックの認定を実行するためのオーケストレーター。実際の資金投入前にポートフォリオがサンプル外で有効かどうかをPASS/FAILで判断する際に使用します。

Public-Portfolio-Challenge とは?

Public Portfolio Challenge向けの総合スキルです。このスキルは、NexusTradeのツールを直接操作し、独立した検証者として機能します。ウォークフォワード・アウトオブサンプル(OOS)分析、ポートフォリオの幅広さ監査、スイープ再最適化、オプション構造ルール、バグプロトコル、デプロイゲートといった複数の下位スキルを統合し、包括的なPASS/FAIL判定を下します。単一の集計値ではなく、OOSのウォークフォワードフォールド全体を評価することで、戦略の真の一般化能力を検証します。このスキルは、Claude CodeやNexusTrade MCPが接続された環境で使用され、実際の資金を投入する前にポートフォリオの頑健性を確認するために不可欠です。

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

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

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

ドキュメント

ポートフォリオ認定

Public Portfolio Challengeのための統合スキル。あなたはオーケストレーター兼独立検証者です:決定論的なNexusTradeツールを直接実行し、数値はあなた自身のもの — あなたが疑う結果を出すエージェントは存在しません。認定は、アウトオブサンプルのウォークフォワードフォールドから読み取られた全体的なPASS/FAIL判定であり、単一の集計値ではありません。

第一原理(すべての実行で拘束力を持つ)

  1. OOSだけが重要です。 トレイン/バリデーションの数値を一般化の証拠として提示しないでください。素晴らしい全サイクルバックテストでも、トレイン→OOSで崩壊すればFAILです。
  2. 価値はデザインにあり、オプティマイザーにはありません。 スイープはデザインの近傍を確認する控えめなノブ設定ツールです。戦略デザインに注力し、スイープにはあまり期待しないでください。
  3. クロスフォールドに頑健な設定をデプロイし、フォールドごとのargmaxは決して使わないでください。 バリデーションスコアはノイズの多い代理指標であり、フォールドごとの勝者は高分散です。最大化最小OOSソルティノ比/頑健選択を使用してください。
  4. 表示名ではなく、フィールドレベルで検証してください。 conditionFieldAuditを使用し、インジケーターIDはカタログから正確にコピーしてください。名前ではなく、フィールドとポスチャでサブジェクトを確認してください。
  5. 検証し、主張しないでください。 エンジンの動作に関するすべての主張は、成果物に登場する前に、イベント、フィールド、または再現に対してチェックされます。「おそらくエンジンの癖」→ バグプロトコルを実行し、ごまかさないでください。
  6. 正直に報告されたnull結果は有効な結果です。 バリアントが「勝つ」まで拷問しないでください — それはフォールドごとのargmaxの罠の別の形です。引き分けやノイズレベルの差 → 現状維持を選んでください。
  7. 人間が明示的に「デプロイ + クリーンアップ」と言うまで、デプロイも注文も行わないでください(デプロイゲート)。

標準実行構造

すべての認定キャンペーンは同じ段階的な形状に従います。中間部分は適応可能ですが、両端は固定です。

  • ステージA — ベースライン + インベントリ。 フィールドでサブジェクトを確認し(get_portfolio)、現行の基準を再検証し、1つの新しいbacktest_portfolio + audit_backtest_postureをスポットチェックし、ブックがライブの場合は保留中の注文状態とautomaticOrderApprovalを確認します。ビフォー状態を1段落で提供します。ライブ動作が問題の場合、最初に具体的な数値で再現し(query_portfolio_events)、その後修正します。
  • ステージB/C — 構築 + 認定。 認定そのものを実行します。研究のメカニズムと必須のフォールドごとのチェックについてはウォークフォワードOOSを、固定$25kの参加についてはブレッドス監査を、ハードなスプレッド形状ゲートについてはオプション構造ルールを、構造変更により再スイープが必要な場合はスイープ再最適化を参照してください。
  • ステージD — 提示し、停止します。 意思決定可能なパッケージを提供します:判定は先頭に、1行で;フォールドごとのOOS表 + 集計;現行とのサイドバイサイド比較(トレードを明示);最終候補の平易な英語ルール + conditionFieldAudit + ビルドID;すべてのパラメーターに出自ラベル(swept-on-this-book / inherited-from <study-id> / hand-set — 継承はアンバー);正直な注意事項(凍結された宇宙での後知恵、オプションのフィルリアリズム、レバレッジ/脆弱性、最大ドローダウンは2025年4月の売り場、ベースラインの注意事項)。バグ台帳を含めてください。デプロイはしないでください。
  • ステージE — デプロイ(ゲートあり)。 明示的な「デプロイ + クリーンアップ」の後にのみ行います。デプロイゲートを参照してください。

全体的なPASSテスト(フォールドごとの緑ルールなし)

OOSフォールドの過半数が利益を上げており、OOSソルティノ比が正で適度に安定しており(おおよその下限〜0.5)、ドローダウンが実際に保有できる許容範囲内であり、デプロイがフォールド間で安定しており、トレイン→OOSの劣化が穏やかな場合にPASSと認定します。1つの弱いフォールド ≠ FAIL。持続的なOOS損失、ドローダウンの爆発、またはトレインのみの強さ = FAIL。ハード制約違反(スプレッド形状、ブレッドスの崩壊)は、利益に関係なく自動FAILです。

「現行より優れている」(バリアントキャンペーン)

ライブ/認定済みの基準に対してバリアントをテストする場合、「優れている」とは、同じフォールドで固定して保持され、OOSリターンをリスク悪化なしで改善する、または同程度のリターンでリスク(ソルティノ比/DD)を実質的に改善する、または弱い局面(ベアフォールド)を実証的に改善することを意味します。その際、ブレッドスが低下していないこと。 比較はカレンダーアラインメントされていなければなりません(バリアントのクリップされたカレンダーでベースコントロールを実行 — ウォークフォワードOOSを参照)。

セルフチェックトリガーワード

  • 「バックテストが証明している」 → OOSフォールドがなければそれは起こっていない。
  • 「勝者のノブを再利用」 / 「すでに認定済み」 → 構造は変わったか?はい → 認定前に再スイープ(スイープ再最適化)。
  • 「19/21銘柄」 / 「素晴らしいブレッドス」 → 固定$25kで測定する(ブレッドス監査);複利のブレッドスは幻想である。
  • 「インジケーターは予測的に見える」 → 目視ではなく認定する。
  • 「おそらくエンジンの癖」 → バグプロトコル:検証し、主張しない。

ソースランブック(この規律の実例)

  • episode-10/BAKEOFF_RUNBOOK.md — エンジン健全性チェック、16バリアントバークオフ、ウォークフォワード認定、ロックボックス。
  • episode-10/addendum/RUNBOOK.md — エントリーとエグジットの再設計、その後OOSで動作を証明。
  • episode-10/addendum/CAMPAIGN_LOG.md — 追補の全教訓とデプロイメント台帳。

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

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.

関連スキル