Content
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a tight, actionable instruction set for writing Playwright E2E and visual regression tests, with a clear sequenced workflow, explicit validation steps, and a well-organized reference section. It assumes Claude's competence and concentrates on project-specific constraints that would otherwise be learned the hard way.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient; assumes Claude's competence and avoids re-explaining basic concepts, while the rationale given is project-specific and non-obvious (e.g. Cognito authorizer cannot be exercised at FastAPI level). | 3 / 3 |
Actionability | Provides concrete executable commands ('npx playwright test --update-snapshots', 'npx playwright test') and specific file paths (docs/use-cases/UC-*.md, playwright.config), with guidance concrete enough to act on directly. | 3 / 3 |
Workflow Clarity | A 9-step sequenced workflow with explicit validation checkpoints (step 7 confirm Chromium-only config, step 9 run tests and confirm everything passes), plus a DO NOT section that anticipates failure modes. | 3 / 3 |
Progressive Disclosure | Well-organized into Instructions, DO NOT, Workflow, and Resources sections with clearly signaled one-level-deep references to project docs (testing.md, design-system.md, UC-*.md); no nested-reference chains. | 3 / 3 |
Total | 12 / 12 Passed |