diff options
Diffstat (limited to 'plugins/math-proof/README.md')
| -rw-r--r-- | plugins/math-proof/README.md | 68 |
1 files changed, 45 insertions, 23 deletions
diff --git a/plugins/math-proof/README.md b/plugins/math-proof/README.md index 85107c4e..500926a3 100644 --- a/plugins/math-proof/README.md +++ b/plugins/math-proof/README.md @@ -2,7 +2,8 @@ Two Claude Code skills for hard, research-level mathematics problems. Each takes one problem stated in full, keeps everything it writes in a run folder, -switches web search off for its run, and ends with a self-contained `proof.md`. +switches Claude Code's web tools off for its run, and ends with a +self-contained `proof.md`. **`/math-proof:solo`**: Claude works the problem itself, in your session, as one long turn. It is instructed to write its plan and each intermediate result @@ -19,14 +20,17 @@ judge set, two more workers check that exact text line by line before the judge concludes; if the opening rounds do not get there, later rounds send more workers per round, most of them at the one step the proof still lacks. `proof.md` has a Status section saying plainly what is and is not proved. -Expect dozens of sub-agent runs; check `/usage` before starting. +Expect dozens of sub-agent runs, and well over a hundred if all fourteen rounds +run: check `/usage` before you start on a subscription, or cap the spend with +`--max-budget-usd` in the unattended form below on an API key.  -Either way `proof.md` is the model's own account, citations included: read -it. Full instructions: [skills/solo/SKILL.md](skills/solo/SKILL.md) and -[skills/siege/SKILL.md](skills/siege/SKILL.md); the sub-agents are -defined in [agents/](agents/). +Either way `proof.md` is the model's own account, and any result it cites from +the literature is quoted from memory: read it critically. Full instructions: +[skills/solo/SKILL.md](skills/solo/SKILL.md) and +[skills/siege/SKILL.md](skills/siege/SKILL.md); the sub-agents are defined in +[agents/](agents/). ## Install @@ -34,9 +38,13 @@ defined in [agents/](agents/). /plugin install math-proof@claude-plugins-official ``` -Needs Claude Code 2.1.280 or later, and `python3` for `siege`. Then -add, once, to the `"env"` section of `~/.claude/settings.json` (larger -responses; sub-agents in the foreground; a long timeout for stalled workers): +Needs Claude Code 2.1.280 or later and, for `siege`, Python 3.7 or later on +your PATH as `python3` or `python` (no extra packages). Then add this `"env"` +block once to `~/.claude/settings.json` (or to `.claude/settings.json` in the +directory you run from, to limit it to that directory). The three lines allow +long responses, keep sub-agents in the foreground by turning background tasks +off, and give a silent worker four hours before it is cut off; they affect every +session that reads the file, so remove them when you stop using the plugin. ```json { @@ -50,31 +58,45 @@ responses; sub-agents in the foreground; a long timeout for stalled workers): ## Use -In an empty working directory, one per problem: +In an empty working directory, one per problem and one run at a time: ``` claude --model claude-opus-5-5 --effort high > /math-proof:solo <the complete problem statement, or the path of a file holding it> ``` -or `/math-proof:siege <…>` likewise. Leave the session alone until it -says where `proof.md` is: `solo` writes under `./math-proof-solo/`, -`siege` under `./math-proof-run/`. To continue a run that stopped or -that you interrupted, give the same line again in the same directory. Options -go before the problem: `DIR=path` picks another run folder, and `siege` -takes settings such as `MAX_ROUNDS=8` (its SKILL.md lists -them); each sub-agent's thinking effort is the `effort:` line in its file in -[agents/](agents/). +or `/math-proof:siege <…>` likewise. `solo` writes under `./math-proof-solo/`, +`siege` under `./math-proof-run/`; the session says where `proof.md` is when it +finishes. In the default permission mode Claude Code asks you to approve file +writes and the `siege` judge's shell commands (short Python checks and file +copies), so stay within reach or use the unattended form below; other than +that, type nothing while it runs. While `siege` runs, `state.md` in the run +folder shows the current round, and if the judge proves its goal and goes +after a stronger one, the result already proved is copied to `result-so-far.md`. + +If a run stops (an error, a closed terminal, a usage limit, Ctrl-C), give the +same `/math-proof:…` line again in the same directory, not a free-form message: +that reloads the skill's instructions and permissions, and the run continues +from its folder with the settings it started with. -Unattended (likewise for `solo`): +Options go before the problem: `DIR=path` picks another run folder, and +`siege` takes settings such as `MAX_ROUNDS=8` (its SKILL.md lists them). To +change a sub-agent's thinking effort, copy its file from [agents/](agents/) +into `~/.claude/agents/`, leave its `name:` line unchanged, and edit the +`effort:` line; your copy takes precedence over the plugin's. + +Unattended, with the problem in a file (likewise for `solo`): ``` -claude -p "/math-proof:siege $(cat problem.md)" --model claude-opus-5-5 --effort high \ - --permission-mode bypassPermissions --dangerously-skip-permissions +claude -p "/math-proof:siege problem.md" --model claude-opus-5-5 --effort high \ + --dangerously-skip-permissions ``` -**Caution:** `siege`'s judge runs model-written Python through Claude -Code's shell tool on your machine. Use the permission-skipping flags only in a +With an API key, adding `--max-budget-usd <amount>` to that `-p` command stops +the run once that much has been spent; giving the command again resumes it. + +**Caution:** `siege`'s judge runs model-written Python through Claude Code's +shell tool on your machine. Use `--dangerously-skip-permissions` only in a disposable container or VM, as a non-root user; otherwise approve its commands by hand. |
