Skip to content

v1.0.8 — 4 Skill-doc fixes from v1.0.7 runtime-smoke retro

Choose a tag to compare

View all tags
@NeoGolightly NeoGolightly released this 27 Apr 21:25
· 3 commits to main since this release
v1.0.8
cdc9a1f

Doc-only Snapshot hot-fix wave addressing 4 of 15 items surfaced in the v1.0.7 runtime-smoke retro. 11 items deferred to v1.8.0 Item 3 (Synthesis-as-Code wave).

No @formtrieb/cdf-core / @formtrieb/cdf-mcp version bumps. .mcp.json caret-pin unchanged (^1.7.2).

R1 pre-ship probe corrected the plan's namespace assumption

Plan-as-drafted proposed mcp__cdf-mcp__<tool> for Bucket A's batch-ToolSearch tip. R1 ToolSearch probe in implementor session revealed that namespace does NOT exist for either install path — plugin-installed users see mcp__plugin_cdf_cdf-mcp__<tool> (where plugin_cdf derives from plugin-name cdf per Claude Code's mcp__plugin_<plugin>_<server>__<tool> convention), and direct-.mcp.json users see whatever local server-name they configured. Plan was updated in-flight to plugin-form before any Skill edits — preserves retro audit-trail honesty. Without R1, v1.0.8 would have shipped a still-broken selector and re-fired retro item 8.

Buckets

  • A (retro item 8) — cdf-profile-snapshot/SKILL.md §0 + cdf-profile-scaffold/SKILL.md §0 batch-ToolSearch tip: replaced bare-slug select:cdf_fetch_figma_file,… v1.0.7-shipped string with plugin-namespaced select:mcp__plugin_cdf_cdf-mcp__cdf_fetch_figma_file,… (8 selectors: 4× cdf-mcp + 2× figma + AskUserQuestion + TodoWrite). Explanatory paragraph covers (a) why namespace prefix is mandatory, (b) lazy-discovery first-MCP-call caveat, (c) substitution rule for direct-.mcp.json users (mcp__<your-server-name>__<tool>).
  • B (retro item 7) — synthesis.md Contract 4 Path 3 refined into Sub-Path 3a (preferred — Desktop bridge reachable, single figma_get_variables(format=summary) call) and Sub-Path 3b (fallback — Desktop bridge unreachable, sparse figma__get_variable_defs(nodeId) sampling, 3–5 calls). 3b mandates tool_survey: honesty annotation + explicit blind-spot naming partial-coverage estimate.
  • C (retro item 10) — cdf-profile-snapshot/SKILL.md §1 wall-time replaced unqualified "5–10 min" promise with DS-size scaling table (<50 / 50-100 / 100-200 / >200 sets → 5 / 10 / 15 / 20+ min). >200-set DSes redirected to cdf-profile-scaffold directly.
  • D (retro item 12) — shared/cdf-source-discovery/source-discovery.md §6 added "Filename prefix normalization" rule: metadata.ds_name lowercased + ASCII-only, non-alphanumeric → _. Examples: Material 3 → material_3, MyCo-Brand → myco_brand, acme.io → acme_io.

Deferred to v1.8.0 Item 3

Eleven retro items (1, 2, 3, 4, 5, 6, 9, 11, 13, 14, 15) cover larger architectural changes (walker-drift bridges merge, token_regime field, libraries.linked B5, vocab-collisions MCP, polymorphic-detect MCP, --lint mode, synthesis cheatsheet/restructure, inventory.pages info-loss, tool-discovery latency, axis_count semantic, config schema-drift validator).

Install / Update

claude plugin update cdf@cdf

Plan: docs/plans/done/2026-04-28-v1.0.8-hot-fix.md (private monorepo)
Source retro: docs/plans/done/2026-04-28-v1.0.7-runtime-smoke-retro.md (private monorepo)

Assets 2
Loading