Communitygithub.com

공개 포트폴리오 배포 (GATED)

NexusTrade 라이브 북의 GATED 배포 + 정리 워크플로우입니다. 최종 후보를 복제하고, 델타 조정 내역을 미리 보고하며, 승인되지 않은 주문을 준비하고, 체결을 확인합니다. 사람이 명시적으로 "배포 + 정리"라고 말하고 최종 후보를 지정한 경우에만 사용합니다.

공개 포트폴리오 배포 (GATED)란 무엇인가요?

이 스킬은 NexusTrade 라이브 트레이딩 포트폴리오에 대한 통제된(GATED) 배포 및 정리 워크플로우를 구현합니다. 사용자가 명시적으로 '배포 + 정리' 명령을 내리고 특정 최종 후보를 지정한 경우에만 활성화됩니다. 주요 목표는 델타 거래를 통해 선택된 최종 후보의 전략을 라이브 북에 '오늘 신규 배포'하는 것이며, 중복되는 포지션은 그대로 유지합니다. 스킬은 최종 후보의 대체 데이터 시리즈가 최신 상태인지 확인하는 신호 신선도 게이트, 처리되지 않은 주문 확인, 5단계 실행 순서(복제 → 조정 미리보기 → 사용자 승인 → 주문 준비 → 체결 확인)를 포함합니다. 중요한 점은 모든 주문이 '승인되지 않음' 상태로 준비되며, 사용자가 NexusTrade UI를 통해 수동으로 승인해야 한다는 것입니다. 이 스킬은 인증 단계에서는 실행되지 않으며, 배포 및 정리 단계에서만 사용됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/austin-starks/Public-Portfolio-Challenge/tree/HEAD/skills/deploy-gate

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

배포 게이트 (E단계 — GATED)

사람이 명시적으로 "배포 + 정리"라고 말하고 특정 최종 후보를 지정할 때까지 아무것도 배포되지 않으며 주문도 체결되지 않습니다. 이 스킬은 그때만 실행됩니다. 목표: 델타 거래를 통해 라이브 포지션을 선택된 최종 후보를 오늘 신규 배포한 상태와 동일하게 만듭니다(중복되는 부분은 왕복 거래하지 않음).

사전 배포 게이트 (필수)

  1. 신호 신선도 게이트. 대체 데이터 시리즈가 현재 시점까지 유효한 갱신 경로로 확장되지 않은 최종 후보는 인증 결과와 관계없이 배포될 수 없습니다. 오래된 순위 시리즈는 죽은 북입니다.
  2. 먼저 처리되지 않은 주문을 확인. 라이브 북에 보류 중/Pending User Approval → Canceled 주문이 있는지 확인하세요. 이 주문들은 새로운 주문 준비를 차단합니다. 이를 표시하고 사용자가 UI에서 취소하도록 안내하세요. automaticOrderApproval 상태를 참고하세요(기본값: 배포 시에 변경하라는 지시가 없는 한 현재 상태 유지).

다섯 단계

  1. 먼저 최종 후보를 라이브 북에 복제 — clone_strategies_to_portfolio (source = 최종 후보, target = 라이브 북), 그런 다음 필드를 확인하여 복제를 검증합니다. 이것이 "배포"입니다. 이 단계에서 라이브 북의 전략을 설정하며, 다음 단계에서 이를 기준으로 조정합니다. reconcile_portfolio_to_strategy에는 strategy_source 인수가 없습니다 — 이는 라이브 북을 자체 전략과 조정하므로 복제가 먼저 이루어져야 합니다. 최종 후보가 이미 배포된 변경되지 않은 라이브 북과 동일하다면 복제가 필요하지 않습니다. 그렇게 말하세요.
  2. 조정 미리보기 — reconcile_portfolio_to_strategy({ portfolio_id: "<live>", mode: "delta" }). 미리보기 전용 — 주문을 체결하지 않습니다. target, current, orders(이미 create_orders 형식), 예상 비용, 실현 손익, 워시세일 플래그를 반환합니다. 단일 틱 대상을 예상하세요. 라이브 전략은 일일 리밸런싱을 통해 나머지를 축적합니다. 그렇게 말하고 버그로 오진하지 마세요.
  3. 사용자에게 미리보기를 보여주고 명시적 승인을 받습니다. 정합성 확인: 주문이 델타만 건드리는지(중복은 건드리지 않음), 비용이 합리적인지, target이 신규 배포인지, 그리고 참여도 수정의 경우 대상이 하나가 아닌 여러 이름에 걸쳐 있는지 확인합니다.
  4. 주문 준비 — create_orders({ portfolio_id: "<live>", orders: <2단계의 주문 배열> }). 승인되지 않은 상태로 준비됩니다. 이 도구는 브로커에 제출하지 않습니다. 사용자가 NexusTrade UI에서 수동으로 승인합니다 — 승인 도구가 없으며 직접 승인할 수 없습니다. 옵션은 LIMIT 주문으로 자동 준비됩니다.
  5. 체결 후 확인 — 조정 미리보기를 다시 실행합니다. 델타 orders 배열이 ~비어 있어야 합니다. 체결 내역, 남은 수량, 실현 손익, 워시세일 플래그, 결과 라이브 참여도(보유한 고유 종목 수)를 보고합니다.

규칙

  • 기본 mode: "delta"입니다. 사용자가 명시적으로 원가 기준 초기화를 요청하는 경우에만 "liquidate_all"을 사용합니다.
  • 특정 최종 후보에 대한 명시적인 승인 없이 이 작업을 실행하지 마십시오.
  • 실행 중에 이미 고정되지 않은 경우 fetch_portfolios를 통해 라이브 대상을 찾으십시오. 필드/상태로 확인하지 않은 라이브 포트폴리오 ID를 하드코딩하지 마십시오.
  • 마무리할 때 배포에 필요한 주간 모니터 에이전트를 다시 연결하십시오.

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 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

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.

관련 스킬