sheleg-design-skill 1.60.2 → 1.61.0

package/CHANGELOG.md

@@ -1,3 +1,25 @@
+## 1.61.0 — 17 KB of doctrine no agent could load
+
+`LAYOUT_CRAFT.md`, `TYPE_CRAFT.md`, `KNOWLEDGE_PROVENANCE.md` and `VISUAL_REVIEW.md`
+shipped in the bundle from `381d2f9`, carried their own regressions in
+`test/audit_regressions/`, and were named by **no document an agent ever opens**.
+`git log -S` on SKILL.md is empty: they were never linked. Four files, 17,001 bytes,
+reachable only by listing the directory.
+
+The auditor's `BUNDLE_UNREACHABLE` could not see them: this skill is flat — its
+documents sit beside SKILL.md rather than under `references/` — and that is exactly the
+shape the auditor's bundle walk does not enter.
+
+- **Four load triggers in SKILL.md**, each naming when to open the file, not just that
+  it exists. Added **by displacement**: the chart paragraph moved to
+  `SURFACE_COMPOSITION.md`, which already carries the role contract in full, and the
+  mobile paragraph to the file that owns it. Body 4922 → **4748**/4750 after the
+  auditor refused four drafts.
+- **`validate_every_shipped_document_is_reachable`** closes the class: reachability is
+  transitive and closed over the bundle — SKILL.md names some, those name others, and a
+  file in neither set fails. Watched refusing the pre-change tree by name, on all four.
+  `test/floors.json` 5641 → 5773.
+
 ## 1.60.2 — the ledger section names the version it ships
 
 The previous patch wrote the ledger section BEFORE bumping the version, so the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sheleg-design-skill",
