Content
85%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.
A well-architected orchestrator body that sequences a multi-step CLI workflow with explicit validation and feedback loops, and cleanly delegates detail to real one-level-deep references. It is slightly verbose in its environment-preflight messaging and defers some command specifics to the referenced SOPs.
Suggestions
Tighten the Step 0 environment-preflight section by shortening or externalizing the full ChatGPT copy block, which adds length without routing value.
Consider inlining one or two of the most common design commands (e.g. create-design-draft) so the body is executable end-to-end without always loading SUPERDESIGN.md.
Consolidate the repeated 'retry once' guidance into a single stated rule rather than restating it per failure type.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, directive, and assumes Claude's competence without explaining known concepts, but the Step 0 full-copy message blocks and repeated 'retry once' emphases could be trimmed slightly, keeping it just below the lean anchor. | 4 / 5 |
Actionability | Concrete commands and paths are provided for the core flow ('npx --yes @superdesign/cli@latest', 'login', the six named init files, '.superdesign/resume.json'), while detail commands are deliberately deferred to references — mostly executable guidance with minor gaps. | 4 / 5 |
Workflow Clarity | A clearly sequenced Step 0 → Step 1 → Step 1.5 → Init → CLI flow with explicit validation checkpoints (the init-complete rule, the auth: line check, trust/structural resume checks) and feedback loops (retry-once, login-then-retry, offer to continue without extraction). | 5 / 5 |
Progressive Disclosure | The body is an overview that routes to one-level-deep references (INIT.md, SUPERDESIGN.md, WEBSITE.md, PRESENTATION.md, GRAPHIC.md, ASSET_GENERATION.md, RESUME.md, design-with-your-model.md) — all of which exist in ./references/ — each clearly signaled by scenario. | 5 / 5 |
Total | 18 / 20 Passed |