Content
71%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-structured overview with a proper one-level-deep reference split and a coherent Check/Fix/Explain flow. Its main weakness is actionability: the body's own guidance stays high-level, leaving the example disclosure copy and link-detection specifics entirely to references/rule.md, and post-fix re-verification is implicit rather than an explicit step.
Suggestions
Inline a one-line example disclosure statement (or the short HTML snippet from references/rule.md) under Fix so the step is copy-paste ready without opening the reference.
Add a concrete detection hint to Check, e.g. grep templates/routes for known affiliate domains or rel="sponsored"/utm-tagged links, so locating affiliate links is executable rather than assumed.
Make post-fix validation explicit: re-render the affected page and confirm the disclosure appears before the first affiliate link (the re-crawl guidance currently buried in references/rule.md).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean ~40 lines of task-oriented sections with only minor over-explanation — the motivational opener "Clear disclosures are required by law (e.g., FTC guidelines) and are essential for maintaining user trust" and the overlap between the Quick Reference bullets and the Fix section. It is not a 5 because those two spots could be trimmed, and not a 3 because padding is limited to a sentence or two of broadly-known context. | 4 / 5 |
Actionability | "Place the disclosure at the top of the page, before any affiliate links appear" and "Add a standardized disclosure statement at the beginning of your content or near affiliate links" are concrete, but the body never shows example disclosure wording, gives no method for locating affiliate links, and offers only high-level direction like "Use simple, unambiguous language to explain the financial relationship" — matching the anchor for some concrete guidance with key details missing. It is not a 4 because the copy-paste-ready material (the HTML example) lives only in the reference file, and not a 2 because the placement and fix instructions are specific. | 3 / 5 |
Workflow Clarity | The Check → Fix → Explain sections form a coherent sequence and the Check section ("Verify that all pages containing affiliate links or sponsored content have a clear, visible disclosure before the links appear") doubles as the validation checkpoint, so most checkpoints are present. It is not a 5 because there is no explicit post-fix re-verification loop in the body (re-crawl guidance sits in references/rule.md), and not a 3 because the sequence is clear and each phase is well defined. | 4 / 5 |
Progressive Disclosure | The body is a clean overview with a single, clearly signaled, one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file exists, holds the code example and detail, and points no further. This matches the anchor for a clear overview with well-signaled one-level references and easy navigation; no structural gaps justify a 4. | 5 / 5 |
Total | 16 / 20 Passed |