Before a large task, your Claude reads the code and offers three different ways to do it. For each you see which files change, what it costs you, the risks and what to watch for. You take one whole or combine parts, and your choice becomes the plan.
Step by step
Starts when your Claude rates a task as large, when you ask how best to do something, or on every task in Nexus's Options mode. In Plan mode only a large task gets it.
The message goes out as usual, with private details removed.
When you ask how best to do something (or in Options mode), Nexus sends Metis's instructions and the options form instead of a plan. For a large task your Claude asks for them itself, with the app's script, after the task card.
Helper agents read the code in parallel and change nothing: where the code lives, what depends on it, which tests cover it.
Three ideas from different angles, e.g. simplest, most robust, boldest. Each lists the files it changes, its cost, risks and how likely they are, advice and size. Then: what combines, shared risks, Metis's pick.
The app takes the draft out of the answer itself — no second retelling for a script — saves it in the app's folder and shows it on the app's Metis page. For the draft the server gets only counts. The end-of-turn check gets what it gets on any turn: the cleaned opening and closing of the answer, the whole cleaned answer only when your message listed several requests to check, and nothing at all for a simple hand-off.
Choose axis by axis — each axis is one trade-off, like “one module or two”. Take one option whole or parts of several. The choice, with its risks and advice, goes into the plan.
Templates
Your Claude fills in this form; the server sends it with the instructions. It is the same file your Claude gets.
Each option has its own risks and advice, so you can compare them, combine parts and carry them into the plan.
▍Metis · Options — <the task in one line> - Read: <files and places the scouting looked at — the options rest on them> Axes of choice - <axis 1>: <pole> — cost: <what we pay> | <pole> — cost: <what we pay> - <axis 2>: … Option A · <name> · angle "<lens>" - Idea: <a sentence or two, in this project's own material> - How: <file — place — what changes>; … - Sacrifice: <what this option pays> - Risks: <risk> — likelihood: low | medium | high — <how to reduce it> - Recommendations: <what to do if we take this option> - Size: <~N files, ~M steps> - On the axes: <axis — pole>; … Option B · … Option C · … Summary - Comparison: <the options along the axes — short, as a table or lines> - Can be combined: <what from A fits with B and what does not — and why> - Common risks: <risks whichever option is taken> - Common recommendations: <what to do whichever option is taken> - Metis advises: <an option or a combination — why> - Question: for each axis — which pole do we take? Take an option whole, or assemble one from parts.
Your data
Metis is a set of instructions, not an AI on the server. Your Claude Code follows them in your session, beside your files.
Rules
Options build on the code that was read. They name real files and places, not just ideas.
Three ideas that truly differ, and 3–4 axes. Each side of an axis says what you pay for it.
Metis says which parts of different options fit together.
Your Claude asks separately before recording the decision in design.md.
How to use
They show the difference between options faster than the ideas do.
“Take A, with the tests from B” is a fine answer; Metis says what fits.
Don't want to pick each time? Switch to “Metis chooses” on the app's Metis page: Claude takes Metis's advice and says which in one line; a large plan still waits for your “yes”.
Switch Nexus to Options mode. In Auto mode, asking “how should I best…” or “give me options” works too, unless the message also tells it to fix or add something. This works in English and Russian.
Scouting and options depend on your Claude following the instructions. If files were edited before Metis ran, the end-of-turn check notes it as skipped but does not send the turn back; the Nexus page counts the tasks where Metis was used.