MoonBit Practice Guide

Best practices for AI when generating MoonBit code. If you don't understand something here, use moonbit-docs skill to search the official documentation.

Verified against MoonBit v0.10.12 (docs snapshot 2026-09). MoonBit is still pre-1.0 and breaks syntax on minor releases — when a construct here is rejected, run moon fmt first (it auto-migrates most deprecations) and check moon explain <error-code>.

Guidelines

Code Navigation: Prefer moon ide over Read/Grep

In MoonBit projects, prefer moon ide commands over Read tool or grep.

# ❌ Avoid: Reading files directly
Read src/parser.mbt