@lifeaitools/rdc-skills 0.24.38 → 0.24.41

package/skills/design/reference/studio-model.md

@@ -1,153 +1,153 @@
-# Studio Model for RDC Design
-
-Studio is the token authority and live website editor for LIFEAI brands. It is not a page builder. The design skill must work with Studio's real routes, APIs, token tables, and editor/debug model.
-
-## Required Source Docs
-
-Read these before Studio design work:
-
-- `docs/systems/studio/ARCHITECTURE.md`
-- `apps/studio/CLAUDE.md`
-- `.claude/context/design-system-global.md`
-
-## Runtime Locations
-
-- local Studio: `http://localhost:3011`
-- staging Studio: `https://staged.studio.regendevcorp.com`
-- production Studio: `https://studio.regendevcorp.com`
-
-## Brand Pages
-
-- `/brands`
-- `/brands/new`
-- `/brands/[id]/colors`
-- `/brands/[id]/typography`
-- `/brands/[id]/spacing`
-- `/brands/[id]/diff`
-- `/brands/[id]/book`
-- `/brands/[id]/voice`
-- `/brands/[id]/assets`
-- `/brands/[id]/export`
-- `/brands/[id]/table-styles`
-
-## Editor Routes
-
-- `/editor`
-- `/editor/local/[brandSlug]`
-- `/editor/local-test-target`
-- legacy `/editor/[brandSlug]` may redirect to local editor unless `?legacy=1`
-
-Read local debug docs:
-
-- `docs/systems/studio/local-debug-agent.md`
-
-Clauth relay route families:
-
-- `/studio/debug/*`
-- `/studio/claude/*`
-
-## Native Local Debug Model
-
-Studio live editing must use the RDC-owned local debug system, not an external live-edit runtime:
-
-1. Studio starts a local session with `POST /studio/debug/start`.
-2. Studio embeds the returned local `devUrl` with debug query params.
-3. `/api/editor/local-debug` injects Studio's own `local-debug-browser.js` picker.
-4. Browser/user events go to `/studio/debug/:sessionId/events`.
-5. Claude Code polls `/studio/claude/:sessionId/poll` with `scripts/studio-debug-poll.mjs`.
-6. Claude edits source files directly and replies to `/studio/claude/:sessionId/reply`.
-7. HMR updates the iframe.
-
-The disposable proof target is:
-
-- `/editor/local/test`
-- `apps/studio/src/app/editor/local-test-target/page.tsx`
-
-Direct edits must make exactly one source edit unless impossible. Variant edits should return alternatives without editing unless explicitly instructed to apply one. Reference replacement requires an explicit reference. Notes must not edit source.
-
-## Token APIs
-
-- `GET /api/public/tokens/[slug]` returns legacy public token payload and CSS variables.
-- `GET /api/v2/tokens/[slug]` returns DTCG/M3 token JSON.
-- `GET /api/v2/tokens/[slug]/css` returns shadcn-compatible CSS vars.
-
-Palette APIs currently start here:
-
-- `apps/studio/src/app/api/palettes/route.ts`
-- `apps/studio/src/app/api/palettes/apply/route.ts`
-
-## Canonical Tables
-
-Current token and theme work should prefer v2 where available:
-
-- `global_design_tokens_v2`
-- `brand_token_overrides_v2`
-- `brand_semantic_tokens`
-- `brand_components`
-- `brand_patterns`
-- `token_inheritance_audit`
-
-Legacy/current website token tables:
-
-- `brand_token_overrides`
-- `brand_font_assignments`
-- `brand_fonts`
-
-Legacy read-only or migration tables:
-
-- `global_design_tokens`
-- `brand_colors`
-- `brand_typography`
-- `brand_spacing`
-
-Docs/narrative:
-
-- `brand_design_docs`
-
-Registry/hierarchy:
-
-- `brand_entities`
-- `org_entities`
-
-## Key Files
-
-- `apps/studio/src/contexts/BrandStudioContext.tsx`
-- `apps/studio/src/lib/token-resolver.ts`
-- `apps/studio/src/lib/token-resolver-v2.ts`
-- `apps/studio/src/lib/token-export.ts`
-- `packages/design-tokens/src/types.ts`
-- `packages/ui/src/components/WebsiteLayout.tsx`
-- `packages/ui/src/styles/website-base.css`
-
-## BrandStudioContext
-
-Child pages under `/brands/[id]/*` should use `useBrandStudio()` instead of re-fetching tokens. It provides:
-
-- `brand`
-- `resolved`
-- `setResolved`
-- `globals`
-- `overrides`
-- `loaded`
-
-## Token Rules
-
-- Use Studio tokens for every production design decision.
-- Never invent a brand slug. Query `brand_entities`.
-- Never modify locked governance tokens without an explicit governance decision.
-- Missing token protocol: create a work item, use closest existing token temporarily, and mark the gap.
-- Production code should use `var(--color-*)` or resolved Studio token output.
-
-## Palette Designer Boundary
-
-The forked Palette Designer is a separate tool. Studio should launch it only when installed/enabled/healthy. It should load and save through Palette Library APIs, then Studio should reflect saved palettes.
-
-Do not rebuild Palette Designer inside the colors page in the first pass.
-
-## Deprecated Routes
-
-Do not extend:
-
-- `/api/editor/render`
-- `/api/layout/scan` unless maintaining legacy scanner behavior
-- `/api/layout/sync`
+# Studio Model for RDC Design
+
+Studio is the token authority and live website editor for LIFEAI brands. It is not a page builder. The design skill must work with Studio's real routes, APIs, token tables, and editor/debug model.
+
+## Required Source Docs
+
+Read these before Studio design work:
+
+- `docs/systems/studio/ARCHITECTURE.md`
+- `apps/studio/CLAUDE.md`
+- `.claude/context/design-system-global.md`
+
+## Runtime Locations
+
+- local Studio: `http://localhost:3011`
+- staging Studio: `https://staged.studio.regendevcorp.com`
+- production Studio: `https://studio.regendevcorp.com`
+
+## Brand Pages
+
+- `/brands`
+- `/brands/new`
+- `/brands/[id]/colors`
+- `/brands/[id]/typography`
+- `/brands/[id]/spacing`
+- `/brands/[id]/diff`
+- `/brands/[id]/book`
+- `/brands/[id]/voice`
+- `/brands/[id]/assets`
+- `/brands/[id]/export`
+- `/brands/[id]/table-styles`
+
+## Editor Routes
+
+- `/editor`
+- `/editor/local/[brandSlug]`
+- `/editor/local-test-target`
+- legacy `/editor/[brandSlug]` may redirect to local editor unless `?legacy=1`
+
+Read local debug docs:
+
+- `docs/systems/studio/local-debug-agent.md`
+
+Clauth relay route families:
+
+- `/studio/debug/*`
+- `/studio/claude/*`
+
+## Native Local Debug Model
+
+Studio live editing must use the RDC-owned local debug system, not an external live-edit runtime:
+
+1. Studio starts a local session with `POST /studio/debug/start`.
+2. Studio embeds the returned local `devUrl` with debug query params.
+3. `/api/editor/local-debug` injects Studio's own `local-debug-browser.js` picker.
+4. Browser/user events go to `/studio/debug/:sessionId/events`.
+5. Claude Code polls `/studio/claude/:sessionId/poll` with `scripts/studio-debug-poll.mjs`.
+6. Claude edits source files directly and replies to `/studio/claude/:sessionId/reply`.
+7. HMR updates the iframe.
+
+The disposable proof target is:
+
+- `/editor/local/test`
+- `apps/studio/src/app/editor/local-test-target/page.tsx`
+
+Direct edits must make exactly one source edit unless impossible. Variant edits should return alternatives without editing unless explicitly instructed to apply one. Reference replacement requires an explicit reference. Notes must not edit source.
+
+## Token APIs
+
+- `GET /api/public/tokens/[slug]` returns legacy public token payload and CSS variables.
+- `GET /api/v2/tokens/[slug]` returns DTCG/M3 token JSON.
+- `GET /api/v2/tokens/[slug]/css` returns shadcn-compatible CSS vars.
+
+Palette APIs currently start here:
+
+- `apps/studio/src/app/api/palettes/route.ts`
+- `apps/studio/src/app/api/palettes/apply/route.ts`
+
+## Canonical Tables
+
+Current token and theme work should prefer v2 where available:
+
+- `global_design_tokens_v2`
+- `brand_token_overrides_v2`
+- `brand_semantic_tokens`
+- `brand_components`
+- `brand_patterns`
+- `token_inheritance_audit`
+
+Legacy/current website token tables:
+
+- `brand_token_overrides`
+- `brand_font_assignments`
+- `brand_fonts`
+
+Legacy read-only or migration tables:
+
+- `global_design_tokens`
+- `brand_colors`
+- `brand_typography`
+- `brand_spacing`
+
+Docs/narrative:
+
+- `brand_design_docs`
+
+Registry/hierarchy:
+
+- `brand_entities`
+- `org_entities`
+
+## Key Files
+
+- `apps/studio/src/contexts/BrandStudioContext.tsx`
+- `apps/studio/src/lib/token-resolver.ts`
+- `apps/studio/src/lib/token-resolver-v2.ts`
+- `apps/studio/src/lib/token-export.ts`
+- `packages/design-tokens/src/types.ts`
+- `packages/ui/src/components/WebsiteLayout.tsx`
+- `packages/ui/src/styles/website-base.css`
+
+## BrandStudioContext
+
+Child pages under `/brands/[id]/*` should use `useBrandStudio()` instead of re-fetching tokens. It provides:
+
+- `brand`
+- `resolved`
+- `setResolved`
+- `globals`
+- `overrides`
+- `loaded`
+
+## Token Rules
+
+- Use Studio tokens for every production design decision.
+- Never invent a brand slug. Query `brand_entities`.
+- Never modify locked governance tokens without an explicit governance decision.
+- Missing token protocol: create a work item, use closest existing token temporarily, and mark the gap.
+- Production code should use `var(--color-*)` or resolved Studio token output.
+
+## Palette Designer Boundary
+
+The forked Palette Designer is a separate tool. Studio should launch it only when installed/enabled/healthy. It should load and save through Palette Library APIs, then Studio should reflect saved palettes.
+
+Do not rebuild Palette Designer inside the colors page in the first pass.
+
+## Deprecated Routes
+
+Do not extend:
+
+- `/api/editor/render`
+- `/api/layout/scan` unless maintaining legacy scanner behavior
+- `/api/layout/sync`

