moon-guidelisted

# Moon Build System Guidelines ## Requirements - Moon ≥ 2.0, Node.js for JavaScript/TypeScript projects. - Migration from v1: Run `moon migrate v2` to automate configuration updates. ## Essentials - **Task configuration** - Define in `.moon/tasks/*.yml` for auto-inheritance, see [references/task-configuration.md](references/task-configuration.md), [references/task-inheritance.md](references/task-inheritance.md) - **Tags** - Use for categorization, filtering, boundaries, inheritance, see [references/tag-based-filtering.md](references/tag-based-filtering.md) - **Execution** - `project:task`, `#tag:task`, `:task` (all), `--query`, `--affected` - **Querying** - Query projects/tasks by tags, language, or query language, see [references/query-language.md](references/query-language.md) - **Configuration** - Projects use `moon.yml`, workspace uses `.moon/workspace.yml` - **Toolchains** - Moon manages language toolchains, configured in `.moon/toolchains.yml` (plural in v2) - **Caching** - Built-in task caching with output definitions, see [references/task-configuration.md](references/task-configuration.md) ## Moon 2.0 Key Changes - **command vs script** - Use `script:` for shell features (pipes, redirects, chaining); `command:` for simple executables only - **Shell by default** - Tasks run in shell by default (`bash` on Unix, `pwsh` on Windows) - **Deep merging** - Configs merge sequentially (not shallow), fileGroups combine instead of replace - **Renamed settings** - `platform`