skynet/small-scripts
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat: explore-minimax-run — read-only MiniMax exploration wrapper + mode guidance

Browse Source 
Hardened wrapper for delegating broad codebase exploration to MiniMax M3:
per-root --add-dir scoping, secrets-root refusal, enforced read-only via
--disallowedTools (profile defaults to acceptEdits), JSON .result answer
channel, internal timeout + retry, file:line citation gate with distinct
fallback exit codes. deep/deep-fable/orch modes now prefer /explore-minimax
for broad read-only sweeps, Explore agent as fallback.

Claude-Session: https://claude.ai/code/session_01Ku87DDWwbJkTx6SuV3sQDc
This commit is contained in:
Paul O'Reilly
2026-09-11 11:33:38 +12:00
parent 0ceb49044a
commit abed9e7c25
5 changed files with 212 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

5
data/claude-profile/modes/deep-fable.md
View File

@@ -20,7 +20,8 @@ You are running as Fable 5. Fixed for the session. To get Opus reasoning, do NOT
## Subagent policy
- Default subagent model: Fable
- Spawn a Fable subagent when: a research task spans >3 files or needs broad exploration (use the Explore agent)
- Broad read-only exploration (>3 files, "find where X lives" sweeps): prefer the `/explore-minimax` skill — the sweep runs in MiniMax and only a cited conclusion returns. Spot-check 1–2 of its citations before relying on the answer. Fall back to the Explore agent (Fable) if it fails or the answer is uncited.
- Spawn a Fable subagent when: research needs iterative steering, code-quality judgement, or tools MiniMax lacks (use the Explore agent)
- Spawn an Opus subagent ONLY via the named workflows below — not freelance
- Do NOT spawn parallel Fable subagents to "go faster" on coding work; finish one thing properly before starting the next
@@ -31,7 +32,7 @@ You are running as Fable 5. Fixed for the session. To get Opus reasoning, do NOT
## Async policy
- Background bash: enabled
- Third-party delegation: the /ask-minimax skill (file-heavy grunt work, second opinions); on MiniMax failure, fall back to an Opus subagent.
- Third-party delegation: the /ask-minimax skill (file-heavy grunt work, second opinions) and /explore-minimax (broad read-only exploration); on MiniMax failure, fall back to an Opus subagent (ask-minimax) or the Explore agent (explore-minimax).
- ScheduleWakeup: enabled, for checking on background jobs. Wakeup prompts MUST be self-contained.
- Container agents (control plane): not the focus of this mode — if you find yourself wanting them, suggest relaunching in `orch`

5
data/claude-profile/modes/deep.md
View File

@@ -20,7 +20,8 @@ You are running as Sonnet. Fixed for the session. To get Opus reasoning, do NOT
## Subagent policy
- Default subagent model: Sonnet
- Spawn a Sonnet subagent when: a research task spans >3 files or needs broad exploration (use the Explore agent)
- Broad read-only exploration (>3 files, "find where X lives" sweeps): prefer the `/explore-minimax` skill — the sweep runs in MiniMax and only a cited conclusion returns. Spot-check 1–2 of its citations before relying on the answer. Fall back to the Explore agent (Sonnet) if it fails or the answer is uncited.
- Spawn a Sonnet subagent when: research needs iterative steering, code-quality judgement, or tools MiniMax lacks (use the Explore agent)
- Spawn an Opus subagent ONLY via the named workflows below — not freelance
- Do NOT spawn parallel Sonnet subagents to "go faster" on coding work; finish one thing properly before starting the next
@@ -31,7 +32,7 @@ You are running as Sonnet. Fixed for the session. To get Opus reasoning, do NOT
## Async policy
- Background bash: enabled
- Third-party delegation: the /ask-minimax skill (file-heavy grunt work, second opinions); on MiniMax failure, fall back to an Opus subagent.
- Third-party delegation: the /ask-minimax skill (file-heavy grunt work, second opinions) and /explore-minimax (broad read-only exploration); on MiniMax failure, fall back to an Opus subagent (ask-minimax) or the Explore agent (explore-minimax).
- ScheduleWakeup: enabled, for checking on background jobs. Wakeup prompts MUST be self-contained.
- Container agents (control plane): not the focus of this mode — if you find yourself wanting them, suggest relaunching in `orch`

1
data/claude-profile/modes/orch.md
View File

@@ -21,6 +21,7 @@ You are running as Sonnet. Fixed for the session. Your job is orchestration, not
## Subagent policy
- Default subagent model: Sonnet (for any in-session research)
- Spawn a subagent when: you need to read a lot of CP state, agent logs, or task output that would bloat your context
- Pre-dispatch codebase exploration (scoping tasks before decompose/dispatch): prefer the `/explore-minimax` skill — read-only MiniMax sweep, cited conclusion only; fall back to the Explore agent on failure
- The MAIN parallelism mechanism in this mode is container agents via the agent-runtimes control plane, not in-session subagents
## Reasoning posture