package/skills/edit/SKILL.md

@@ -1,98 +1,98 @@
----
-name: rdc:edit
-description: "Usage `rdc:edit <site|brand|route|file>` — open the local website editor host for a target site, brand, route, or file. Resolves the target, launches or reuses the local editor host on port 3015, and opens the target in the browser when not under `RDC_TEST=1`."
----
-
-> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
-> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
-> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
-
-> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
-
-> **Sandbox contract:** This skill honors `RDC_TEST=1`. Under test, do not steal focus or rely on foreground-only browser automation; report the resolved editor URL instead.
-
-
-# rdc:edit — Local Website Editor Launcher
-
-## When to Use
-- The user wants to open a site, brand, route, or file in the local editor app
-- The user says "open this in the editor" or asks for the editor-host workflow
-- The target should be loaded in `@regen/editor-host` rather than Studio
-
-## Arguments
-- `rdc:edit <site|brand|route|file>` — resolve the target and open it in the local editor host
-
-## Procedure
-
-### 1. Read the local editor contract
-- Read `apps/editor/CLAUDE.md` before launching anything.
-- If the target is Studio-specific, prefer `rdc:design edit <target>` instead.
-
-### 2. Resolve the target
-- For known LIFEAI brand targets, map to the obvious brand/app pair first.
-- `prtrust.fund` and `dev.prtrust.fund` resolve to `brandSlug=prt` and `appSlug=prt`.
-- `test`, `studio_test`, and `studio-test` resolve to `brandSlug=test` and `appSlug=studio_test`.
-- If the target is a local file or route and the brand/app is unclear, ask one concise question.
-
-Resolve the **target dev server** (package + port) so the preview iframe has
-something live to load. Read the brand app's `package.json` `name` and its
-`dev` script port — never hard-code a stale port:
-
-| Target | App dir | Package (`name`) | Dev port | `targetUrl` |
-|--------|---------|------------------|----------|-------------|
-| `prt` / `prtrust.fund` | `apps/prt` | `@regen/prt-portal` | `3006` | `http://localhost:3006` |
-| `test` / `studio_test` | (bundled) | — (editor host serves it) | `3015` | auto (`/editor/local-test-target`) |
-
-For any other brand, derive the package name and port by reading
-`apps/<app>/package.json` (`name` field and the `--port` in the `dev` script).
-`brandSlug=test` needs no target server — the editor host serves the fixture
-on its own origin.
-
-### 3. Start or reuse BOTH servers (edit starts everything)
-`rdc:edit` must bring up everything the preview needs — the editor host AND the
-target brand's dev server. Start-or-reuse each: probe the port first, only
-launch if it is dead.
-
-**3a. Editor host (`http://localhost:3015`)**
-- Probe: `curl -s -o /dev/null -w "%{http_code}" http://localhost:3015/` — any
-  non-`000` means it is already up; reuse it.
-- Launch only if down (background, do not block the session):
-  ```powershell
-  pnpm --filter @regen/editor-host dev
-  ```
-
-**3b. Target brand dev server (skip for `brandSlug=test`)**
-- Probe the resolved dev port (e.g. `http://localhost:3006/`). Non-`000` =
-  already running; reuse it. `EADDRINUSE` on launch also means reuse — not an error.
-- Launch only if down (background), then health-wait on the port before opening:
-  ```powershell
-  pnpm --filter <package> dev
-  ```
-  Bounded health-wait only (no `for`/`seq`/`sleep` polling loops):
-  ```bash
-  until curl -s -o /dev/null http://localhost:<port>/; do sleep 2; done
-  ```
-- Open the editor page for the resolved target once BOTH report a live code:
-  ```txt
-  http://localhost:3015/editor/local/<brandSlug>?appSlug=<appSlug>&targetUrl=<targetUrl>
-  ```
-
-### 4. Open the page
-- Normal use: open the URL in the browser and confirm the editor loaded.
-  Open via PowerShell `Start-Process`, NOT `cmd start` — `cmd` treats the `&`
-  between query params as a command separator and truncates the URL:
-  ```powershell
-  Start-Process 'http://localhost:3015/editor/local/<brandSlug>?appSlug=<appSlug>&targetUrl=<targetUrl>'
-  ```
-- `RDC_TEST=1`: do not force a foreground browser action; report the exact editor URL and whether the target was resolved.
-
-### 5. Report the result
-- Return a concise line with:
-  - the resolved target
-  - the editor URL
-  - whether the page was opened or only prepared in test mode
-
-## Guardrails
-- Do not turn this into a full design audit.
-- Do not start Studio unless the target actually belongs there.
-- Do not do broad discovery when one target mapping is enough.
+---
+name: rdc:edit
+description: "Usage `rdc:edit <site|brand|route|file>` — open the local website editor host for a target site, brand, route, or file. Resolves the target, launches or reuses the local editor host on port 3015, and opens the target in the browser when not under `RDC_TEST=1`."
+---
+
+> **⚠️ OUTPUT CONTRACT (READ FIRST):** `guides/output-contract.md`
+> Checklist-only output. No tool-call narration. No raw MCP/JSON/log dumps.
+> One checklist upfront, updated in place, shown again at end with a 1-line verdict.
+
+> If dispatching subagents or running as a subagent: read `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md` first (fallback: `{PROJECT_ROOT}/.rdc/guides/agent-bootstrap.md`).
+
+> **Sandbox contract:** This skill honors `RDC_TEST=1`. Under test, do not steal focus or rely on foreground-only browser automation; report the resolved editor URL instead.
+
+
+# rdc:edit — Local Website Editor Launcher
+
+## When to Use
+- The user wants to open a site, brand, route, or file in the local editor app
+- The user says "open this in the editor" or asks for the editor-host workflow
+- The target should be loaded in `@regen/editor-host` rather than Studio
+
+## Arguments
+- `rdc:edit <site|brand|route|file>` — resolve the target and open it in the local editor host
+
+## Procedure
+
+### 1. Read the local editor contract
+- Read `apps/editor/CLAUDE.md` before launching anything.
+- If the target is Studio-specific, prefer `rdc:design edit <target>` instead.
+
+### 2. Resolve the target
+- For known LIFEAI brand targets, map to the obvious brand/app pair first.
+- `prtrust.fund` and `dev.prtrust.fund` resolve to `brandSlug=prt` and `appSlug=prt`.
+- `test`, `studio_test`, and `studio-test` resolve to `brandSlug=test` and `appSlug=studio_test`.
+- If the target is a local file or route and the brand/app is unclear, ask one concise question.
+
+Resolve the **target dev server** (package + port) so the preview iframe has
+something live to load. Read the brand app's `package.json` `name` and its
+`dev` script port — never hard-code a stale port:
+
+| Target | App dir | Package (`name`) | Dev port | `targetUrl` |
+|--------|---------|------------------|----------|-------------|
+| `prt` / `prtrust.fund` | `apps/prt` | `@regen/prt-portal` | `3006` | `http://localhost:3006` |
+| `test` / `studio_test` | (bundled) | — (editor host serves it) | `3015` | auto (`/editor/local-test-target`) |
+
+For any other brand, derive the package name and port by reading
+`apps/<app>/package.json` (`name` field and the `--port` in the `dev` script).
+`brandSlug=test` needs no target server — the editor host serves the fixture
+on its own origin.
+
+### 3. Start or reuse BOTH servers (edit starts everything)
+`rdc:edit` must bring up everything the preview needs — the editor host AND the
+target brand's dev server. Start-or-reuse each: probe the port first, only
+launch if it is dead.
+
+**3a. Editor host (`http://localhost:3015`)**
+- Probe: `curl -s -o /dev/null -w "%{http_code}" http://localhost:3015/` — any
+  non-`000` means it is already up; reuse it.
+- Launch only if down (background, do not block the session):
+  ```powershell
+  pnpm --filter @regen/editor-host dev
+  ```
+
+**3b. Target brand dev server (skip for `brandSlug=test`)**
+- Probe the resolved dev port (e.g. `http://localhost:3006/`). Non-`000` =
+  already running; reuse it. `EADDRINUSE` on launch also means reuse — not an error.
+- Launch only if down (background), then health-wait on the port before opening:
+  ```powershell
+  pnpm --filter <package> dev
+  ```
+  Bounded health-wait only (no `for`/`seq`/`sleep` polling loops):
+  ```bash
+  until curl -s -o /dev/null http://localhost:<port>/; do sleep 2; done
+  ```
+- Open the editor page for the resolved target once BOTH report a live code:
+  ```txt
+  http://localhost:3015/editor/local/<brandSlug>?appSlug=<appSlug>&targetUrl=<targetUrl>
+  ```
+
+### 4. Open the page
+- Normal use: open the URL in the browser and confirm the editor loaded.
+  Open via PowerShell `Start-Process`, NOT `cmd start` — `cmd` treats the `&`
+  between query params as a command separator and truncates the URL:
+  ```powershell
+  Start-Process 'http://localhost:3015/editor/local/<brandSlug>?appSlug=<appSlug>&targetUrl=<targetUrl>'
+  ```
+- `RDC_TEST=1`: do not force a foreground browser action; report the exact editor URL and whether the target was resolved.
+
+### 5. Report the result
+- Return a concise line with:
+  - the resolved target
+  - the editor URL
+  - whether the page was opened or only prepared in test mode
+
+## Guardrails
+- Do not turn this into a full design audit.
+- Do not start Studio unless the target actually belongs there.
+- Do not do broad discovery when one target mapping is enough.