Investor Context
Interview the user and prepare a confirmed investor-context change. The
persistent context is optional, belongs only to the current workspace, and
guides suitability without granting investment or execution authority.
This is an ordinary user-owned workspace file. Read and update it with native
workspace file tools; do not add an MCP service or hand routine changes to a
terminal command.
Procedure
- Read
.tradingcodex/user/investor-context.md when it exists. Treat a missing
file as unconfigured and do not search other files for replacement values.
- Ask only for missing or changed fields, in small batches. Keep confirmed
answers separate from
unknown, not provided, or declined values.
- Cover only the fields relevant to investment suitability:
- investment objective
- time horizon
- risk tolerance and loss capacity
- liquidity needs
- current holdings and concentration not already represented by canonical
portfolio state
- tax, account, or jurisdiction constraints
- Preview the exact proposed changes and obtain user confirmation before the
first write or before replacing or removing a confirmed value.
- After confirmation, create or update only
.tradingcodex/user/investor-context.md with native apply_patch. Preserve
unchanged confirmed fields and notes. Pass that exact workspace-relative
path to apply_patch; never prefix the workspace path or use an absolute
path. Set updated_at to the current ISO-8601 time and updated_by to
user.
- For
enable or disable, change only enabled_by_default after an explicit
request. For clear, warn that the action removes all saved fields and notes,
require an explicit request naming clear, and leave a valid empty context
document rather than deleting unrelated files.
- Re-read that exact workspace-relative file after a write and report its
configured fields, default application state, updated time, and path without
echoing unnecessary sensitive detail. A similarly suffixed file under a
duplicated workspace path is not valid verification. If the expected file
is missing or invalid, fix it before claiming success.
File Contract
Keep schema-versioned YAML frontmatter with schema_version: 1,
scope: workspace, enabled_by_default, updated_at, and updated_by. Store
confirmed suitability fields with these exact keys:
investment_objective
time_horizon
risk_tolerance_and_loss_capacity
liquidity_needs
current_holdings_and_concentrations
constraints
Use # Investor Context as the Markdown heading and put optional confirmed
notes below it. Omit unknown, declined, cleared, or empty fields instead of
inventing values. Do not edit generated run snapshots; begin_analysis_run
creates those from the saved file.
enable and disable control the workspace default. Native Codex workflows use
that default when begin_analysis_run seals applied context under the run.
The read-only viewer provides no one-run override and does not mutate the saved
default. After the run binding exists, do not claim that
chat wording changed it. Disabling context permits general research,
but personalized recommendation, portfolio fit, sizing, and order readiness
must remain limited or blocked when required suitability fields are unavailable.
Privacy And Safety
- Do not store broker credentials, account numbers, tax identifiers, API keys,
passwords, tokens, seed phrases, private keys, or raw secret material.
- Prefer high-level constraints or ranges over unnecessary personal financial
detail.
- Do not duplicate canonical cash, positions, orders, or broker account state
in the context file.
- Do not infer answers from browsing, portfolio performance, or prior agent
prose. Write only values the user confirms in the current interview or update.
- Do not use investor context to weaken evidence, role, policy, approval,
execution, or audit gates.
- Do not use shell commands, the workspace launcher, or MCP for routine
investor-context reads and writes.
- Do not pass the full file to specialist tasks. Apply only the compact fields
needed for the current workflow; execution receives no suitability narrative.
1---2name: tcx-investor-context3description: Interview the user to create, inspect, update, enable, disable, or clear workspace-local investor suitability context. Use when the user explicitly asks to manage the objective, horizon, loss capacity, liquidity needs, holdings or concentration, or tax, account, and jurisdiction constraints applied to future workflows.4---56# Investor Context78Interview the user and prepare a confirmed investor-context change. The9persistent context is optional, belongs only to the current workspace, and10guides suitability without granting investment or execution authority.1112This is an ordinary user-owned workspace file. Read and update it with native13workspace file tools; do not add an MCP service or hand routine changes to a14terminal command.1516## Procedure17181. Read `.tradingcodex/user/investor-context.md` when it exists. Treat a missing19 file as unconfigured and do not search other files for replacement values.202. Ask only for missing or changed fields, in small batches. Keep confirmed21 answers separate from `unknown`, `not provided`, or `declined` values.223. Cover only the fields relevant to investment suitability:23 - investment objective24 - time horizon25 - risk tolerance and loss capacity26 - liquidity needs27 - current holdings and concentration not already represented by canonical28 portfolio state29 - tax, account, or jurisdiction constraints304. Preview the exact proposed changes and obtain user confirmation before the31 first write or before replacing or removing a confirmed value.325. After confirmation, create or update only33 `.tradingcodex/user/investor-context.md` with native `apply_patch`. Preserve34 unchanged confirmed fields and notes. Pass that exact workspace-relative35 path to `apply_patch`; never prefix the workspace path or use an absolute36 path. Set `updated_at` to the current ISO-8601 time and `updated_by` to37 `user`.386. For `enable` or `disable`, change only `enabled_by_default` after an explicit39 request. For `clear`, warn that the action removes all saved fields and notes,40 require an explicit request naming `clear`, and leave a valid empty context41 document rather than deleting unrelated files.427. Re-read that exact workspace-relative file after a write and report its43 configured fields, default application state, updated time, and path without44 echoing unnecessary sensitive detail. A similarly suffixed file under a45 duplicated workspace path is not valid verification. If the expected file46 is missing or invalid, fix it before claiming success.4748## File Contract4950Keep schema-versioned YAML frontmatter with `schema_version: 1`,51`scope: workspace`, `enabled_by_default`, `updated_at`, and `updated_by`. Store52confirmed suitability fields with these exact keys:5354- `investment_objective`55- `time_horizon`56- `risk_tolerance_and_loss_capacity`57- `liquidity_needs`58- `current_holdings_and_concentrations`59- `constraints`6061Use `# Investor Context` as the Markdown heading and put optional confirmed62notes below it. Omit unknown, declined, cleared, or empty fields instead of63inventing values. Do not edit generated run snapshots; `begin_analysis_run`64creates those from the saved file.6566`enable` and `disable` control the workspace default. Native Codex workflows use67that default when `begin_analysis_run` seals applied context under the run.68The read-only viewer provides no one-run override and does not mutate the saved69default. After the run binding exists, do not claim that70chat wording changed it. Disabling context permits general research,71but personalized recommendation, portfolio fit, sizing, and order readiness72must remain limited or blocked when required suitability fields are unavailable.7374## Privacy And Safety7576- Do not store broker credentials, account numbers, tax identifiers, API keys,77 passwords, tokens, seed phrases, private keys, or raw secret material.78- Prefer high-level constraints or ranges over unnecessary personal financial79 detail.80- Do not duplicate canonical cash, positions, orders, or broker account state81 in the context file.82- Do not infer answers from browsing, portfolio performance, or prior agent83 prose. Write only values the user confirms in the current interview or update.84- Do not use investor context to weaken evidence, role, policy, approval,85 execution, or audit gates.86- Do not use shell commands, the workspace launcher, or MCP for routine87 investor-context reads and writes.88- Do not pass the full file to specialist tasks. Apply only the compact fields89 needed for the current workflow; execution receives no suitability narrative.