Skip to content
Ready Mark

CHECKLIST, CONDITION 2 OF 10, read 13 Nov 2026

Documented: 11 of 17 tools check it by rule, 5 leave it to a person

The checklistCoverage matrix

The test
A description or business definition exists for the asset and its key columns.
Why it matters
Agents work from names and descriptions. With only a schema, an agent guesses what a column means and returns a confident wrong answer.
How to check it
Read the asset page or the model YAML. Check that the table and the columns the agent will touch each have a description that says what they mean in business terms.
What failing looks like
A column named amt_2 has no description, and the agent treats it as net revenue when it is gross.

What each use case needs

Use caseNeedWhy
Metric agentrequiredThe agent picks columns by their documented meaning, so missing descriptions become wrong answers.
Coding agentrequiredA coding agent reads descriptions to learn what a model is for before it changes the logic.
Write-back agentrecommendedWrite-back targets are usually fixed fields, but a description helps the agent map values to the right field.

11 tools check documented by rule

5 tools leave documented to a person

1 tools show none found on 13 Nov 2026

What the sources say

Other conditions

Sources

  1. Atlan: AI-ready data for talk-to-data, read 13 Nov 2026
  2. dbt Labs: 5 dbt MCP server patterns that work in production, read 13 Nov 2026
  3. Gartner: Lack of AI-Ready Data Puts AI Projects at Risk (Q&A with Roxane Edjlali, Feb 26, 2025; archived copy), read 13 Nov 2026
  4. McKinsey: A data leader's technical guide to scaling gen AI (archived copy; mckinsey.com did not load from this run), read 13 Nov 2026

Last reviewed 13 Nov 2026.