tradingcodex/guidebook/execution-boundary.html at main · monarchjuno/tradingcodex · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<!doctype html>
<html lang="en">
  <head><meta charset="utf-8" /><meta name="viewport" content="width=device-width, initial-scale=1" /><meta name="theme-color" content="#101010" /><meta name="description" content="Why TradingCodex keeps evidence gathering and broker actions on separate paths." /><title>Execution boundary | TradingCodex Docs</title><link rel="stylesheet" href="assets/site.css" /></head>
  <body>
    <a class="skip-link" href="#content">Skip to content</a><header class="global-header"><a class="wordmark" href="index.html" aria-label="TradingCodex documentation home"><span class="wordmark-mark" aria-hidden="true">T</span><span>TradingCodex</span><span class="wordmark-divider" aria-hidden="true">/</span><span class="wordmark-section">Docs</span></a><nav class="header-nav" aria-label="Documentation navigation"><a href="index.html" aria-current="page">Guide</a><a href="https://github.com/monarchjuno/tradingcodex/tree/main/docs">Reference</a><a href="https://github.com/monarchjuno/tradingcodex">GitHub</a></nav><span class="header-note">How it works</span></header>
    <div class="docs-shell">
      <aside class="sidebar" aria-label="Documentation sidebar">
  <details class="mobile-nav"><summary>Guide <span aria-hidden="true">⌄</span></summary><div class="mobile-nav-links"><a href="index.html">Quick start</a><a href="advanced.html">Advanced usage</a><a href="dynamic-workflow.html">Dynamic workflow</a><a href="harness.html">The harness</a><a href="data-sources.html">Data sources &amp; OpenBB</a><a href="decision-memory.html">Decision Memory</a><a href="reusable-context.html">Reusable context</a><a href="execution-boundary.html">Execution boundary</a><a href="provider-to-order.html">Provider to order</a><a href="skills.html">All user-facing skills</a><a href="research.html">Research</a><a href="order.html">Order</a><a href="improve.html">Improve</a><a href="customize.html">Customize</a><a href="help-status.html">Help &amp; status</a></div></details>
  <nav class="sidebar-nav"><p class="nav-label">Start here</p><a href="index.html">Quick start</a><a href="advanced.html">Advanced usage</a><p class="nav-label">How it works</p><a href="dynamic-workflow.html">Dynamic workflow</a><a href="harness.html">The harness</a><a href="data-sources.html">Data sources &amp; OpenBB</a><a href="decision-memory.html">Decision Memory</a><a href="reusable-context.html">Reusable context</a><a href="execution-boundary.html">Execution boundary</a><p class="nav-label">Order onboarding</p><a href="provider-to-order.html">Provider to order</a><p class="nav-label">Skills in detail</p><a href="skills.html">All user-facing skills</a><a href="research.html">Research</a><a href="order.html">Order</a><a href="improve.html">Improve</a><a href="customize.html">Customize</a><a href="help-status.html">Help &amp; status</a></nav>
</aside>
      <main id="content"><article class="doc-content">
        <div class="breadcrumbs"><a href="index.html">Docs</a><span aria-hidden="true">/</span><span>How it works</span></div><header class="doc-header"><p class="eyebrow">Core concept</p><h1>Evidence is not execution</h1><p>A strong research result is not a broker instruction. TradingCodex deliberately separates the analysis path from any final effect and keeps a single exact path for each sensitive action.</p></header>
        <section id="default"><h2>The default is analysis-only <a href="#default" aria-label="Link to The default is analysis-only">#</a></h2><p>Natural-language research, Decision Memory, a scheduled task, a Strategy, an Investment Brain, or a Build task do not create an order, approval, or broker action. Fixed-role subagents have no submit or cancel capability, and the browser viewer has no mutation route.</p><div class="guardrail"><strong>Explicit exclusions remain binding.</strong> “No order,” “No trading,” and similar limits apply to the dynamic workflow. Use the research path when you want evidence, alternatives, or a Decision Package without a final effect.</div><p>For the user journey from Paper or broker provider setup through ticket, approval, and final action, read <a href="provider-to-order.html">From provider to order</a>.</p></section>
        <section id="exact-actions"><h2>Three exact order entrypoints <a href="#exact-actions" aria-label="Link to Three exact order entrypoints">#</a></h2><p>There is no broad <code>tcx-order</code> skill. The root-native entrypoints are unavailable in Plan mode and subagents, and their complete prompt grammar is parsed before a model runs.</p><div class="table-wrap"><table><thead><tr><th>Entrypoint</th><th>Purpose</th><th>Immediate effect</th></tr></thead><tbody><tr><td><code>tcx-order-allow</code></td><td>Admit at most one later submit or cancel attempt in this root turn.</td><td>No; it creates a bounded one-use grant.</td></tr><tr><td><code>tcx-order-submit</code></td><td>Submit one already-approved order with the exact ticket and approval receipt ids.</td><td>One canonical submit attempt.</td></tr><tr><td><code>tcx-order-cancel</code></td><td>Cancel one known submitted broker order with exact identifiers.</td><td>One canonical cancel attempt.</td></tr></tbody></table></div></section>
        <section id="grant"><h2>Use the turn grant only when needed <a href="#grant" aria-label="Link to Use the turn grant only when needed">#</a></h2><p>Use <code>tcx-order-allow</code> only when the order identifiers are not known at the beginning of a normal workflow and you intentionally allow one possible final attempt after all research and approvals pass. Put its exact mode invocation on the first meaningful line; only the skill token may be replaced by a matching workspace skill link.</p><div class="example"><p>Exact first meaningful line</p><pre><code>$tcx-order-allow --mode paper
$tcx-workflow
Review the approved paper-order candidate. Submit at most one order only if every gate passes.</code></pre></div><p>The grant is bound to the workspace, session, turn, original complete prompt, permission mode, and order mode. It expires after one hour and is revoked on use, Stop, or the next user turn. It neither grants approval nor performs an immediate order.</p></section>
        <section id="gates"><h2>The service remains the final gate <a href="#gates" aria-label="Link to The service remains the final gate">#</a></h2><p>Even an exact request or current turn grant is only an admission path. The canonical service still checks policy, payload validation, restricted lists, matching approval receipts, idempotency, account scope, broker health, live confirmation, reconciliation, and audit.</p><p>Do not automatically retry a result that is uncertain or needs review. Status inspection and ordinary analysis can continue, but the effect path waits for a terminal canonical result.</p></section>
        <footer class="doc-footer"><a href="reusable-context.html"><span>Previous</span><strong>Reusable context</strong></a><a href="research.html"><span>Next</span><strong>Research skills</strong></a></footer>
      </article></main><aside class="on-this-page" aria-label="On this page"><p>On this page</p><nav><a class="active" href="#default">Default path</a><a href="#exact-actions">Exact actions</a><a href="#grant">Turn grant</a><a href="#gates">Service gates</a></nav></aside>
    </div>
  </body>
</html>