diff --git a/.agents/skills/openclaw-design-audit/SKILL.md b/.agents/skills/openclaw-design-audit/SKILL.md index 064aecbf4f..02d0d80858 100644 --- a/.agents/skills/openclaw-design-audit/SKILL.md +++ b/.agents/skills/openclaw-design-audit/SKILL.md @@ -1,6 +1,6 @@ --- name: openclaw-design-audit -description: Audit OpenClaw frontend code and rendered interfaces for design-system drift, token misuse, primitive reimplementation, accessibility problems, responsive defects, and off-brand copy. Use for design reviews, compliance checks, or scheduled audit-and-fix workflows. +description: Audit OpenClaw frontend code and rendered interfaces for Carapace drift, token misuse, primitive reimplementation, accessibility problems, responsive defects, and off-brand copy. Use for design reviews, compliance checks, or scheduled audit-and-fix workflows. --- # OpenClaw Design Audit @@ -11,10 +11,10 @@ unless a documented rule makes them violations. ## Workflow 1. Read [rubric.md](references/rubric.md) and run every applicable category. -2. Read the consumer's installed design-system version and current commit SHA. -3. Read the version-matched - [token contract](../openclaw-design-system/references/tokens.md) and - [consumer adapters](../openclaw-design-system/references/consumer-adapters.md). +2. Read the consumer's installed Carapace version and current commit SHA. +3. Read the version-matched token contract and consumer adapters from the + installed product guidance skill: `openclaw-carapace` for new installs or + the `openclaw-design-system` compatibility alias for an upgraded lock. 4. Read the brand or marketing references when those categories apply. 5. Run deterministic source checks before judgment-based review. 6. Inspect representative rendered routes at desktop and mobile sizes. @@ -31,7 +31,7 @@ Each finding must include: - category and severity - stable rule ID - concise remediation -- design-system reference +- Carapace reference - whether the finding is mechanical or judgment-based ## Curation diff --git a/.agents/skills/openclaw-design-audit/references/fix-policy.md b/.agents/skills/openclaw-design-audit/references/fix-policy.md index 6e1a4fcc13..3c9c775a76 100644 --- a/.agents/skills/openclaw-design-audit/references/fix-policy.md +++ b/.agents/skills/openclaw-design-audit/references/fix-policy.md @@ -10,7 +10,7 @@ deterministic, and covered by an existing rule. - use an established local primitive instead of a duplicate raw control - add a missing accessible label when intent is unambiguous - repair clipping or overflow without changing information architecture -- update the pinned design-system tag in a dedicated dependency change +- update the pinned Carapace tag in a dedicated dependency change ## Requires Human Review diff --git a/.agents/skills/openclaw-design-audit/references/github-pr-delivery.md b/.agents/skills/openclaw-design-audit/references/github-pr-delivery.md index 0bb1091f12..3ffc044c93 100644 --- a/.agents/skills/openclaw-design-audit/references/github-pr-delivery.md +++ b/.agents/skills/openclaw-design-audit/references/github-pr-delivery.md @@ -4,7 +4,7 @@ The scheduled ClawHub audit opens a pull request directly against `openclaw/clawhub`. It does not create or update a tracker issue. The schedule and credentials live in the consumer repository's GitHub Actions -workflow. This design-system skill defines the audit and delivery contract; it +workflow. This Carapace skill defines the audit and delivery contract; it does not schedule itself. ## Branch And Scope @@ -18,7 +18,7 @@ does not schedule itself. 1. Checkout `openclaw/clawhub` with full history and fetch remote `main`. 2. Reset only the dedicated automation branch to `origin/main`. -3. Install the design system at the workflow's pinned Git tag. +3. Install Carapace at the workflow's pinned Git tag. 4. Run source checks, browser checks, and report generation. 5. Apply only fixes allowed by `fix-policy.md`. 6. Write reports under the consumer's established audit-artifact path. @@ -32,7 +32,7 @@ does not schedule itself. The title must identify the audit and date. The body includes: -- design-system version +- Carapace version - audited ClawHub SHA - count by severity - commands and routes checked diff --git a/.agents/skills/openclaw-design-audit/references/report-format.md b/.agents/skills/openclaw-design-audit/references/report-format.md index 225a179387..ce255ea5e9 100644 --- a/.agents/skills/openclaw-design-audit/references/report-format.md +++ b/.agents/skills/openclaw-design-audit/references/report-format.md @@ -6,7 +6,9 @@ Produce both `design-audit.json` and `design-audit.md`. ```json { - "designSystemVersion": "v0.0.1", + "schemaVersion": 2, + "carapaceVersion": "v0.1.0", + "designSystemVersion": "v0.1.0", "consumerSha": "", "summary": { "errors": 0, @@ -22,12 +24,16 @@ Produce both `design-audit.json` and `design-audit.md`. "line": 12, "message": "Use the semantic accent token.", "remediation": "Replace the raw coral value with var(--oc-accent-primary).", - "reference": "openclaw-design-system/references/tokens.md" + "reference": "openclaw-carapace/references/tokens.md" } ] } ``` +During the `v0.1.x` migration, emit both version fields with the same value. +`designSystemVersion` is retained for existing parsers; new consumers should +read `carapaceVersion`. + Sort findings by severity, rule ID, file, then line. Keep stable IDs so recurring automation can compare runs. @@ -35,7 +41,7 @@ automation can compare runs. Include: -1. audited design-system version and consumer SHA +1. audited Carapace version and consumer SHA 2. validation commands and rendered routes 3. count by severity 4. every error diff --git a/.agents/skills/openclaw-design-system/SKILL.md b/.agents/skills/openclaw-design-system/SKILL.md index 2b6677e6c8..3afda69dcd 100644 --- a/.agents/skills/openclaw-design-system/SKILL.md +++ b/.agents/skills/openclaw-design-system/SKILL.md @@ -1,12 +1,19 @@ --- name: openclaw-design-system -description: Build or modify OpenClaw application UI using canonical semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives. Use for product interfaces, component styling, theme work, or design-token integration. +description: Compatibility alias for existing OpenClaw installations that now applies Carapace semantic tokens, themes, shared CSS foundations, consumer adapters, and established local primitives. --- -# OpenClaw Design System +# Carapace Compatibility Alias + +This skill identifier remains available for existing `skills-lock.json` +entries during the `v0.1.x` migration. New installations should use +`openclaw-carapace`. Use the shared package for foundations and framework-neutral visual primitives. Keep consumer-specific behavior, data, routes, and layout composition local. +Before changing imports, inspect the consumer manifest: use +`@openclaw/carapace` when it is installed, otherwise preserve the legacy +`@openclaw/design-system` specifier until the dependency is migrated. ## Workflow diff --git a/.agents/skills/openclaw-design-system/references/consumer-adapters.md b/.agents/skills/openclaw-design-system/references/consumer-adapters.md index bfa8ac0b03..5cd76d65c3 100644 --- a/.agents/skills/openclaw-design-system/references/consumer-adapters.md +++ b/.agents/skills/openclaw-design-system/references/consumer-adapters.md @@ -1,5 +1,10 @@ # Consumer Adapters +This compatibility reference uses the legacy `@openclaw/design-system` +specifier so consumers pinned to `v0.0.1` keep building. If the consumer +manifest already installs `@openclaw/carapace`, use that package name for the +same exported paths. + ## Plain CSS And Astro Use the complete contract when the global reset is desired: diff --git a/.agents/skills/openclaw-design-system/references/tokens.md b/.agents/skills/openclaw-design-system/references/tokens.md index 32303f2256..20263ce99f 100644 --- a/.agents/skills/openclaw-design-system/references/tokens.md +++ b/.agents/skills/openclaw-design-system/references/tokens.md @@ -1,7 +1,9 @@ # Token Contract Import `@openclaw/design-system` for the complete foundation or use focused -exports when the consumer must control reset and adapter order. +exports when the consumer must control reset and adapter order. This legacy +specifier is intentional for consumers that have not migrated their dependency +to `@openclaw/carapace`. ## Layers @@ -19,13 +21,16 @@ exports when the consumer must control reset and adapter order. - Page background: `--oc-bg-page` - Ordinary surface: `--oc-bg-surface` - Elevated surface: `--oc-bg-elevated` -- Primary, secondary, muted text: `--oc-text-primary`, - `--oc-text-secondary`, `--oc-text-muted` +- Inset and inverted surfaces: `--oc-bg-recessed`, `--oc-bg-contrast` +- Primary, secondary, muted, inactive, inverse, and link text: + `--oc-text-primary`, `--oc-text-secondary`, `--oc-text-muted`, + `--oc-text-inactive`, `--oc-text-inverse`, `--oc-text-link` - Primary action: `--oc-accent-primary`; hover: `--oc-accent-primary-hover` - Secondary accent: `--oc-accent-secondary` -- Subtle and accent borders: `--oc-border-subtle`, - `--oc-border-accent` +- Neutral control backgrounds: `--oc-control-bg`, `--oc-control-bg-hover` +- Subtle, strong, and accent borders: `--oc-border-subtle`, + `--oc-border-strong`, `--oc-border-accent` - Focus: `--oc-focus-ring` Use `color-mix()` from semantic variables for a local translucent state. Add a diff --git a/.agents/skills/openclaw-design/SKILL.md b/.agents/skills/openclaw-design/SKILL.md index 297853a032..fff961d5f0 100644 --- a/.agents/skills/openclaw-design/SKILL.md +++ b/.agents/skills/openclaw-design/SKILL.md @@ -1,6 +1,6 @@ --- name: openclaw-design -description: Route OpenClaw design work to the canonical brand, product design-system, marketing-page, or design-audit guidance. Use when a task touches OpenClaw visual identity, shared CSS tokens, product UI, public web pages, or design-system compliance. +description: Route OpenClaw design work to canonical brand, Carapace product-interface, marketing-page, or design-audit guidance. Use when a task touches OpenClaw visual identity, shared CSS tokens, product UI, public web pages, or Carapace compliance. --- # OpenClaw Design @@ -11,13 +11,16 @@ only when the task genuinely crosses them. | Skill | Use for | | --- | --- | | `openclaw-brand` | Identity decisions, typography, logos, imagery, voice, and non-product brand artifacts | -| `openclaw-design-system` | Application UI, semantic tokens, themes, component reuse, and framework adapters | +| `openclaw-carapace` | Application UI, semantic tokens, themes, component reuse, and framework adapters | +| `openclaw-design-system` | Compatibility alias for projects upgrading an existing skill lock | | `openclaw-marketing-pages` | Public-page composition, landing/content pages, navigation, SEO, and responsive layout | | `openclaw-design-audit` | Design drift, token misuse, component substitution, accessibility, and recurring audits | For a public website change, start with `openclaw-marketing-pages` and add `openclaw-brand` only when the task changes identity, logo, imagery, typography, -or voice. For a product application, start with `openclaw-design-system`. +or voice. For a product application, start with `openclaw-carapace` when it is +installed. Projects upgrading an existing lock may use +`openclaw-design-system` as the `v0.1.x` compatibility alias. ## Shared Contract diff --git a/skills-lock.json b/skills-lock.json index 07ca388328..12438bc4fc 100644 --- a/skills-lock.json +++ b/skills-lock.json @@ -11,19 +11,19 @@ "source": "openclaw/design-system", "sourceType": "github", "skillPath": "openclaw-design/SKILL.md", - "computedHash": "096be7d1e5e65e62b7de5b96e3897b6ac3a1f45686ee5599dfcbaeaeb607b4ec" + "computedHash": "4a9004e762b08f6c9fc836de7b4db26fc27e7b9a90342884047bbffa51c21732" }, "openclaw-design-audit": { "source": "openclaw/design-system", "sourceType": "github", "skillPath": "openclaw-design-audit/SKILL.md", - "computedHash": "12fec90fd4aa1aa569de1beb5a3c85d06887a5e548704dbd094355edc0f52ad3" + "computedHash": "aff7655c532d67205301590f76d8655a42f36d14fbd1960d4e4b9b8149291aa3" }, "openclaw-design-system": { "source": "openclaw/design-system", "sourceType": "github", "skillPath": "openclaw-design-system/SKILL.md", - "computedHash": "475604f08f37186237fa62605fbfe16ea04367af81f4c3a8c59bcb395ae70cca" + "computedHash": "6d94e825c58fc5650a532e4ed8bc96208ede8a166089598d1924393cc46f3275" }, "openclaw-marketing-pages": { "source": "openclaw/design-system",