Theme WorkBuddy safely

Create runtime-only themes for WorkBuddy. Never modify /Applications/WorkBuddy.app, app.asar, its integrity metadata, its code signature, authentication data, or user conversations.

Read the operating contract

Read references/workbuddy-contract.md before inspecting the application, creating CSS, applying a theme, or validating a new WorkBuddy version. It contains the verified app structure, design contract, selectors, safety boundary, and QA matrix.

Choose the workflow

• For a new visual reference, inspect it, write a design contract, then start from assets/ai-pm-course/ or create a sibling theme folder.
• For compatibility work, run node scripts/workbuddy-theme.mjs inspect, then node scripts/workbuddy-theme.mjs probe on an authorized themed session, and compare the reported version, renderer URL, stable roots, tokens, geometry, and overflow with the reference contract.
• For validation, run node scripts/validate-theme.mjs /absolute/theme-directory.
• For preview, open the theme's preview.html; label it as a design preview, never a verified WorkBuddy screenshot.
• For a Theme Manager ZIP or community contribution, follow references/community-publishing.md after validation.
• For applying or restoring, follow the explicit-permission gate below.

Write the design contract before CSS