Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A strong, actionable integration guide with executable code, a well-sequenced workflow, verification checkpoints, and dense gotcha documentation. The only weakness is a hardcoded minimum SDK version that is time-sensitive and not isolated in a deprecated section.
Suggestions
Move the 'Minimum required version: 0.3.1' detail into an explicitly labeled versioning/old-patterns note so the time-sensitive number is isolated and easy to update, rather than embedded in Step 1 and the checklist.
Consider noting how to discover the current minimum version (e.g. 'check the installed @cognite/app-sdk version in package.json') instead of pinning a literal version that will go stale.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but it hardcodes a time-sensitive minimum version '0.3.1' (Step 1 and the checklist) outside any deprecated/old-patterns section, which the guideline says should penalize conciseness. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready TypeScript throughout — useHostApp hook, sendAgentLayoutMode/sendAgentMessage calls, createAgentResource/createAgentAction with Zod, the useAgentServer lifecycle, and an App.tsx wiring example. | 3 / 3 |
Workflow Clarity | Clear Steps 0–6 sequence with a final verification checklist, explicit error handling (.catch() on register/unregister), and Symptom→Fix recovery loops in the Known pitfalls section, satisfying the explicit-validation anchor. | 3 / 3 |
Progressive Disclosure | No bundle files exist, so scoring is on organization; the body is well-structured into clearly headed sections (Steps, Dev vs. production, Testing, Known pitfalls, Checklist) with no nested references and easy navigation. | 3 / 3 |
Total | 11 / 12 Passed |