Files
claude-foundations/memory/script-explore-minimax-run.md
Paul O'Reilly 468d75b224 docs: explore-minimax memory + ask-minimax usage update
Add /explore-minimax and explore-minimax-run memory files, backfill
skill-ask-minimax / skill-ask-minimax-with-context entries, index them in
MEMORY.md. ask-minimax-usage.md gains the exploration use case and an
explicit no-secrets rule.

Claude-Session: https://claude.ai/code/session_01Ku87DDWwbJkTx6SuV3sQDc
2026-09-11 11:33:52 +12:00

24 lines
1.5 KiB
Markdown

# explore-minimax-run
**Purpose:** Hardened wrapper (in `small-scripts/scripts/`) running a read-only MiniMax M3 exploration sweep. Backs [[skill-explore-minimax]]; safe to drive directly (skills only register at session start, so direct invocation is also the test path).
**Spec:** `small-scripts/specs/explore-minimax-run.spec.md` — full flag table, behaviour requirements, exit codes.
## Quick reference
```
explore-minimax-run --root <path> [--root ...] --prompt-file <q> --out <result> \
[--breadth medium|very-thorough] [--max-turns N] [--timeout SECS]
```
Exit: 0 = answer written; 1 = usage/config (incl. refused secrets root); 2 = MiniMax failed after one internal retry; 3 = answer empty/uncited → fall back to Explore agent.
## How it works
Resolves roots (`realpath -e`), refuses secrets paths, passes each as `--add-dir` (paths outside cwd are otherwise permission-denied — gotchas-minimax). Prepends a fixed preamble (citations required, NOT FOUND over guessing, credential skip-list, "Searches run:" trailer), then calls `ask-minimax-run` with `--permission-mode default --allowedTools "Read,Glob,Grep"` + a deny-list, `--output-format json`, stdin-redirected prompt (no `$()`), internal `timeout` (default 540s), jq-extracted `.result`, one retry, citation grep.
## Gotchas
- Relies on `CLAUDE_CODE_MAX_CONTEXT_TOKENS=1000000` in the minimax `provider.env` for the 1M window.
- Do not weaken the secrets root check or the deny-list — the profile's own settings are permissive (`acceptEdits` default, `Edit(/tmp/**)`, WebFetch).