Communitygithub.com

Episódio de Portfólio Público

Ponto de entrada único que executa de ponta a ponta um episódio ou anexo do Public Portfolio Challenge, delegando cada etapa às habilidades funcionais. Use quando solicitado a executar/reproduzir o Episódio 10, sua competição ou seu anexo com o MCP NexusTrade conectado.

O que é Episódio de Portfólio Público?

Esta habilidade é o orquestrador central para o Public Portfolio Challenge, garantindo que cada episódio seja executado de forma disciplinada e verificada. Ela lê o runbook específico do episódio, fixa os artefatos reais (IDs, barra incumbente) e sequencia as etapas na ordem correta, delegando cada uma à habilidade funcional apropriada. O objetivo é evitar a reimplementação da lógica de verificação, focando apenas na coordenação e na aplicação de regras fixas, como a verificação de campo obrigatória antes de qualquer ação e a implantação apenas após confirmação humana explícita. A habilidade suporta plataformas como Claude Code e Cursor, e utiliza o MCP NexusTrade para acessar portfólios e dados ao vivo. Ela garante que bugs sejam documentados, resultados nulos são válidos e que nenhuma etapa seja pulada, resultando em um veredito holístico e rastreável.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Executar Episódio

O ponto de entrada orquestrador para o Public Portfolio Challenge. Cada episódio é um trabalho específico sobre artefatos reais específicos, mas a disciplina é a mesma e reside nas habilidades funcionais. Esta habilidade seleciona o runbook correto, fixa seus artefatos e executa as etapas em ordem, delegando cada uma à habilidade responsável. Ela não reimplementa a disciplina — ela a sequencia.

Invocação

/run-episode <episódio>[ <tentativa>]

Exemplos: /run-episode 10 · /run-episode 10 addendum · "execute a competição do episódio 10".

Primeiro: carregue o runbook real (ele é a fonte da verdade para ESTA execução)

Leia o runbook alvo e trate-o como autoritativo para o trabalho + artefatos (esta habilidade codifica apenas a ordenação e delegação):

EpisódioRunbookForma
10episode-10/BAKEOFF_RUNBOOK.mdCompetição multi-família (busca→certificação→cofre→implantação)
10 / addendumepisode-10/addendum/RUNBOOK.mdRedesenho de entradas + saídas, prova do comportamento de venda e retenção da vantagem incumbente

Do runbook, fixe antes de fazer qualquer coisa: os IDs do SUJEITO (livro vivo / construção), a barra incumbente (id do estudo de certificação + números por dobra), o universo fixo + capital e quaisquer artefatos transportados. A própria lista de Etapas do runbook vence se discordar da ordenação genérica abaixo.

As regras de contorno (fixas para todo episódio)

  • Etapa A primeiro — confirme o SUJEITO por CAMPO (get_portfolio → conditionFieldAudit), re-verifique a barra incumbente, verifique um backtest recente e (se ao vivo) verifique ordens pendentes + automaticOrderApproval. Entregue um parágrafo de estado antes.
  • Implantação por último, e BLOQUEADA — sem clone, reconciliação ou ordens até que o humano diga a frase explícita de avanço do episódio ("implantar + limpar"). Veja portão-de-implantação.
  • Bugs são uma entrega em cada etapa — protocolo-de-bug em qualquer falha; quarentene resultados contaminados.
  • Verifique, não suponha — toda alegação de comportamento do motor verificada contra eventos/campos/reprodução (através dos primeiros princípios da certificação-de-portfólio) antes de entrar no log.

Episódio 10 — a sequência da competição

Delega, em ordem:

  1. sanidade-do-motor — verificações de contrato S0. PARE em qualquer falha. (Estas não contam para o corpo de certificação.)
  2. cofre-de-contenção — carregue baselines A/B/C como barras OOS (S1); execute o auto-relaxamento de coerência de portão S1.5.
  3. competição-de-estratégia — o funil BUSCA→CERTIFICAÇÃO: ≥3 famílias, livro-razão por família, integridade-do-veredito. Cada semente promovida é certificada através de walk-forward-oos + auditoria-de-abrangência, sujeita a regras-de-estrutura-de-opções (portões rígidos) e re-otimização-varredura (re-varredura a partir de uma semente limpa).
  4. cofre-de-contenção — a confirmação de cofre de toque único no finalista congelado (S2).
  5. portão-de-implantação — BLOQUEADA. Descubra o alvo vivo via fetch_portfolios, confirme com o proprietário, clone, verifique campo, religue o monitoramento.

Anexo do Episódio 10 — redesenho de entrada e saída

O anexo segue a mesma espinha de certificação com um meio redesenhado:

  1. Etapa A linha de base + inventário (regra de contorno acima).
  2. Redesenho de entrada + saída: inventário de autorias/varreduras do motor atual → famílias de mecanismos de entrada/saída combinadas → auditoria de vínculo de saída em nível de evento → re-otimização-varredura no design promovido → walk-forward-oos de configuração fixa vs um controle fresco.
  3. Regras-de-estrutura-de-opções portão rígido + portão de auditoria-de-abrangência em cada finalista.
  4. Apresente, então pare — veredito no topo, tabela OOS por dobra, lado a lado vs incumbente, rótulos de proveniência, ressalvas honestas, registro de bugs. Sem implantação.
  5. portão-de-implantação — BLOQUEADA no avanço explícito, apenas para o finalista nomeado.

O que esta habilidade garante

  • Os contornos nunca são pulados (verificação de campo da Etapa-A primeiro; implantação bloqueada por último).
  • Cada etapa é executada pela habilidade que possui suas verificações, então o veredito é holístico OOS, a abrangência está em $25k fixos, mudanças estruturais forçam uma re-varredura, e cada parâmetro carrega proveniência.
  • Um resultado nulo é um resultado válido — o orquestrador não tortura variantes para fabricar uma vitória.

Se o runbook alvo adicionar, renomear ou reordenar etapas, siga o runbook — esta habilidade é a espinha padrão, não uma sobreposição.

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.

Habilidades Relacionadas