moai-lang-rust

name	moai-lang-rust
description	Rust specialist for async services, safe systems programming, and production tooling with Tokio, Axum, SQLx, and clippy-driven quality checks. Use when building or refactoring Rust code.
license	Apache-2.0
compatibility	Designed for Claude Code
allowed-tools	Read, Grep, Glob, Bash
user-invocable	false
metadata	{"version":"2.0.0","category":"language","status":"active","updated":"2026-02-22"}

Rust Development (Lean)

When to use

• .rs files and Cargo.toml
• Async services, CLI tools, systems components
• Ownership/lifetime, trait, or performance-sensitive work

Defaults

• Prefer explicit error types at library boundaries.
• Keep unsafe usage isolated and documented.
• Use clippy and rustfmt as non-optional quality gates.
• Favor simple ownership flows over complex lifetimes when possible.

Quick workflow

1. Identify crate boundaries and public APIs.
2. Implement minimal change with clear types/errors.
3. Add/update tests for changed behavior.
4. Run fmt, clippy, and tests.

Commands

• Format: cargo fmt --all
• Lint: cargo clippy --all-targets --all-features -- -D warnings
• Test: cargo test --all-features
• Build release: cargo build --release

Implementation checklist

• Result<T, E> and ? used consistently.
• Avoid panics in non-test code paths unless explicitly fatal.
• Serialization contracts versioned when exposed externally.
• Concurrency primitives chosen deliberately (Mutex, RwLock, channels, semaphore).

Validation checklist

• cargo fmt clean.
• cargo clippy clean.
• Tests pass.
• New dependencies justified.

References

• references/reference.md - compact guidance and docs links
• references/examples.md - concise service/test patterns
• ../AGENT_SKILL_SPEC.md - shared Anthropic/Copilot alignment