Runbook is a local, broker-neutral policy recorder and advisory workbench for financial agents.
- No brokerage credentials. Never put API keys, OAuth tokens, passwords, or card numbers in tool arguments, notes, env values meant for logs, or the ledger.
- No order execution. Runbook never places, routes, previews, or cancels broker orders. It has no
place_*orcancel_*tools. - Advisory only.
allowed: truemeans the submitted proposal passed the recorded charter checks. It does not mean an account-wide control prevented other actions. - Approvals are caller-asserted. An agent can claim
actor.type: "human". That is not authenticated human authority. Execution evidence always reportshumanAuthorityEstablished: falseandauthorizationEstablished: false. - Disconnected shadow pilot first. Do not configure or authenticate Robinhood Trading MCP (or any brokerage MCP) during the shadow pilot. A direct brokerage tool can bypass Runbook entirely.
- No composite safety score. Ledger validity, capsule integrity, registry admission, and pilot-doctor readiness are separate assurance axes. Do not invent a single green/red “agent is safe” grade.
- No Social automation. Robinhood Social is personal and manual; commercial use and automated access are permission-gated.
- Record experiments and risk charters
- Preflight trade proposals against deterministic local policy
- Record caller-asserted decisions and owner-controlled execution imports
- Verify a local hash-chained ledger
- Offline-verify proof capsules and analyze public capability/auth fixtures
| Axis | What a pass means | What it does not mean |
|---|---|---|
| Ledger verify | Local chain/idempotency intact relative to this file | External immutability, broker truth |
| Pilot doctor ready | Shadow declaration + local checks passed | System-wide broker disconnection |
| Capsule valid | Transport, digests, author signature verify | Author identity, skill, compliance, broker issuance |
| Registry admit/reject | Offline analysis of reviewed claims | Live inventory, trade authorization |
| Preflight allowed | Proposal matched charter inputs | Hard gateway over the broker |
Read runbook://docs/tool-contract and runbook://docs/assurance next. Prefer prompt runbook_shadow_pilot for day-1 workflow.