Communitygithub.com

austin-starks/Public-Portfolio-Challenge

NexusTrade 인증 캠페인 중 플랫폼, 엔진 또는 데이터 버그를 위한 "공개 선언" 프로토콜입니다. 버그는 우회해야 할 것이 아니라 최우선 산출물입니다. NexusTrade 도구가 오류를 내거나, 멈추거나, 설정과 모순되는 숫자를 반환할 때마다 사용하세요. 또한 "아마 엔진 문제일 거야"라고 생각될 때나, 발견된 버그가 이전 백테스트를 무효화하여 결과를 격리해야 할 때도 사용합니다. 버그 인계 문서 템플릿(참고자료/BUG_TEMPLATE.md)이 포함되어 있습니다.

Public-Portfolio-Challenge란 무엇인가요?

이 스킬은 NexusTrade 인증 캠페인 중 발생하는 모든 종류의 버그(엔진, 데이터, 설정)에 대해 체계적으로 대응하고 문서화하는 프로토콜입니다. 'Loudly Declare' 원칙에 따라 어떤 오류도 숨기지 않고 즉시 기록하며, 특히 엔진 동작을 추측하여 설명하는 'confabulation'을 가장 위험한 실패 모드로 간주합니다. 5단계 절차(중단 및 특성 분석, 즉시 기록, 인계 문서 작성, 결과 격리, 인간에게 전달)를 통해 버그를 투명하게 관리하고, 결과의 신뢰성을 보장합니다. Claude Code, Cursor, Codex 등 모든 AI 에이전트 플랫폼에서 사용할 수 있으며, 검증된 증거 없이 엔진 동작을 주장하지 않도록 'verify-don't-assert' 체크리스트를 제공합니다. 이 프로토콜은 버그를 숨기지 않고 캠페인의 공동 산출물로 만들어 전체 시스템의 신뢰성을 높이는 데 핵심적입니다.

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

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

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

문서

버그 프로토콜 — "공개 선언"

컴퓨팅 + 엔진 스택은 새롭고 계속 변화합니다. 모든 실패에 이 프로토콜을 적용하세요. 캠페인을 계속 진행하기 위해 오류를 덮지 마십시오 — 삼킨 버그는 막힌 단계보다 더 나쁩니다. 엔진이 무언가를 한 이유를 지어내는(confabulation) 것이 최악의 실패 모드입니다. 캠페인의 최악의 순간들은 조정 이벤트, 가격 행동, 예산 행동에 대한 confabulation에서 비롯되었습니다. 추측하지 말고 검증하세요.

전례: totalBudget 초과 배포 버그(콜드 스타트 시 예산의 40%가 배포된 북이 NAV의 ~96%를 배포)가 정확히 이 방식으로 발견되었고 수주간의 결과를 무효화했습니다. 일반적인 교훈은 엔진 결함에 의해 영향을 받은 모든 결과를 격리하고, 동작이 수정된 후에만 다시 실행하라는 것입니다.

다섯 단계 (모든 실패에 적용)

  1. 중단하고 특성 파악 — 설정(내 잘못), 데이터(소스 측), 또는 엔진(NexusTrade) 중 무엇인가? 최소한으로 재현하십시오 — 문제를 보여주는 가장 작은 작업/백테스트.
  2. 즉시 기록 실행의 CAMPAIGN_LOG.md에 ⚠️ BUG/ISSUE 제목 아래: 증상, 재현 ID, 예상 vs 관찰, 현재 가설(가설이라고 표시), 차단하는 내용.
  3. 실제 엔진/데이터 버그라면 인계 문서 작성 실행 디렉토리에 <NAME>_BUG.md를 작성하고, references/BUG_TEMPLATE.md의 템플릿을 따릅니다(한 줄 요약, 예상 vs 관찰, ID를 포함한 재현, 주요 가설, 배제할 대안, 확인할 위치, 결과에 미치는 영향).
  4. 영향받은 결과 격리 — 수정 전에 실행된 모든 백테스트/연구를 의심/무효로 표시하십시오. 수정 후 다시 실행하십시오. 버그가 레버리지를 부풀렸다면, 수익률과 인출액 모두 부풀려진 것이며, 접촉한 모든 스윕 유전자는 차별화되지 않을 수 있습니다 — 모두 재검증하십시오.
  5. 대화에서 사람에게 눈에 띄게 알리십시오. 버그는 거래 결과와 동등한 에피소드의 산출물입니다 — 부끄러워서 우회할 것이 아닙니다.

버그가 아닌 경우 (정직한 신호 실패 — 기록하지 마십시오)

  • 폴드가 NoEligibleCandidate를 반환 = 정직한 신호, 버그가 아닙니다. 검증 기준을 넓히고 인증 기준을 낮추지 마십시오.
  • 거래가 중단되었거나 아직 상장되지 않은 종목(예: 2022년 SNDK)이 부재하거나, 조작된 값 없이 거부 목록에 있는 경우 = 올바른 동작입니다. 엔진이 거래되지 않은 종목에 대해 가격/지표 값을 조작하는 것은 버그입니다(engine-sanity 참조).
  • 단일 틱 조정 대상 = 실시간 전략은 일일 리밸런싱을 통해 나머지를 축적합니다 — 그렇게 말하고, 버그로 재진단하지 마십시오(deploy-gate 참조).

검증-추정금지 체크리스트

산출물에 엔진 동작에 대한 어떤 주장을 쓰기 전에, 다음 중 하나로 뒷받침하십시오: query_backtest_events / query_portfolio_events, conditionFieldAudit, 또는 최소 재현. "엔진이 아마..."는 증거가 아닙니다.

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

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.

관련 스킬