Click to copy
I am comfortable copy-pasting and following instructions, but I am not a developer.
There is nothing to install for this one and no commands to type: it all happens inside Claude. If any instruction below implies a Terminal, translate it into the equivalent click path for me instead.
- Plain English. Define jargon the first time it appears.
- One step at a time, then wait for me to confirm before the next one.
- Tell me what success looks like at each step, and diagnose any error before moving on.
Follow the instructions below with those rules applied.
If you can browse the web, open and read this page in full first, it has the complete guide and every prompt you will run (the vault is under the-vault anchor): https://consultance.ai/library/build-your-agent-desk#the-vault . If you cannot open links, tell me and I will paste the page in, do not guess the prompts.
I want to turn how I make one recurring decision into a small desk of specialist AI agents, each judging one thing on its own, with a coordinator that shows me every view and me making the final call. Walk me through it, one step at a time, the way someone from consultance.ai would sit next to me.
This is a HYBRID setup. Part one is a conversation in the Claude app, no install. Part two is a small build in Claude Code on my own machine, with Terminal commands. Tell me clearly which part we are in at every step so I never guess.
Your FIRST message asks me exactly one question: "Do you want to see ai-hedge-fund, an open source AI hedge fund, run on real stocks first (prompt 16, Claude Code), start the interview that captures your own method (Claude app, no install), or go straight to adding your own specialists to ai-hedge-fund (Claude Code)?" Wait for my answer. If I pick the working fund, walk me through prompt 16 one command at a time, then prompt 17.
Terms, defined once:
- Specialist agent: one AI agent with a narrow brief. It judges one factor of my decision and nothing else.
- Coordinator: the step that collects every specialist's view, shows them to me unchanged, and lists where they disagree. It recommends. It never decides.
- Decision log: a file with one line per decision, written before I know the outcome, so I can score my calls later.
- ai-hedge-fund: an open source Python project by Virat Singh (github.com/virattt/ai-hedge-fund, MIT licence). Each agent in it is one system prompt. It trades a simulated account only, never a real one.
- Mandate: ai-hedge-fund's YAML file that describes a desk: its strategies, agents, risk limits, capital and cadence.
- Claude Code: Anthropic's coding agent that runs in Terminal and can write files and run tests on my machine.
PART ONE, the Claude app (NOT a Terminal install). Walk me click by click:
1. Open claude.ai and sign in. My material goes only to my own Claude account, never to consultance.ai. For anything confidential use a Team or Enterprise plan, or turn off model training in my settings first. Confirm my plan before I upload anything.
2. Open Projects in the left sidebar and create a new project. Name it "Agent desk".
3. In the model picker, choose Claude Opus 5.5. Keep it for every prompt.
4. Open the vault on the page above. Copy prompt 01 into the Project chat and send it. It asks me setup questions, one at a time.
5. Then run prompt 02, the calibration run, before I share a single real decision. It must show six MATCH lines. If one says MISMATCH, stop and tell me what went wrong.
6. Then prompts 03 to 10 in order. They interview me on real past decisions and turn my answers into signed specs. Expect this to take a few sessions, not one.
PART TWO, Claude Code (a Terminal install). One command at a time. After each, tell me what success looks like and the common error.
1. Install Claude Code if I do not have it. The official install lines are:
macOS or Linux: curl -fsSL https://claude.ai/install.sh | bash
Windows (PowerShell): irm https://claude.ai/install.ps1 | iex
Success: typing claude in Terminal opens it.
2. I need two keys. An Anthropic API key from the Claude Console, Anthropic's developer dashboard. And a Financial Datasets key from financialdatasets.ai, which supplies the prices and company figures. Its pricing page lists paid options, the smallest a one time credit pack. Tell me this before I start, so I am not surprised.
3. To see the fund work (prompt 16), from the ai-hedge-fund README:
uv tool install aihf
aihf
If uv is missing, install it first with the line from uv's own docs:
macOS or Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell): powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
The first aihf run asks for my keys and saves them to ~/.hedge-fund/.env. Common error: "command not found: aihf" means the tool folder is not on my PATH; run uv tool update-shell, then open a new Terminal.
4. To add my own specialists (prompts 11 to 14), from the README's Development section:
git clone https://github.com/virattt/ai-hedge-fund.git
cd ai-hedge-fund
poetry install
poetry run pytest hedge_fund
The cd line is not optional: without it the next commands run in the wrong folder. The tests must pass before I change anything. Python 3.11 or newer is required. No poetry? Prompt 11 gives the uv lines that do the same job.
5. Prompts 12, 13 and 14 write the tests first, run my desk once on a held out case, and prove the guardrail can fail.
6. Want the history? Prompt 18 backtests the fund point in time with the README line aihf ~/.hedge-fund/mandates/example.yaml --tickers AAPL,MSFT --backtest, plus --model claude-opus-5-5 and --out backtest.json. Start with two tickers: every agent call uses my own key. Before I trust the result, it checks whether the window sits before the model's training cutoff.
FIRST SESSION DRILL, before trusting anything:
- Input: the sample inside prompt 02, not my data.
- Good output: six MATCH lines, a Brier score of 0.145 with the working shown, and a refusal to make a rule from the incident with no record from the day.
- Review check: if Claude made a rule from memory alone, the method is not safe yet. Do not go on.
Rules for you while you help me:
- Never tell me something is "not possible" when the page shows how. If you are unsure, read the ai-hedge-fund README at https://github.com/virattt/ai-hedge-fund.
- Never connect a real broker, and never give any agent a tool that can place an order, move money or edit my records.
- Never invent a setting, menu or command. If the page or the docs do not show it, say so.