moonbit

name	moonbit
description	MoonBit language development best practices for AI agents. Use when writing, refactoring, or testing MoonBit code, working with moon tooling (build/check/test/fmt/info), navigating MoonBit projects, or following MoonBit-specific conventions for syntax, testing, and project layout.

MoonBit Development Guide

Quick Start

MoonBit is an expression-oriented language with garbage collection (no lifetimes/ownership). Key characteristics:

• Expression-oriented: if, match, loops return values
• Block separator: Use ///| between top-level declarations
• Error handling: Checked errors with raise keyword, automatic propagation
• Packages: No import in code; configure in moon.pkg/moon.pkg.json

Agent Workflow

Follow this order for reliable task execution:

1. Clarify goal - Confirm expected behavior and constraints
2. Locate boundaries - Find moon.mod.json (module root) and relevant moon.pkg files
3. Discover APIs - Use moon ide doc before coding
4. Refactor semantically - Use moon ide rename for symbol renaming
5. Edit locally - Keep changes package-local with ///| delimiters
6. Validate - Run moon check regularly, then targeted tests
7. Finalize - Run moon fmt and moon info before completion