Docs pass for Wave 2. README now documents nine phases rather than eight,
carries a Phase 9 row in the phase table and a Phase 9 paragraph in the
slides walkthrough, lists 05-critique-iterate.md among the foundation
references (6, not 5; 14 reference files, not 13), and uses the namespaced
design:critique / design:accessibility / design:handoff tokens the live
plugin actually exposes.
Two stale claims corrected, both measured 2026-08-18:
- Assertion (i) was described as a recursive grep that excludes the local
files by name. Since 3696b8e it is a per-file grep over a git-derived
shipped set (git check-ignore), so no name list exists to maintain.
- Marketplace context claimed this plugin has no separate git repository and
no separate remote. git rev-parse --show-toplevel resolves to the plugin
directory, origin is open/claude-design.git, and the sibling catalog/ is a
separate repository. The docs-triple rule is narrowed accordingly: the
catalog README is updated in the catalog repository at release time, never
from here.
Also fixes a mis-numbered layer list in the README walkthrough, which named
start-simple as Layer 2 and the AI-slop avoid-list as Layer 4. The real
numbering in 01-prompt-fundamentals.md is Layer 1, 1.5, 2a, 2b, 3, 4, 5.
No version bump, no tag, no CHANGELOG entry — Step 9 owns those.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NaybqQwqirrNmikJsUrbDg
Flat H2-only list, placed after the intro paragraph before Install.
Anchors machine-validated against actual headings (16/16 match,
zero dead links); a deliberately broken anchor confirmed the check
fires before trusting the clean run.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018mi5sCfmJKdePnSZ6dKUDo
Two judgement findings from the repo-standard skill that its script cannot
measure, both on the presentation surface:
- Verification named the whole-suite command but not the fact that nothing
runs it automatically. The skill treats a stated single command plus that
admission as the honest substitute for a CI badge; this repo has no CI
config of any kind, so say so.
- The Changelog section sent a public reader to `REMEMBER.md` for the v1.0
readiness criteria. That file is gitignored, is not present, and is a
retired local-continuity mechanism — so the pointer resolved to nothing
for every reader. The criteria were already inline in the same sentence;
keep them and drop the pointer.
Gate: repo-standard v0.2.0 reports OK, 14/14, no SKIP.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B4DrFX1ubxrmswAH3rwSeN
repo-standard v0.2.0 flagged BADGE-COUNT (WARN): 7 badges is past the
measured inflection of 5, where a badge row reads as clutter rather than
evidence (Trockman et al., ICSE 2018).
Dropped the two zero-count lightgrey badges (hooks-0, commands-0) — a
reader takes no action on them, and README:190 already states the plugin
ships no commands, agents, hooks or MCP servers. Kept version, platform,
skills-1, references-13 and license; the catalog version gate reads the
skills and references badges as its source of truth, so those stay.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B4DrFX1ubxrmswAH3rwSeN
Run the repo-standard gate (plugin class) and fix every ERROR:
- README opening line now matches the forge description verbatim, so
description == catalog == README is machine-checkable
- H1 `# claude-design` matches the repo name (was a title-cased drift)
- `## Installation` -> `## Install`, moved onto the first screen, with the
single-argument `claude plugin marketplace add <https-url>` form used by
every other plugin in the org (the two-argument form pointed the gate at
the marketplace name instead of its URL)
- `## What this plugin is NOT` -> `## Non-goals`
- `## Recent versions` -> `## Changelog`, deduplicated the release-history link
- AI-disclosure link pointed at `../../README.md`, dead since the polyrepo
split, and at an anchor the catalog README no longer carries -> GOVERNANCE.md
- Stale monorepo path `plugins/claude-design/verify.sh` -> `verify.sh` in
README and .coverage.md
Gate: 13/13 pass, 0 ERROR, 0 WARN, 0 SKIP. verify.sh unchanged at 39 pass /
1 pre-existing fail (validate-plugin.sh flags the gitignored STATE.md).
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01B4DrFX1ubxrmswAH3rwSeN
Add three sections to bring README depth closer to marketplace standard
(was 206 lines, smallest in marketplace; now 298):
- "Why this exists" — names the convergent-middle-ground problem in Claude
Design, cites Anthropic's frontend-aesthetics cookbook as primary source,
explains the five-layer prompt scaffold and the plugin's interactive role
- "Workflow example: from idea to prompt" — realistic 8-phase walkthrough
against the slides preset (Q1 results all-hands deck), including a ~30-line
sample prompt block showing what Phase 6 actually delivers
- "Recent versions" — v0.1.0 summary + CHANGELOG.md pointer + v1.0
readiness criteria pointer to REMEMBER.md
No feature changes; pure docs polish. verify.sh passes 41/0/1 (the 1 warn
is the expected SC1 dogfood-missing advisory until operator runs first
real Claude Design session).
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
CLAUDE.md and README.md previously named the forbidden tokens
literally when describing the validate-plugin.sh assertion (i) and
test-sc3-citations.sh negative grep. The recursive scans then flagged
the documentation itself as a leak. Rewords both descriptions to
describe the policy without using the banned literals.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
