Content
46%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a concise, well-intentioned routing table with a couple of genuinely useful decision rules, but it contains almost no executable guidance of its own and every one of its 13 referenced resource files is missing from the bundle, making the routing unusable as shipped. Fixing the dangling references is the single highest-impact repair.
Suggestions
Ship the referenced files or fix the paths: all 13 links under resources/ (OPTIMIZATION.md, BIGFRAMES.md, BQML.md, ai-forecast.md, ai-evaluate.md, ai-generate-table.md, ai-generate-embedding.md, remote-models.md, ml-contribution-analysis.md, vector-search.md) point to files that do not exist in the bundle.
Make the mandatory data-size check executable by including the concrete method (e.g., a snippet showing how to inspect table size or row count) instead of only the directive "You MUST check the data size before deciding on which libraries to use".
Deduplicate the notebook guidance (repeated in the top IMPORTANT callout and section 4) and repair the broken inline list formatting where "- **Guide**:" and the function links are spliced mid-sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body is a lean routing table that assumes Claude's competence and delegates detail to per-topic guides, with useful inline rules ("Bigframes should be the default library/tool as it is more efficient than using the BigQuery Python client library"). It falls short of anchor 5 due to a redundant two-sentence self-description ("provides comprehensive guidance... acts as a routing table"), a notebook reference duplicated in both the top IMPORTANT callout and section 4, and broken inline formatting where "- **Guide**:" is spliced mid-sentence. | 4 / 5 |
Actionability | The body's own executable guidance amounts to two high-level directives — "You MUST check the data size before deciding on which libraries to use" and making Bigframes the default — with no code, commands, or method for how to check data size, and everything else delegated to linked guides. This matches anchor 2 ('high-level hints but missing the specific steps to execute') better than anchor 3, which expects some concrete, if incomplete, executable detail in the body itself. | 2 / 5 |
Workflow Clarity | Topic routing is unambiguous via numbered sections, and the data-size rule acts as a stated decision checkpoint, but the actual operational sequence (check data size, choose library, consult the topic guide, apply its standards) is only implied and never laid out as steps. No batch or destructive operations apply, so no cap is triggered; it sits at anchor 3 ('sequence present but checkpoints missing or implicit') rather than anchor 4's clearly sequenced workflow. | 3 / 5 |
Progressive Disclosure | The body is structured as a clean one-level-deep routing table with well-signaled links to 13 per-topic files (OPTIMIZATION.md, BIGFRAMES.md, BQML.md, ai-forecast.md, etc.), but none of the referenced resources/ files exist in the bundle — every link dangles, so the navigation cannot actually be followed. Per the guideline to score against the actual bundle structure, this lands at anchor 2 ('minimal structure... references are buried/unusable'), noticeably below the midpoint despite the good skeleton, though not anchor 1 since there is no monolithic text or nested references. | 2 / 5 |
Total | 11 / 20 Passed |