docs(claude-design): cross-reference Phase 9 from 04-handoff-and-scope.md

Adds a Phase 9 subsection at the end of Section 5 pointing at
references/05-critique-iterate.md, and states plainly that Phase 9 routes to
design:critique rather than reimplementing it, leaving the Section 4 scope
fence untouched.

Also corrects the Section 5 command list from the bare /critique-style
shorthand to the namespaced plugin:skill form the live plugin actually
exposes, and notes that none of those surfaces accept a generic web URL.
The Section 4 lifecycle table's Critique row now records that this plugin
coaches the stage via Phase 9 rather than leaving it blank.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NaybqQwqirrNmikJsUrbDg
This commit is contained in:
Kjell Tore Guttormsen 2026-08-18 21:04:25 +02:00
commit c844658332

View file

@ -79,7 +79,7 @@ The lifecycle-stage coverage map:
| Copy-paste delivery | ✓ Composed prompt block | — |
| Iteration coaching | ✓ Tweak / Comment / Chat cascade, session economics | — |
| Ship-readiness | ✓ Operator-attested + recommend downstream tool | — |
| Critique | — | ✓ `/critique` |
| Critique | Routed via Phase 9 — coached, never performed | ✓ `design:critique` |
| Accessibility audit | — | ✓ `/accessibility` |
| UX copy review | — | ✓ `/ux-copy` |
| Research synthesis | — | ✓ `/research-synthesis` |
@ -111,17 +111,25 @@ claude plugins add knowledge-work-plugins/design
In a new Claude Code session with that plugin installed:
- Run `/critique <path-or-URL>` to get a design critique
- Run `/accessibility <path-or-URL>` for a WCAG audit
- Run `/ux-copy <path-or-URL>` for copy review
- Run `/research-synthesis` if the operator has user-research notes to synthesize
- Run `/design-system <path-or-URL>` for design-system consistency check
- Run `/handoff <path-or-URL>` for engineering-handoff guidance
- Run `design:critique <path-or-file-reference>` to get a design critique
- Run `design:accessibility <path-or-file-reference>` for a WCAG audit
- Run `design:ux-copy <path-or-file-reference>` for copy review
- Run `design:research-synthesis` if the operator has user-research notes to synthesize
- Run `design:design-system <path-or-file-reference>` for design-system consistency check
- Run `design:handoff <path-or-file-reference>` for engineering-handoff guidance
These are plugin **skills**, addressed as `plugin-name:skill-name`. The bare `/design-critique` form also resolves as an alias. The plugin README's `/critique` shorthand does not match the live skill name and should not be relied on. Note also that none of these accept a generic web URL — a Claude Design artifact lives behind `claude.ai` authentication with no stable public address (`https://support.claude.com/en/articles/9547008-publishing-and-sharing-artifacts`), so the input is an exported file or a screenshot.
Sources: `https://claude.com/plugins/design` and `https://github.com/anthropics/knowledge-work-plugins`.
The plugin is Apache 2.0, free, and maintained by Anthropic. There is no commercial trade-off; it is the canonical downstream tool.
### Phase 9 is the coached path into `design:critique`
Recommending the tool is the minimum. When the operator hits information-architecture, structural or copy problems that surface aesthetics cannot fix, the canonical path is **Phase 9 — critique-iterate**, documented in `references/05-critique-iterate.md`. Phase 9 walks four sub-phases: coach the export and the critique run (9a), consume the pasted output as untrusted reference data (9b), synthesize a re-prompt aimed at the one prompt layer that produced the problem (9c), and decide whether to loop or exit (9d). Each preset carries its own `Critique-iterate hint` block naming which critique sections dominate for that artifact type and where those findings route.
Phase 9 **routes to** `design:critique`; it never reimplements it. The critique is run by the operator in their own session, and the result is carried back by hand — Claude Code documents no mechanism for one skill to invoke another plugin's surface, so operator-as-bridge is the intended seam rather than a workaround. The scope fence in Section 4 is unaffected: this plugin still ships none of the six forbidden command names.
---
## 6. Token cost trap — bundle all screens in one export