-  "version": "1.60.2",
+  "version": "1.61.0",
   "description": "Design taste as an installable agent skill. Cinematic scroll-driven landing pages built on one scroll clock and layered degrade-to-calm motion, a motion doctrine that decides whether to animate before it decides how, three calibration dials, and thirty-nine locked style packs with ready-made design tokens \u2014 instrument-console, editorial-luxury, workbench, briefing-room, atrium, orchard, outrank, babylove, patchbay, nameplate, field-notes, cyclorama, showroom, blueprint, prism, maquette, scoreboard, datasheet, manpage, pigeonhole, roster, ora, tenor, paperclip, ledger, router, daylight, notation, almanac, vitrine, proscenium, awning, bulletin, rimlight, onionskin, deskmate, test-drive, surveyor and chorus. Colour, slop and fork-reciprocity gates run as scripts, not opinions. Works with Cursor, Claude Code and any agent that reads a SKILL.md.",
   "bin": {
     "sheleg-design-skill": "bin/cli.js"

package/plugins/sheleg-design/.claude-plugin/plugin.json

@@ -3,7 +3,7 @@
   "name": "sheleg-design",
   "displayName": "SHELEG Design",
   "description": "SHELEG Design methodology: cinematic scroll-driven landing pages (single scroll clock, layered degrade-to-calm motion, WebGL particle formations), a motion doctrine that decides whether to animate before it decides how, and thirty-nine pluggable visual style packs, each with a ready-made token layer — instrument-console (near-black aerospace console; technical systems and infrastructure), editorial-luxury (cream and espresso; editorial, research, premium B2B), workbench (quiet light/dark UI; dashboards, admin, internal tools), briefing-room (dark 16:9 deck; investor and board presentations), atrium (cream daylight; consumer health and high-trust DTC), babylove (white with orange; SEO SaaS, long time-to-value, disconnected states), patchbay (black with mint-cyan; engines, buses, pipelines, OSS front doors), nameplate (cool slab with coral; press, certification and third-party trust), rimlight (white with blue light; studios, services and case studies), onionskin (white working sheet; developer and AI infrastructure), deskmate (warm beige with a dusk bleed; AI coworkers and chat-native agents), test-drive (warm paper with one coral; self-serve SaaS proven by the live product), surveyor (peach paper with teal and pink; visibility, monitoring and benchmark tools), chorus (warm paper under a crosshair grid, with a cut-corner bubble; AI-search visibility, brand monitoring and community marketing), outrank (white with violet; one brand across marketing and product), orchard (warm oat slabs; friendly biotech and wellness), field-notes (ruled green paper; auditable open-source developer tools), showroom (white gallery; product-led companies selling the app), blueprint (white technical stock; vector, storage and query infrastructure), prism (iridescent hard edge; command-first OSS infrastructure), maquette (near-black table; enterprise data infrastructure), cyclorama (looping pastel field; applied-AI consultancies), scoreboard (warm paper; growth, ads and accumulating metrics), datasheet (off-white specification; fraud, identity and device intelligence), manpage (cream manual; APIs, SDKs, CLIs and MCP servers), pigeonhole (filed white field; inbox, ticket and CRM triage), roster (faint square grid; platforms sold through who uses them), ora (warm coal; machine verdicts, audits and protocol traces), tenor (warm management paper; agent operations and autonomous back office), ledger (cream ruled console; analysts, BI and warehouse agents), paperclip (monochrome coal; orchestrators, schedulers and job runners), awning (white commerce forecourt; storefront, payroll and billing platforms), router (pale console with hairlines; dashboard, billing and inventory surfaces), daylight (bright portal with one shadow; client onboarding and service portals), notation (restrained technical hairlines; OSS, docs and developer workspaces), almanac (oatmeal editorial paper; manifestos and category-defining pages), vitrine (serif trust display; evaluated B2B, security and compliance), proscenium (white demo sequence; product tours and launch pages), bulletin (cheerful outlined bands; broad SMB and agency platforms). Ships the sheleg-design skill, the architecture reference, the motion doctrine, the Figma and Claude Design bridges, AI-surface patterns, the packs' token CSS, and the /sheleg-design command.",
-  "version": "1.60.2",
+  "version": "1.61.0",
   "author": {
     "name": "ssheleg",
     "url": "https://x.com/sshlg93"

package/plugins/sheleg-design/skills/sheleg-design/SKILL.md

@@ -4,7 +4,7 @@ description: Use when deciding how something LOOKS or MOVES — cinematic landin
 license: MIT
 compatibility: Kit/lane commands need node>=16, npx, network. Optional siblings — dataviz, shadcn, migrate-radix-to-base. Each has an in-text fallback when absent or unreachable.
 metadata:
-  version: 1.60.2
+  version: 1.61.0
 ---
 
 # SHELEG Design
@@ -196,28 +196,31 @@ decision, not a research conclusion:
 7. **Consistency** — one ease, one duration set, one accent, one atom per job
    across every screen.
 
-## Load on demand — three things the pack layer does not decide
+## Load on demand — what the pack layer does not decide
 
 - **Scene depth — six layers** ([`SURFACE_COMPOSITION.md`](./SURFACE_COMPOSITION.md)),
-  before writing CSS for a cinematic page. A scene has planes; everything on one
-  plane is the failure no amount of easing repairs.
-- **Charts — the role contract in the same file, plus the `dataviz` handoff
-  where that skill exists**, before drawing a chart in any pack. Token names are
-  not uniform across the thirty-nine packs — only `--bg` and `--ink` resolve in
-  every one — and an undefined custom property does not error, it silently falls
-  back. Guessing one is the quietest way to ship a wrong chart. A `dataviz`
-  skill is an optional neighbour this skill does not ship: where none is
-  installed, the role table in `SURFACE_COMPOSITION.md` IS the chart contract,
-  applied by hand.
-- **Mobile surfaces** ([`MOBILE_SURFACES.md`](./MOBILE_SURFACES.md)) — separate
-  the platform target (iOS/Android/RN/web, each with its own component adapter)
-  from the prototype renderer, and treat a browser HTML mockup as a
-  demonstration with a native-equivalent column, never as native proof — when the
-  brief is a native app screen or a mobile-web view — not a desktop page whose
-  only mobile concern is collapse. Five mobile rules the packs each state alone,
-  a sixth **no pack answers** (the type ramp follows viewport width, not the
-  user's text size), and the half no pack decides on a phone: platform
-  convention.
+  before writing CSS for a cinematic page. Everything on one plane is the failure
+  no easing repairs.
+- **Charts — the role contract and the `dataviz` handoff**, in the same file,
+  before drawing a chart in any pack. Token names are not uniform across the
+  packs and an undefined custom property falls back silently rather than erroring.
+- **Mobile surfaces** ([`MOBILE_SURFACES.md`](./MOBILE_SURFACES.md)) — when the
+  brief is a native app screen or a mobile-web view, not a desktop page whose only
+  mobile concern is collapse. It says to separate
+  the platform target from the prototype renderer, refuses a browser mockup as
+  native proof, and carries the sixth rule no pack answers: the type ramp follows
+  viewport width, not the user's text size.
+
+- **Layout and type craft** ([`LAYOUT_CRAFT.md`](./LAYOUT_CRAFT.md),
+  [`TYPE_CRAFT.md`](./TYPE_CRAFT.md)) — before composing a page or setting a type
+  ramp. The portable half: observed, never dialled — an uncalibrated axis is a
+  number nobody can check.
+- **Visual review** ([`VISUAL_REVIEW.md`](./VISUAL_REVIEW.md)) — before a
+  screenshot is offered as evidence. It proves what it is OF, and the wrong frame
+  is the claim this file refuses.
+- **Where the knowledge came from**
+  ([`KNOWLEDGE_PROVENANCE.md`](./KNOWLEDGE_PROVENANCE.md)) — when a rule is
+  challenged or copied.
 
 ## Setting a visual language — invariants locked, axes open