check_uae_bim_compliance

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden and does disclose the core behavior: it returns mandate status, compliance score, required LOD, and submission checklist. It does not, however, clarify edge cases (e.g., emirate='other'), whether any data is persisted, or how mandatory thresholds are applied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence front-loads the purpose and jurisdiction, then lists the returned outputs. There is no filler or repetition of schema details.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with eight required parameters, no annotations, and no output schema, the description is minimal. It provides a good high-level summary but omits practical context such as parameter meanings, emirate fallback behavior, or how the compliance score relates to the returned checklist.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is only 13%, so the description needed to compensate, but it explains nothing about the eight required parameters. Names like building_area_m2 and emirate are self-evident, but terms such as has_bep remain ambiguous (BIM Execution Plan vs. building energy performance) without any clarification in the description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific verb ('Check'), a concrete resource ('UAE BIM mandate applicability'), and cites exact regulations (Dubai Circular 196, Abu Dhabi DMT, Sharjah), which also separates it from generic BIM or UAE sustainability siblings. It also previews the result type, making the tool's intent unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The intended use is implied by the title and description: use this for UAE BIM mandate checks. However, it does not state when to prefer it over related tools such as dgnb_bim_readiness or building_readiness, nor does it give exclusions or explicit conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.