3.0 KiB
3.0 KiB
MiniMax M3.1 Flash: brief template and launch procedure
Companion to minimax-m3-1-flash.md (rules, lessons) and opencode-runbook.md (tooling). Use this file to write a brief that the model finishes. 18 briefs were run on 2026-10-21: 17 delivered, the one failure was a brief without the HOW TO START block.
Launch
scripts/oc-agent.sh <name> <brief.md> # model opencode/minimax-m3.1-flash-free, own target dir, logs in .mm-agents/
- At most 3 at once, 45 s apart. Never two briefs that OWN the same file or the same crate.
- Result:
.mm-agents/<name>.log(final report) andsummary.log("done" only means the process ended: read the log). - Lead gate after every round, on a copy of the tree:
cargo fmt --all, rsync copy,cargo xtask ci(twice: the first run usually exceeds a 580 s command cap). New crates must be inxtask/src/layers.rsand rootCargo.toml(agents forget; the layers gate says so). - Every brief ends with: "When done delete your scratch copy and
target/agent-<name>, runscripts/clean-agent-builds.sh --check, report the free-space line" (.claude/rules/build-hygiene.md). The lead runsscripts/clean-agent-builds.shafter each commit. - Commit by explicit paths only after the gate is green. Never commit
.notescraft/,target-mini/, build artefacts.
Brief skeleton (copy, fill, keep under 120 lines)
# TASK <slug>: <one line>
Runs through OpenCode (`specs/agents/opencode-runbook.md` is attached automatically).
## OWNS
- exact new files (a new folder when the directory already holds 12 loose .rs)
- one-line registrations in existing files (`mod x;`, `register_x(reg)`, CORE_IDS, assistant_gate)
## FILES TO OPEN
- 2 to 5 existing files that show the pattern, with the symbol to copy
## GOAL / API
- exact public signatures of the first function(s); behaviour as bullets with examples
## TESTS
- named cases, including hostile input (empty, 1 MB, unterminated, non-UTF-8 boundaries)
## VERIFY
- `cargo test -p <crate>`, `cargo clippy -p <crate> --all-targets -- -D warnings`, `rustfmt --edition 2024 <files>`, `cargo xtask layers|tree|i18n`
## DO NOT
- touch files outside OWNS, add third-party dependencies, use unwrap/expect/panic/indexing on input
## HOW TO START
Do NOT explore. Open only the files under FILES TO OPEN you need, and in your SECOND tool call write the first OWNS file. Run VERIFY at the end.
What works and what fails
| Works | Fails (reason: length, no code) |
|---|---|
| one new folder or crate, pure functions, exact signatures given | "explore the codebase and design it" |
| 1-2 registration lines in existing files | edits across 5+ existing files |
| tests named in the brief | UI that needs a render loop and several shared files (give a Sonnet agent instead) |
| a stop rule for missing fixtures | briefs that need a fixture the repo lacks |
Reports must say: files, public API, test counts, what was not done. The lead reads gaps (no UI wiring, registrations skipped) from the report, not from "all gates green".