figura-cli 0.16.1 → 0.17.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "figura-cli",
-  "version": "0.16.1",
+  "version": "0.17.0",
   "description": "Command-line client for the Figura visualization SaaS",
   "license": "MIT",
   "type": "module",

package/skills/fig/SKILL.md

@@ -2,7 +2,7 @@
 name: fig
 description: "Mock up a screen as an on-brand, shareable HTML fig via your Figura team — render a UI state in seconds before writing the real code. Use when asked to visualize a screen, mock a UI, or 'make a fig'. iPhone-framed by default; browser frame for web/desktop."
 argument-hint: '<what to visualize>'
-allowed-tools: 'mcp__figura__figura_whoami, mcp__figura__figura_generate_fig, mcp__figura__figura_create_fig, mcp__figura__figura_revise_fig, mcp__figura__figura_publish_fig, mcp__figura__figura_commit_fig, Bash(figura *), Bash(bunx figura-cli *)'
+allowed-tools: 'mcp__figura__figura_whoami, mcp__figura__figura_fig_scaffold, mcp__figura__figura_generate_fig, mcp__figura__figura_create_fig, mcp__figura__figura_revise_fig, mcp__figura__figura_publish_fig, mcp__figura__figura_commit_fig, Bash(figura *), Bash(bunx figura-cli *)'
 ---
 
 # /fig — figure it out before you build it
@@ -102,16 +102,26 @@ so you hand it the studied structure in the brief (see step 3, "Server render").
      re-verify. If the response has no `binding` field (older CLI/MCP), confirm
      the team slug matches this project with the user before proceeding.
 
-2. **Default — build it yourself, with YOUR Claude.** Fetch the team's design
-   system — `bunx figura-cli brand --json` — and hand-build the fig's HTML against
-   it, then land it with **`figura_create_fig`**, setting
-   `area`, `orientation` (`portrait` / `landscape` / `both`), `mode` (`single` /
-   `compare` / `variations` — default to `compare` when Existing-first turned up a
-   baseline), `title`, and a real description. This uses the
-   caller's own Claude (the model running this skill) — no extra cost, full control
-   for precise broken-vs-proposed diptychs — and applies the team's brand from the
-   fetched design system. **Follow that design system verbatim; never invent brand
-   values.**
+2. **Default — build it yourself, with YOUR Claude.** Fetch the **canonical
+   authoring scaffold** — **`figura_fig_scaffold`** (CLI:
+   `bunx figura-cli fig scaffold --platform <mobile|web> [--device <id>] [--area <str>]`)
+   — and hand-build the fig's HTML against it, then land it with
+   **`figura_create_fig`**, setting `area`, `orientation` (`portrait` /
+   `landscape` / `both`), `mode` (`single` / `compare` / `variations` — default
+   to `compare` when Existing-first turned up a baseline), `title`, and a real
+   description. This uses the caller's own Claude (the model running this skill)
+   — no extra cost, full control for precise broken-vs-proposed diptychs.
+
+   The scaffold IS the source of truth: it's the **exact system prompt Figura
+   injects when it renders a fig server-side** — the design rules, exemplars,
+   accent hints, your team's composed brand, and the component/device kit
+   context, all in one. Follow it verbatim; never invent brand values or restate
+   design rules from memory. Match `--platform` to the target (a web fig's
+   scaffold composes the team's *web* brand surface, a mobile fig's the *mobile*
+   one). **Fallback if the scaffold fetch fails** (older engine/CLI, or the
+   `figura_fig_scaffold` tool is unavailable): fetch just the brand with
+   `bunx figura-cli brand --json` and author against that — the scaffold is the
+   preferred path, the raw brand is the degraded one.
 
    **Landing IS hosting — leave `publish` and `commit` unset.** Creating a fig
    always persists it to Figura (there is no separate "save it for real" step);
@@ -332,8 +342,9 @@ So when you **hand-build** a fig (the default path), do your part of the contrac
 - **MCP unavailable** (headless / cron, or no interactive auth): fall back to the
   CLI — `bunx figura-cli fig create` / `fig publish`, with `fig revise` /
   `fig revisions` for versions, `fig commit` / `fig uncommit` (or `--commit` on
-  the final create/revise) for the team library, and
-  `bunx figura-cli brand --json` for the brand.
+  the final create/revise) for the team library, `bunx figura-cli fig scaffold`
+  for the authoring scaffold, and `bunx figura-cli brand --json` for the raw
+  brand (the scaffold's fallback).
 - **`figura_create_fig`/`figura_revise_fig` itself fails** (no network, API down,
   auth expired): the fig never entered Figura, so there is no `id`/`viewUrl` to
   open. Only THEN write the HTML to a local scratch file (project-scoped —