Content
75%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 lean, highly actionable routing layer: a decision table, exact CLI commands and parameter names, and sharply worded critical rules, all correctly deferring detail to six real reference files. Main deductions are version-pin staleness outside a deprecated section and reference links pointing at external URLs instead of the bundled relative paths.
Suggestions
Move the pinned API version (2026-08-26.dahlia) and the SDK version table into a clearly labeled 'Current versions' or 'Deprecated/old patterns' style section so staleness is self-evident and doesn't read as evergreen guidance.
Change reference links to relative paths (e.g. [references/payments.md](references/payments.md)) so they resolve to the bundled files rather than docs.stripe.com URLs.
Add one minimal copy-paste example for the most common case (e.g. a Checkout Session create with integration_identifier and the 8-random-letter suffix) to close the actionability gap without delegating everything to references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is efficient — a routing table, imperative critical rules, and exact commands with no explanation of concepts Claude already knows — but time-sensitive version pins ("Latest Stripe API version: 2026-08-26.dahlia", the SDK version table, "On API version 2026-03-25.dahlia or later") are not placed in a deprecated/old-patterns section, which the guidelines penalize. Fits the 4 anchor (efficient, minor trimmable elements) better than 3 (no noticeable padding or unnecessary explanation). | 4 / 5 |
Actionability | Highly concrete guidance throughout: exact commands ("stripe sandbox create", "stripe whoami --format json"), exact parameters ("automatic_tax: { enabled: true }", "payment_method_types: ['card_present']", "integration_identifier"), and a decision routing table. It falls short of the 5 anchor only because no complete copy-paste code example appears in the body itself — implementation detail is delegated to reference files, and the "pass the parameter integration_identifier… suffix of 8 random letters" rule lacks an example value. | 4 / 5 |
Workflow Clarity | The decision workflow is clear and sequenced: route via the "Integration routing" table, "Read the relevant reference file before answering any integration question or writing code", then apply the "Critical rules" — with one explicit confirmation gate ("confirm the user has an active registration" before enabling automatic_tax). It is not 5 because there are no explicit verification/error-recovery checkpoints, and not 3 because the sequence and key checkpoints are present and coherent. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview with well-signaled, one-level-deep references, and every referenced bundle file (references/payments.md, connect.md, billing.md, tax.md, treasury.md, security.md) exists on disk. Minor gap: reference links point to external URLs (https://docs.stripe.com/references/payments.md) rather than relative paths to the bundled files, slightly muddying navigation; this matches the 4 anchor's "references mostly clear; minor organization gaps" rather than the 5 anchor's easy navigation. | 4 / 5 |
Total | 16 / 20 Passed |