Institutional onboarding foundations

Institutional-grade recommendations begin with a consolidated book of record — every sleeve, custodian account, open lot, and cash balance the advisory layer can trust.

• Designate primary portfolio sleevesStructure books by mandate — Core Income, Growth Alpha, charitable remainder, taxable vs qualified — each tracked independently with lot-level cost basis.
• Import or reconcile every accountBroker CSV upload via /import-activity (Merrill, Fidelity, Schwab, and others) builds consolidated holdings with Avg cost vs Last for reconciliation.
• Establish IBKR Client Portal parityConnect IBKR for sealed-session readiness — consent plus entitled accounts surface positions, cash, and margin for live capital deployment paths.
• Verify consolidated holdingsConfirm cash balances, open positions, average costs, and day P&L in Portfolio → Edit Account before activating options overlays.

Covered calls, cash-secured puts, collars, and wheel workflows only align with your capital when the engine sees real positions — otherwise even xAI-orchestrated synthesis stays theoretical.

Your high-conviction universe seeds symbol-scoped discovery, IV/OI context, and the xOptions overlay engine — not a generic ticker list.

• Build the core opportunity setAdd all material holdings plus 10–20 conviction names — earnings catalysts, event-driven ideas, and liquidity-aware names your desk actually trades.
• Set price and desk alertsConfigure alerts on key levels so scheduled scanners and portfolio alerts surface opportunities when your posture allows action.
• Align rail context with xOptionsCompact watchlist and hot IV/OI rows feed xOptions Step 1 (Find Options) and xAI multi-agent workspace preload — one curated universe, every surface.

Conviction-weighted alpha capture starts here: the platform prioritizes what you care about, not what happens to be trending.

Explicit posture — conservative income, balanced theta, aggressive directional — seeds the entire xStrategyBuilder engine and StrategyJob scoring paths.

• Declare risk tolerance in xChatState conservative defined-risk income, balanced theta with mild delta, or aggressive directional/vol-selling — only where role and broker approvals permit.
• Anchor market outlook and horizonBullish, range-bound, bearish, event-driven, or vol-crush — plus time horizon, max notional per structure, preferred DTE bands, and tax or liquidity constraints.
• Sync options strategy preferencesMongo-backed strategy catalog (aligned with coreskills xPersonas) plus your chosen xChat persona anchor signals into OptionsStrategyEngine scoring.
• Confirm persona routingPreflight → slot collection → synthesize becomes surgical when workspace data and posture are complete — StrategyJob-class flows inherit your stated mandate.

Your stated posture becomes the guardrail layer: every recommendation inherits the same risk bucket your IC would expect on a Monday morning brief.

Custodian identity, import cadence, and live session health must match the broker of record — desk views and execution parity depend on it.

• Map external account identifiersUpdate ext account id and related desk fields so each portfolio account syncs to the correct custodian row across imports and linked snapshots.
• Refresh broker imports on cadenceRe-run broker CSV import when activity changes; use consolidated holdings and import previews to reconcile against the custodian export of record.
• Validate IBKR Client Portal sessionWhere IBKR is linked, refresh consent and sealed session if snapshots look stale — positions, cash, and margin must mirror Client Portal for live deployment.
• Reconcile before options activationIBKR-sealed execution parity is the bar for deploying overlays on entitled accounts — never trade against a book the platform has not verified.

Multi-custodian families cannot afford shadow positions; parity here is the difference between advisory confidence and reconciliation fire drills.

Activate the multi-agent advisory layer and options-overlay engine — conversation continuity, structure-heavy personas, and a full xOptions builder pass.

• Enable conversation continuityOpt in to xChat history when available — turns persist in Mongo xchat_logs with product-enforced rolling retention for session continuity across devices.
• Select structure-aware persona routingUse the options-strategy persona or hardcore strategy path for structure-heavy asks — RAG plus OptionsStrategyEngine scoring where configured.
• Complete one xOptions builder flowRun a full stepped builder on /xoptions — Step 1 bootstrap pulls portfolio and watchlist context and seeds later StrategyJob workflows.
• Brief the multi-agent layerxAI-orchestrated multi-agent synthesis performs best when portfolio, watchlist, posture, and persona are already aligned from steps 1–4.

This is where the workspace shifts from read-only intelligence to actionable, context-aware options overlay design.

Prove the stack end-to-end: trigger a scheduler tick or StrategyJob, then inspect outputs as you would a desk review before capital deployment.

• Trigger execution pathOperator manual scheduler tick (Admin → Tasks for global_admin; /workspace/tasks when configured) or start a StrategyJob from xChat with a portfolio-scoped scan prompt.
• Review strategy outputsInspect strategy cards, Apex payoff charts, Greeks, and risk/outlook tags — confirm they match your book and the posture stated in step 3.
• Iterate with audit trailAdmin audit trail (Admin → Audit) plus tenant xChat debug logging (Admin → Tenant workspace, when enabled) support refinement without guesswork.
• Sign off before deploymentTreat validation like an IC memo: if outputs disagree with custodian records or stated mandate, resolve parity before proceeding.

Validation converts configured infrastructure into trusted, deployable intelligence — the last gate before live options overlay.

With all foundations complete, the workspace delivers production-grade, xAI-augmented guidance grounded in your actual capital — not generic suggestions.

• Portfolio-grounded synthesisRecommendations respect verified consolidated holdings, accounts, and imports — lot-level integrity flows into every structure proposal.
• Risk-bucket alignmentConservative, balanced, or aggressive scoring paths mirror the posture you documented — no silent drift across sessions.
• Full stack engagementRAG-linked options coreskills plus OptionsStrategyEngine scoring, real-time Greeks exposure, and xOptions strategy builder operate as one institution-grade layer.
• Consolidated family-office viewMulti-sleeve visibility, IBKR execution parity where linked, and xAI multi-agent advisory — unified in a single audited workspace.

The moment generic suggestions end and your institutional workspace begins — every surface speaks the language of your book.