Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-sequenced, highly actionable workflow with strong validation checkpoints and good progressive disclosure via externalized data-access and design-system references. The only meaningful weakness is mild verbosity in the inline HTML report template and repeated cross-references.
Suggestions
Move the full HTML report structure template into a reference file (e.g. references/report-template.html) and keep only the section list and citation rules inline, to tighten the body.
Consolidate the scattered 'see ../data-access.md Section X' callouts into a single up-front pointer plus inline notes only where the section is load-bearing for a step.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence (no basic-concept padding), but the inline HTML report template and repeated 'see ../data-access.md Section X' callouts add length that could be tightened or delegated, placing it at 'mostly efficient but could be tightened.' | 2 / 3 |
Actionability | It provides fully executable guidance: named tool calls (discover_companies, discover_company_series, get_company_fundamentals), exact search-query strings, output path, citation format, and explicit multiple formulas — copy-paste ready. | 3 / 3 |
Workflow Clarity | A clearly numbered 9-step sequence with explicit validation checkpoints (N/A-when-unsourced rule, '<3 data points is not meaningful', Daloopa fallback logic, and the 'ask for a ticker before proceeding' guard) gives strong feedback loops for the batch deal-sourcing operation. | 3 / 3 |
Progressive Disclosure | Data access and formatting conventions are externalized to well-signaled, one-level-deep sibling files ('Before starting, read ../data-access.md ... and ../design-system.md'), and the body is organized into clearly numbered sections, giving easy navigation. | 3 / 3 |
Total | 11 / 12 Passed |