Communitygithub.com

austin-starks/Public-Portfolio-Challenge

Point d'entrée unique qui exécute de bout en bout un épisode ou un addendum du Public Portfolio Challenge, en déléguant chaque étape aux compétences fonctionnelles. À utiliser lorsqu'on vous demande de lancer/exécuter/rejouer l'épisode 10, son bakeoff ou son addendum avec le MCP NexusTrade connecté. Lit le runbook cible, épingle ses artefacts réels (IDs, barre de l'incumbent), séquence les étapes et s'arrête au déploiement conditionnel. Il orchestre ; les compétences fonctionnelles font le travail.

Qu'est-ce que Public-Portfolio-Challenge ?

Cette compétence est l'orchestrateur central du Public Portfolio Challenge. Elle lit le runbook cible pour chaque épisode (par exemple, l'épisode 10 ou son addendum), épingle les identifiants des artefacts réels (comme le sujet, la barre de l'incumbent, l'univers fixe, etc.) et exécute les étapes dans l'ordre, en déléguant chaque étape à la compétence fonctionnelle appropriée (engine-sanity, lockbox-holdout, strategy-bakeoff, deploy-gate). Elle garantit que les règles de bornage sont toujours respectées : vérification terrain du sujet en premier, déploiement conditionnel en dernier, et protocole de bugs actif à chaque étape. La compétence ne réimplémente pas la discipline ; elle la séquence. Si le runbook ajoute, renomme ou réordonne des étapes, l'orchestrateur suit le runbook, pas son squelette par défaut. Le résultat peut être nul si aucune variante ne gagne ; l'orchestrateur ne force pas de variations pour fabriquer une victoire.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Exécuter un épisode

Point d'entrée orchestrateur pour le Public Portfolio Challenge. Chaque épisode est un travail spécifique sur des artefacts réels spécifiques, mais la discipline est la même et réside dans les compétences fonctionnelles. Cette compétence sélectionne le bon runbook, épingle ses artefacts et exécute les étapes dans l'ordre, en déléguant chacune à la compétence qui la possède. Elle ne réimplémente pas la discipline — elle la séquence.

Invocation

/run-episode <episode>[ <tentative>]

Exemples : /run-episode 10 · /run-episode 10 addendum · "lance le bakeoff de l'épisode 10".

D'abord : charger le vrai runbook (c'est la source de vérité pour CETTE exécution)

Lisez le runbook cible et traitez-le comme faisant autorité pour le travail + les artefacts (cette compétence ne code que l'ordre et la délégation) :

ÉpisodeRunbookForme
10episode-10/BAKEOFF_RUNBOOK.mdBakeoff multi-famille (recherche→certification→coffre-fort→déploiement)
10 / addendumepisode-10/addendum/RUNBOOK.mdRefonte des entrées + sorties, prouver le comportement de vente et conserver l'avantage de l'incumbent

À partir du runbook, épinglez avant toute action : les identifiants du SUJET (livre en direct / build), la barre de l'incumbent (identifiant de l'étude de certification + chiffres par pli), l'univers fixe + capital, et tous les artefacts reportés. La propre liste d'étapes du runbook prévaut si elle diffère de l'ordre générique ci-dessous.

Les règles de bornage (fixes pour chaque épisode)

  • L'étape A en premier — confirmer le SUJET par TERRRAIN (get_portfolio → conditionFieldAudit), revérifier la barre de l'incumbent, vérifier ponctuellement un backtest frais, et (si en direct) vérifier les ordres en attente + automaticOrderApproval. Livrer un état avant d'un paragraphe.
  • Déploiement en dernier, et CONDITIONNEL — pas de clone, pas de réconciliation, pas d'ordres tant que l'humain n'a pas prononcé la phrase de go explicite de l'épisode ("déployer + nettoyer"). Voir deploy-gate.
  • Les bugs sont un livrable à chaque étape — protocole-bug en cas d'échec ; mettre en quarantaine les résultats contaminés.
  • Vérifier, ne pas affirmer — toute affirmation sur le comportement du moteur doit être vérifiée par rapport aux événements/champs/reproduction (via les premiers principes de portfolio-certification) avant d'atterrir dans le journal.

Épisode 10 — la séquence de bakeoff

Délégations, dans l'ordre :

  1. engine-sanity — Vérifications contractuelles S0. ARRÊT en cas d'échec. (Ceux-ci ne comptent pas dans le corps de certification.)
  2. lockbox-holdout — Charger les lignes de base A/B/C comme barres OOS (S1) ; exécuter le relâchement automatique de cohérence de la barrière S1.5.
  3. strategy-bakeoff — L'entonnoir RECHERCHE→CERTIFICATION : ≥3 familles, registre par famille, intégrité du verdict. Chaque graine promue est certifiée via walk-forward-oos + breadth-audit, soumise aux options-structure-rules (barrières dures) et à la sweep-reoptimization (re-balayage à partir d'une graine propre).
  4. lockbox-holdout — La confirmation à un seul contact du coffre-fort sur le finaliste figé (S2).
  5. deploy-gate — CONDITIONNEL. Découvrir la cible en direct via fetch_portfolios, confirmation du propriétaire, clone, vérification terrain, rattachement de la surveillance.

Addendum de l'épisode 10 — refonte des entrées et sorties

L'addendum suit la même colonne vertébrale de certification avec un milieu redessiné :

  1. Étape A ligne de base + inventaire (règle de bornage ci-dessus).
  2. Refonte des entrées + sorties : inventaire d'auteur/balayage du moteur actuel → familles de mécanismes d'entrée/sortie appariés → audit de liaison de sortie au niveau des événements → sweep-reoptimization sur le design promu → walk-forward-oos en configuration fixe par rapport à un contrôle frais.
  3. options-structure-rules barrière dure + breadth-audit barrière sur chaque finaliste.
  4. Présenter, puis s'arrêter — verdict en haut, tableau OOS par pli, côte à côte avec l'incumbent, étiquettes de provenance, réserves honnêtes, registre des bugs. Pas de déploiement.
  5. deploy-gate — CONDITIONNEL sur le go explicite, pour le seul finaliste nommé.

Ce que garantit cette compétence

  • Les bornes ne sont jamais sautées (vérification terrain de l'étape A en premier ; déploiement conditionnel en dernier).
  • Chaque étape est exécutée via la compétence qui possède ses vérifications, donc le verdict est holistique OOS, la largeur est à 25 000 $ fixes, les changements structurels forcent un re-balayage, et chaque paramètre porte une provenance.
  • Un résultat nul est un résultat valide — l'orchestrateur ne torture pas les variantes pour fabriquer une victoire.

Si le runbook cible ajoute, renomme ou réordonne des étapes, suivez le runbook — cette compétence est la colonne vertébrale par défaut, pas un remplacement.

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.

Skills associés