Communitygithub.com

austin-starks/Public-Portfolio-Challenge

Les contraintes structurelles strictes du carnet d'options momentum-LEAP du Public Portfolio Challenge : la règle de forme de spread, le piège de convexité du take-profit, l'échelle d'abordabilité et les perdants connus à ne pas retester. À utiliser lors de la construction ou de l'audit d'une structure de stratégie d'options, de la vérification de conformité de forme de spread avant une certification, du choix des échelons DTE/strike, ou pour décider si une modification de structure proposée est autorisée. Une violation entraîne un ÉCHEC de certification automatique.

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

Ce skill définit les règles structurelles strictes du carnet d'options momentum-LEAP utilisé dans le Public Portfolio Challenge. Il impose des contraintes dures, dont une violation entraîne un échec automatique de certification. Les règles principales incluent : l'obligation d'utiliser des calls longs pour les expositions longues (≥ 120 DTE) et des spreads débit/verticaux uniquement pour les échéances courtes (≤ 30 DTE). Le skill détaille également les pièges courants, comme le take-profit à seuils multiples qui réduit la convexité, l'échelle d'abordabilité structurelle pour éviter des coûts de contrat trop élevés, et les perdants connus (stop-loss, filtres de régime SPY, spreads longs, sleeves minces, rotation restreinte) à ne pas retester sans nouvelle justification. Utilisez ce skill lors de l'audit ou de la construction d'une stratégie d'options pour garantir la conformité structurelle. Il s'appuie sur la documentation SKILL.md.

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

Demander à votre IA préférée

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

Documentation

Règles de Structure des Options

La famille de structure des options est fixée par les preuves des épisodes — seul le signal (classement / pondération / filtrage) est normalement en jeu. Ce sont des contraintes dures ; une violation entraîne un ÉCHEC de certification automatique.

La règle de forme de spread (contrainte dure)

  • Exposition longue (≥ ~120 DTE) = UNIQUEMENT calls longs. Convexité non plafonnée, pas de jambe courte. Pas de spreads débit ou verticaux longs (par exemple, un vertical plafonné mars-2027 ATM/+3/+10/+20 est une violation et ne peut pas certifier).
  • Tout spread débit / vertical doit être de courte durée — expirant dans ≤ ~30 DTE. Mince y est acceptable.

Reconfirmez la conformité sur chaque finaliste en lisant les DTE/strikes des jambes depuis get_portfolio. Violation = ÉCHEC automatique, sans exception.

Les verticaux de courte durée sont des candidats, pas interdits

Un manchon mince précédent à +3 % de large, non plafonné, éligible à tous les noms ≤30 DTE a échoué la certification (saignement de thêta, frais de rotation, a fait s'effondrer le pli d'avril 2025). Cela a réfuté un point, pas la classe. Un spread débit de courte durée large, plafonné en part est une structure différente — laissez le sweep + la certification OOS l'arbitrer, mais instrumentez-le pour que le mode d'échec ne puisse pas se cacher : la largeur est un gène, la part du manchon est un gène plafonné, et il doit passer les mêmes portes OOS plus une barrière de frais de rotation (rapportez les frais par pli + la rotation + la part du manchon ; un manchon précédent a fait gonfler les frais à 1 500–8 900 $/pli contre ~100–600 $ pour l'incumbent et doit survivre le pli d'avril 2025).

La famille de structure fixée

Momentum-LEAP à calls longs uniquement : une échelle à 7 échelons deep-OTM (ATM / +10 / +20 / +35 / +50 / +75 / +100 % OTM, 365–730 DTE), TP +250 %, backfill d'abordabilité, SelectTop 21. Les données alternatives peuvent toucher le signal de classement, les filtres d'entrée, les inclinaisons par nom, ou une condition de superposition — jamais les échelons de la structure, la règle de forme de spread, ou l'univers.

Le piège de convexité du take-profit

Si plusieurs clôtures de take-profit "toujours" existent (par exemple, P/L ≥ 20 % / 50 % / 200 %), la plus basse s'applique en premier et plafonne effectivement chaque gagnant à environ +20 % — anéantissant la justification de convexité non plafonnée pour les calls directs. C'est la raison la plus probable d'un rendement inférieur à un carnet qui laisse courir les gagnants. Vérifiez l'échelle de sortie pour cela sur tout carnet en direct ; la config de déploiement utilise un seul TP élevé (par exemple +250 %) ou aucun.

L'échelle d'abordabilité (faisabilité structurelle)

Avec un démarrage à froid de 25 000 $, un carnet à template unique d'environ 1 000 $ par nom échoue structurellement. Les structures à risque minimum sur la queue chère (META / LLY / GS / TSM / ADI / AVGO) coûtent 1 300–2 400 $ par contrat.

  • Chaque ensemble de templates doit aboutir à un échelon que le nom le plus cher peut remplir — ne retirez jamais l'échelon le moins cher lors du balayage des structures.
  • Ordonnez les templates cher → pas cher pour que le moteur remplisse le premier échelon abordable.
  • Les structures bon marché comme mécanisme principal = chemin de mort ; l'échelle doit donner à chaque nom une unité abordable.
  • totalBudget ≥ K × perNameAllocation par niveau. Les budgets plafonnent le coût de base, pas la valeur de marché — vérifiez toujours sur le ruban avec audit_backtest_posture. Les budgets en dollars ne réduisent PAS le risque comme un dimensionnement en % de la VNI.

Voir breadth-audit pour mesurer si l'échelle participe effectivement à un budget fixe de 25 000 $.

Perdants connus sur ce carnet (ne pas retester sans nouvelle cause)

  • Stop-loss sur calls longs / carnets LEAP hold-to-expiry — whipsaw ; testé deux fois, a nui deux fois.
  • Portes de régime SPY > 200-SMA — passer à plat en 2022 → ne peut pas passer le plancher d'activité de certification ; un filtre de momentum à 200D-SMA a également été testé comme le PIRE.
  • Spreads verticaux longs — interdits par la règle de forme de spread.
  • Manchons de courte durée minces à part non plafonnée — échec de saignement de thêta (voir ci-dessus).
  • Rotation de classement étroite (top-K ≤ 5 avec cadence partagée) — gardez K > 5.

Note de cadence : DaysSinceLastRebalanceOptionOrder / DaysSinceOrder — null >= N est VRAI sur les carnets frais ; l'horloge de cadence est partagée entre les stratégies RebalanceOption.

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

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

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