MiniMax M3 Cursor Rules

A durable execution spine for repo-scale engineering on M3 + Cursor 3.7 — with frontier-agent coding judgment and reasoning protocols distilled into rules any model can run.

Tuned for MiniMax M3 (1M-token MSA context, native multimodal input) and Cursor 3.7 (Agents Window, canvases, Design Mode, /worktree, /best-of-n, Await, MCP Apps). Written to stay useful across model changes.

Quick Start · Non-Dev Guide · Why This Repo · Architecture · Runtime Modes · Solver Loop · Evaluate It · References

---

At A Glance

	What you get
Lean always-on core	Two durable rules carry the execution spine — reasoning protocol, solver loop, scope control, code discipline, M3 long-context discipline, M3 multimodal input discipline, and a strict proof contract. No persona bloat.
Frontier craft, distilled	The fable5-* craft rules transfer the judgment behind SWE-Bench-class agents — locate-before-write, root-cause method, simplicity taste, test integrity, hypothesis ledgers, stuck-strategy ladder — to M3 and any open model.
Progressive depth	18 requestable rules + 7 skill packs load only when the task needs them, so context stays clean.
M3 long-context discipline	1M-token MSA context is a real lever, but the failure mode shifts to "kept too much raw output." A dedicated skill (minimax-m3-long-context) teaches the retention and compression cadence.
M3 multimodal-native	Image and video inputs ground visual claims (multimodal-grounded). A dedicated skill (minimax-m3-multimodal-input) teaches the design-parity and screenshot-triage workflow.
Cursor 3.7 surface	Explicit guidance for the Agents Window, canvases, Design Mode, /worktree, /best-of-n, Await, MCP Apps structured content, and Composer 2.5.
Honest tool use	The agent works the current runtime — no invented tools, no stale wrappers, no promises before the path is confirmed.
Evidence-backed closeouts	Explicit status labels (verified / unverified / blocked / multimodal-grounded), minimum-proof rules per change type, and red → green proof for bug fixes.
Portable	docs/AGENTS.md carries the same behavior to non-Cursor IDEs and CLIs.
Model-resilient	Tuned for M3 first, compatible with any Cursor-supported model.

The bet: MiniMax doesn't get better from persona text. It gets better from cleaner context, smaller proving slices, better tool routing, honest verification — and the same judgment habits frontier agents use: fix the broken invariant, not the symptom; never game a test; update the plan after every tool result. Every rule here optimizes for that.

---

Quick Start

Not a developer? You can still use these rules. Read the plain-language Non-Developer Guide — what the rules do for you, how to install them with no terminal, and how to write good prompts in everyday words. Available in English and Bahasa Indonesia.

For Cursor

git clone https://github.com/madebyaris/advance-minimax-m3-cursor-rules.git
cp -r advance-minimax-m3-cursor-rules/.cursor your-project/.cursor

That's it. Two rules are always on:

• .cursor/rules/minimax-m3-core.mdc — reasoning protocol, execution behavior, code discipline, M3 long-context discipline, M3 multimodal input discipline
• .cursor/rules/minimax-m3-status-verification.mdc — status & proof contract (multimodal-grounded visual proof, red → green for bug fixes)

Everything else is requestable and narrower by design — it loads when the task or file globs call for it. The two fable5-* craft rules load for non-trivial coding and reasoning work; the rest attach by runtime or domain.

The official docs recommend Anthropic-compatible access for MiniMax text models, and also support OpenAI-compatible access paths. See MiniMax text generation docs · MiniMax API overview.

For Other IDEs and CLIs

Copy docs/AGENTS.md into the target repo root as AGENTS.md. It lives under docs/ here on purpose, so Cursor does not auto-activate it while you edit these rules.

---

Repository Layout

.cursor/
├── rules/                         # 20 rules (2 always-on + 18 requestable)
│   ├── minimax-m3-core.mdc                  ★ always-on · execution spine + reasoning protocol + M3 disciplines
│   ├── minimax-m3-status-verification.mdc   ★ always-on · proof contract (+ multimodal-grounded, red → green)
│   ├── fable5-coding-craft.mdc              requestable · frontier coding judgment distillation
│   ├── fable5-reasoning.mdc                 requestable · frontier thinking protocols
│   └── …                                    requestable: runtime + domain
├── agents/                        # subagents (/debugger, /verifier)
│   ├── debugger.md                          root-cause analysis: hypothesis ledger, bisection, fix-at-the-owner
│   └── verifier.md                          adversarial validation: claim-gaming hunt, proof execution
└── skills/                        # 7 deep, structured skill packs
    ├── anti-slop-design/
    ├── 3d-web-experiences/
    ├── deep-research/
    ├── incident-triage-harness/
    ├── minimax-multimodal-toolkit/
    ├── minimax-m3-long-context/             # new · 1M-context retention/compression
    └── minimax-m3-multimodal-input/         # new · native image/video input workflow
docs/
├── AGENTS.md                      # portable agent contract (non-Cursor)
└── FOR-NON-DEVELOPERS.md          # plain-language guide for non-programmers
examples/
└── agent-teams-product-prototype.md
harness/                           # evaluation h