# [name] One-paragraph description of what this tool does and when an agent would call it. ## Behavior Long-form: what side effects it has, whether it's idempotent, whether it commits to disk, what state it mutates, what it returns. ## Args - `arg1: string` — description, valid range/format, required vs optional. ## Returns `ZmToolResult` — `{ exitCode, data?, stdout?, message? }`. `exitCode` is `0` on success and non-zero on failure; `message` carries the human-readable failure reason. ## Examples ```luau tools.call("[toolboxName].[name]", { arg1 = "foo" }) ```

# [name] One-paragraph description of what this tool does and when an agent would call it. ## Behavior Long-form: what side effects it has, whether it's idempotent, whether it commits to disk, what state it mutates, what it returns. ## Args - `arg1: string` — description, valid range/format, required vs optional. ## Returns `ZmToolResult` — `{ exitCode, data?, stdout?, message? }`. `exitCode` is `0` on success and non-zero on failure; `message` carries the human-readable failure reason. ## Examples ```luau tools.call("[toolboxName].[name]", { arg1 = "foo" }) ```

# [name] One-paragraph description of what this tool does and when an agent would call it. ## Behavior Long-form: what side effects it has, whether it's idempotent, whether it commits to disk, what state it mutates, what it returns. ## Args - `arg1: string` — description, valid range/format, required vs optional. ## Returns `ZmToolResult` — `{ exitCode, data?, stdout?, message? }`. `exitCode` is `0` on success and non-zero on failure; `message` carries the human-readable failure reason. ## Examples ```luau tools.call("[toolboxName].[name]", { arg1 = "foo" }) ```

# [name] One-paragraph description of what this module provides and who consumes it. ## Exports - `M.exampleFn(arg) -> result` — what it does and when to call it. - `M.exampleValue: type` — what value it carries. ## Usage ```luau local M = require("@<youridentity>::modules.[name]") M.exampleFn("foo") ``` ## Notes - Anything callers need to know about THIS module: required runtime ordering, state ownership, side effects.

# [name] One-paragraph description of the surface this toolbox exposes — what problem space the tools cover and who calls them. ## Tools - `[name].exampleTool` — what it does. - `[name].otherTool` — what it does. ## Conventions - Tools in this toolbox share `shared.module/` — describe what helpers it exposes (result envelopes, validators, formatters). - Any cross-tool invariants: shared state, ordering requirements, failure-mode conventions. ## Usage ```luau tools.call("[name].exampleTool", { arg1 = "foo" }) ```