🚀 Advanced MiniMax M2.1 Cursor Rules

<div align="center">

# 🚀 Advanced MiniMax M2.1 Cursor Rules

[![Stars](https://img.shields.io/github/stars/madebyaris/advance-minimax-m2-cursor-rules?style=flat-square)](https://github.com/madebyaris/advance-minimax-m2-cursor-rules/stargazers)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=flat-square)](LICENSE)
[![Cursor 2.3+](https://img.shields.io/badge/Cursor-2.3%2B-blue?style=flat-square)](https://cursor.com)
[![MiniMax M2.1](https://img.shields.io/badge/MiniMax-M2.1-purple?style=flat-square)](https://platform.minimax.io)

**Agentic-first Cursor rules that transform simple prompts into production-ready, verified code**

[Quick Start](#-quick-start) • [Features](#-features) • [Rules](#-rules) • [Philosophy](#-philosophy) • [Contributing](#-contributing)

</div>

---

## ✨ Features

- **🧠 Agentic-First Workflow** — Verify → Plan → Act → Validate (like Opus 4.5)
- **✅ CLI-First Development** — Always use framework CLIs, never create config files manually
- **🔍 Version Verification** — Web search for current package versions before using
- **❓ Clarify-First Prompting** — AI checks context first, then asks targeted questions
- **💭 Preserved Thinking** — Maintains reasoning context across conversations
- **🛠️ Full Cursor 2.3/2.4 Support** — All tools documented and optimized (works with Nightly)
- **🔌 MiniMax MCP** — `web_search` + `understand_image` integration
- **🌐 Multi-Language** — Web, Python, Rust, Go, Swift, Flutter, DevOps
- **⚠️ Syntax Trap Prevention** — Common mistakes documented per language

---

## 🎯 Philosophy

These rules are designed to make AI code generation **actually work** by enforcing real development practices:

### The Golden Rule: Verify Before You Act

```
1. CHECK  — What exists? What's the current state?
2. VERIFY — What versions? What CLIs are available?
3. ACT    — Make the change using proper tools
4. VALIDATE — Did it work? Any errors?
```

### What This Prevents

| ❌ Bad Practice | ✅ What Rules Enforce |
|-----------------|----------------------|
| Manually creating `package.json` | Use `npm init` or `npx create-next-app` |
| Manually creating `pubspec.yaml` | Use `flutter create` |
| Manually creating `Cargo.toml` | Use `cargo new` |
| Manually creating `.xcodeproj` | **NEVER** - use Xcode only |
| Skipping `npm install` | Always run after setup |
| Using outdated package versions | Web search for current versions |
| Charts without container heights | Explicit Chart.js guidelines |

---

## 🚀 Quick Start

### 1. Clone & Copy

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

### 2. Configure MiniMax MCP

Add to Cursor Settings → MCP:

```json
{
  "mcpServers": {
    "MiniMax": {
      "command": "uvx",
      "args": ["minimax-coding-plan-mcp"],
      "env": {
        "MINIMAX_API_KEY": "<YOUR_API_KEY>",
        "MINIMAX_MCP_BASE_PATH": "<OUTPUT_DIR>",
        "MINIMAX_API_HOST": "https://api.minimax.io"
      }
    }
  }
}
```

> Get your API key at [platform.minimax.io](https://platform.minimax.io)

### 3. Restart Cursor

---

## 📁 Rules

### Core (Always Active) - Optimized for Context Efficiency

| Rule | Lines | Purpose |
|------|-------|---------|
| `minimax-m2-core.mdc` | ~350 | Agentic behavior, Opus 4.5-style thinking, RALPH loop |
| `cursor-agent-orchestration.mdc` | ~400 | Sub-agents, parallel workflows, EPIC todos, hooks |

### Agent-Requestable Skills (Loaded on Demand)

These rules are **not always loaded** - the agent requests them when relevant, saving context window:

| Rule | Purpose | Triggered By |
|------|---------|--------------|
| `minimax-m2-verification.mdc` | Pre/post verification protocols | Code generation tasks |
| `minimax-mcp-tools.mdc` | MiniMax MCP + version checking | Web search, image analysis |
| `cursor-tools-mastery.mdc` | Cursor 2.3/2.4 tools reference | Complex tool usage |
| `clarify-first-prompting.mdc` | Check first, then ask questions | Ambiguous requests |

### Language-Specific (Auto-Activate)

| Rule | Files | Key Features |
|------|-------|--------------|
| `web-development.mdc` | `*.js`, `*.ts`, `*.tsx`, `*.vue` | Next.js CLI, shadcn CLI, Chart.js containers |
| `python-development.mdc` | `*.py`, `requirements.txt` | venv requirement, uv/pip, common traps |
| `rust-development.mdc` | `*.rs`, `Cargo.toml` | cargo new/add, ownership traps |
| `go-development.mdc` | `*.go`, `go.mod` | go mod init, error handling patterns |
| `swift-development.mdc` | `*.swift` | **Xcode project warning**, Swift Package CLI |
| `flutter-development.mdc` | `*.dart`, `pubspec.yaml` | flutter create/pub add, dispose patterns |
| `mobile-cross-platform.mdc` | Cross-platform projects | Framework CLIs, platform differences |
| `devops-infrastructure.mdc` | `Dockerfile`, `*.tf`, `*.yaml` | Dry-run validation, version pinning |

---

## 🆕 v2.2+ Enhancements (Cursor 2.3/2.4 Compatible)

### Issue 

... (truncated)