Content
67%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 actionable with strong executable CLI examples and a clear connection-state workflow. It loses points for a padded introductory paragraph, an undefined "Step 2" reference, and the absence of validation guidance before running mutating actions.
Suggestions
Trim the introductory marketing paragraph and the bare-noun overview bullets; assume Claude knows what a contract platform is and only state what is non-obvious about the Common Paper/Membrane integration.
Define or relabel the missing "Step 2" (e.g., rename to "Searching for and running actions") so the "skip to Step 2" checkpoint has a clear target.
Add a validation/check step before mutating actions (e.g., dry-run or confirm destructive/batch operations) to satisfy the workflow-clarity feedback-loop guidance for batch operations.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The intro paragraph ("Common Paper is a standardized contract platform that streamlines legal processes...Think of it as a library of pre-approved legal templates") and the bare-noun overview bullets explain context Claude already knows and could be trimmed. | 3 / 5 |
Actionability | Concrete, copy-paste-ready CLI commands (login, connection ensure, action list/run, request) with a full proxy-options flag table cover the common cases; minor runtime placeholders like CONNECTION_ID and QUERY are legitimate substitutions. | 4 / 5 |
Workflow Clarity | The connection flow is well-sequenced with a state machine (READY/BUILDING/CLIENT_ACTION_REQUIRED/error) and polling checkpoints, but "Step 2" is referenced without being defined and there is no validation step before running actions. | 4 / 5 |
Progressive Disclosure | Single ~140-line file with clear section headers and no bundle files; well-organized, though the proxy options table and action-schema details are inlined rather than split into references. | 4 / 5 |
Total | 15 / 20 Passed |