climaybe 3.4.7 → 3.4.8

package/src/commands/init.js

@@ -5,21 +5,26 @@ import {
   promptStoreLoop,
   promptPreviewWorkflows,
   promptBuildWorkflows,
+  promptLighthouseWorkflows,
   promptDevKit,
   promptVSCodeDevTasks,
   promptProjectName,
   promptCommitlint,
+  promptBranchProtection,
   promptCursorSkills,
+  promptAiEditors,
   promptConfigureCISecrets,
+  promptNoRemoteAction,
+  promptOwnerRepo,
   promptUpdateExistingSecrets,
   promptSecretValue,
 } from '../lib/prompts.js';
 import { readConfig, writeConfig, getProjectType, readPkg } from '../lib/config.js';
-import { ensureGitRepo, ensureInitialCommit, ensureStagingBranch, createStoreBranches, getSuggestedTagForRelease } from '../lib/git.js';
+import { ensureGitRepo, ensureInitialCommit, ensureStagingBranch, createStoreBranches, getSuggestedTagForRelease, addOriginRemote } from '../lib/git.js';
 import { scaffoldWorkflows } from '../lib/workflows.js';
 import { createStoreDirectories } from '../lib/store-sync.js';
 import { scaffoldCommitlint } from '../lib/commit-tooling.js';
-import { scaffoldCursorBundle } from '../lib/cursor-bundle.js';
+import { scaffoldAiConfig, logAiConfigResult } from '../lib/cursor-bundle.js';
 import { getMissingBuildWorkflowRequirements, ensureBuildWorkflowDefaults } from '../lib/build-workflows.js';
 import { getDevKitExistingFiles, scaffoldThemeDevKit } from '../lib/theme-dev-kit.js';
 import {
@@ -36,6 +41,7 @@ import {
   setSecret,
   setGitLabVariable,
 } from '../lib/github-secrets.js';
+import { logBranchProtectionResult, syncBranchProtection } from '../lib/branch-protection.js';
 
 function installThemeDependencies(cwd = process.cwd()) {
   try {
@@ -48,23 +54,72 @@ function installThemeDependencies(cwd = process.cwd()) {
   }
 }
 
+const DOCS_BASE = 'https://github.com/electricmaybe/climaybe#';
+
+/**
+ * Print a short description (and optional docs link) as a preamble to the next prompt.
+ * A leading blank line detaches it from the previous answer, and there is no leading
+ * glyph, so the text reads as an intro to the question that follows — not a trailing
+ * note on the question above it.
+ * @param {string} text - one sentence, what the answer is for / what it should look like
+ * @param {string} [anchor] - README heading anchor (e.g. 'theme-dev-kit')
+ */
+function hint(text, anchor) {
+  console.log('');
+  console.log(pc.dim(text));
+  if (anchor) console.log(pc.cyan(`  ${DOCS_BASE}${anchor}`));
+}
+
 /**
  * Run the full init flow: prompts, config write, git, branches, workflows.
  * Used by both init (when not already inited or user confirms reinit) and reinit.
  */
 async function runInitFlow() {
   const hasPackageJson = !!readPkg();
-  const projectName = !hasPackageJson ? await promptProjectName() : undefined;
+  let projectName;
+  if (!hasPackageJson) {
+    hint("Used only when this repo has no package.json yet — the repo/folder name is usually fine.");
+    projectName = await promptProjectName();
+  }
 
   // 1. Collect stores from user
+  hint('Enter a Shopify subdomain (e.g. voldt-staging) or full domain; add 2+ stores for multi-store mode.');
   const stores = await promptStoreLoop();
   const mode = stores.length > 1 ? 'multi' : 'single';
+
+  hint('CI that publishes a preview theme per PR and cleans it up on close.', 'preview-and-cleanup-workflows');
   const enablePreviewWorkflows = await promptPreviewWorkflows();
+
+  hint('CI that bundles _scripts JS and compiles Tailwind on push. Yes if the theme uses _scripts/_styles.', 'build-and-lighthouse-workflows');
   const enableBuildWorkflows = await promptBuildWorkflows();
+
+  let enableLighthouseWorkflows = false;
+  if (enableBuildWorkflows) {
+    hint('Runs Lighthouse performance + a11y budgets on the staging branch (inside the build pipeline).', 'build-and-lighthouse-workflows');
+    enableLighthouseWorkflows = await promptLighthouseWorkflows();
+  }
+
+  hint('Local config + ignore defaults for theme work (Theme Check, Prettier, Lighthouse, gitignore).', 'theme-dev-kit');
   const enableDevKit = await promptDevKit();
-  const enableVSCodeTasks = enableDevKit ? await promptVSCodeDevTasks() : false;
+  let enableVSCodeTasks = false;
+  if (enableDevKit) {
+    hint('Adds a VS Code task that runs `climaybe serve`. Only useful if you use VS Code.');
+    enableVSCodeTasks = await promptVSCodeDevTasks();
+  }
+
+  hint('Checks commit messages locally so they follow conventional commits (feat:, fix:, …).');
   const enableCommitlint = await promptCommitlint();
+
+  hint('Requires PRs on production branches (main, or each live-<alias>). Skips cleanly without GitHub/gh.', 'branch-protection');
+  const enableBranchProtection = await promptBranchProtection();
+
+  hint('Electric Maybe rules/skills/subagents installed to a single .config/ai/ source of truth.', 'ai-ruleset');
   const enableCursorSkills = await promptCursorSkills();
+  let aiEditors = [];
+  if (enableCursorSkills) {
+    hint('Pick the editors to bridge to .config/ai/ — only the ones you select get a bridge file.', 'ai-ruleset');
+    aiEditors = await promptAiEditors();
+  }
 
   console.log(pc.dim(`\n  Mode: ${mode}-store (${stores.length} store(s))`));
 
@@ -102,11 +157,13 @@ async function runInitFlow() {
     default_store: stores[0].domain,
     preview_workflows: enablePreviewWorkflows,
     build_workflows: enableBuildWorkflows,
+    lighthouse_workflows: enableBuildWorkflows ? enableLighthouseWorkflows : undefined,
     build_entrypoints_ready: enableBuildWorkflows ? missingBuildFiles?.length === 0 : undefined,
     dev_kit: enableDevKit,
     vscode_tasks: enableVSCodeTasks,
     commitlint: enableCommitlint,
     cursor_skills: enableCursorSkills,
+    ai_editors: enableCursorSkills ? aiEditors : undefined,
     stores: {},
   };
 
@@ -134,13 +191,31 @@ async function runInitFlow() {
     }
   }
 
+  if (enableBranchProtection) {
+    const protection = syncBranchProtection({
+      mode,
+      aliases: stores.map((s) => s.alias),
+      cwd: process.cwd(),
+    });
+    logBranchProtectionResult(protection, mode);
+    if (protection.applied.length > 0 || protection.removed.length > 0) {
+      console.log(
+        pc.dim(
+          '  Rule: PR required on protected branches; live-* bypass allowed for shopify[bot], github-actions[bot], actions-user.'
+        )
+      );
+    }
+  } else {
+    console.log(pc.dim('  Branch protection: skipped (declined at prompt).'));
+  }
+
   // 6. Scaffold workflows
   scaffoldWorkflows(mode, {
     includePreview: enablePreviewWorkflows,
     includeBuild: enableBuildWorkflows,
   });
 
-  // 7. Optional commitlint + Husky and Cursor bundle (rules, skills, agents)
+  // 7. Optional commitlint + Husky and the AI ruleset (rules, skills, agents + editor bridges)
   if (enableCommitlint) {
     console.log(pc.dim('  Setting up commitlint + Husky...'));
     if (scaffoldCommitlint()) {
@@ -150,14 +225,8 @@ async function runInitFlow() {
     }
   }
   if (enableCursorSkills) {
-    const cursorOk = scaffoldCursorBundle();
-    if (cursorOk) {
-      console.log(
-        pc.green('  Electric Maybe Cursor bundle → .cursor/rules, .cursor/skills, .cursor/agents'),
-      );
-    } else {
-      console.log(pc.yellow('  Cursor bundle not found in package (skipped).'));
-    }
+    const aiResult = scaffoldAiConfig(process.cwd(), { editors: aiEditors });
+    logAiConfigResult(aiResult, { pc });
   }
 
   if (enableDevKit) {
@@ -190,12 +259,19 @@ async function runInitFlow() {
   }
   console.log(pc.dim(`  Preview workflows: ${enablePreviewWorkflows ? 'enabled' : 'disabled'}`));
   console.log(pc.dim(`  Build workflows: ${enableBuildWorkflows ? 'enabled' : 'disabled'}`));
+  if (enableBuildWorkflows) {
+    console.log(pc.dim(`  Lighthouse CI: ${enableLighthouseWorkflows ? 'enabled' : 'disabled'}`));
+  }
   console.log(pc.dim(`  Theme dev kit: ${enableDevKit ? 'enabled' : 'disabled'}`));
   if (enableDevKit) {
     console.log(pc.dim(`  VS Code tasks: ${enableVSCodeTasks ? 'enabled' : 'disabled'}`));
   }
   console.log(pc.dim(`  commitlint + Husky: ${enableCommitlint ? 'enabled' : 'disabled'}`));
-  console.log(pc.dim(`  Cursor bundle: ${enableCursorSkills ? 'installed' : 'skipped'}`));
+  console.log(
+    pc.dim(
+      `  AI ruleset: ${enableCursorSkills ? `installed (${aiEditors.join(', ') || 'cursor'})` : 'skipped'}`
+    )
+  );
 
   const suggestedTag = getSuggestedTagForRelease();
   const tagLabel = suggestedTag === 'v1.0.0' ? 'Tag your first release' : 'Tag your next release';
@@ -239,9 +315,30 @@ async function runInitFlow() {
     return;
   }
   if (!setter.checkRemote()) {
-    console.log(pc.yellow('  This repo has no ' + setter.name + ' remote (origin).'));
-    console.log(pc.dim('  Add a remote and push first, then add secrets/variables in the repo Settings.\n'));
-    return;
+    console.log(pc.yellow(`  This folder has no ${setter.name} "origin" remote yet.`));
+    const action = await promptNoRemoteAction(setter.name);
+    if (action !== 'add') {
+      console.log(pc.dim('  Skipping CI secrets. Add a remote later, then re-run "climaybe init" or set them in the repo Settings.\n'));
+      return;
+    }
+    const slug = await promptOwnerRepo(setter.name);
+    if (!slug) {
+      console.log(pc.dim('  No repository entered; skipping CI secrets for now.\n'));
+      return;
+    }
+    try {
+      const url = addOriginRemote(slug, ciHost, process.cwd());
+      console.log(pc.green(`  Added origin → ${url}`));
+      console.log(pc.dim('  Create the repo on ' + setter.name + ' and "git push -u origin --all" when ready.'));
+    } catch (err) {
+      console.log(pc.red(`  Could not add origin remote: ${err.message}`));
+      console.log(pc.dim('  Add it manually with "git remote add origin <url>", then re-run "climaybe init".\n'));
+      return;
+    }
+    if (!setter.checkRemote()) {
+      console.log(pc.dim('  Remote added, but it is not recognized as a ' + setter.name + ' URL; skipping CI secrets.\n'));
+      return;
+    }
   }
 
   const existingNames =

package/src/commands/update-workflows.js

@@ -4,6 +4,7 @@ import {
   isBuildWorkflowsEnabled,
   isCommitlintEnabled,
   isCursorSkillsEnabled,
+  getAiEditors,
   isPreviewWorkflowsEnabled,
   readConfig,
 } from '../lib/config.js';
@@ -11,7 +12,7 @@ import { scaffoldWorkflows } from '../lib/workflows.js';
 import { requireThemeProject } from '../lib/theme-guard.js';
 import { scaffoldThemeDevKit } from '../lib/theme-dev-kit.js';
 import { scaffoldCommitlint } from '../lib/commit-tooling.js';
-import { scaffoldCursorBundle } from '../lib/cursor-bundle.js';
+import { scaffoldAiConfig } from '../lib/cursor-bundle.js';
 
 export async function updateCommand() {
   console.log(pc.bold('\n  climaybe — Update\n'));
@@ -38,7 +39,7 @@ export async function updateCommand() {
     scaffoldCommitlint(process.cwd(), { skipInstall: true });
   }
   if (isCursorSkillsEnabled()) {
-    scaffoldCursorBundle();
+    scaffoldAiConfig(process.cwd(), { editors: getAiEditors() });
   }
 
   scaffoldWorkflows(mode, { includePreview, includeBuild });

package/src/cursor/rules/00-rule-index.mdc

@@ -6,7 +6,7 @@ alwaysApply: true
 ---
 # Rule Index
 
-When you perform any of the following, **read and apply** the corresponding rule file from `.cursor/rules/`:
+When you perform any of the following, **read and apply** the corresponding rule file from `.config/ai/rules/`:
 
 - **Editing `assets/*.js` or `assets/style.css`, build outputs vs source, where to edit JS/CSS** → `project-overview.mdc` (Build Outputs vs Source — edit `_scripts/`/`_styles/`, never the generated `assets/` files)
 - **Git commits, commit messages** → `commit-rules.mdc`

package/src/cursor/rules/cursor-rule-template.mdc

@@ -7,9 +7,9 @@ alwaysApply: false
 
 How to add new cursor rules to the project
 
-1. Always place rule files in PROJECT_ROOT/.cursor/rules/:
+1. Always place rule files in PROJECT_ROOT/.config/ai/rules/:
     ```
-    .cursor/rules/
+    .config/ai/rules/
     ├── your-rule-name.mdc
     ├── another-rule.mdc
     └── ...
@@ -23,16 +23,17 @@ How to add new cursor rules to the project
 3. Directory structure:
     ```
     PROJECT_ROOT/
-    ├── .cursor/
-    │   └── rules/
-    │       ├── your-rule-name.mdc
-    │       └── ...
+    ├── .config/
+    │   └── ai/
+    │       └── rules/
+    │           ├── your-rule-name.mdc
+    │           └── ...
     └── ...
     ```
 
 4. Never place rule files:
     - In the project root
-    - In subdirectories outside .cursor/rules
+    - In subdirectories outside .config/ai/rules
     - In any other location
 
 5. Cursor rules have the following structure:

package/src/cursor/rules/figma-design-system.mdc

@@ -56,13 +56,13 @@ This document defines how to translate Figma designs into code for this project.
 
 - No React/Vue. UI is Liquid (sections + snippets) plus native JS web components.
 - New UI from Figma: prefer adding or composing existing snippets/sections; add new snippets/sections only when no fit exists.
-- Sections must have a valid `{% schema %}` and semantic HTML; snippets must have LiquidDoc `{%- doc -%}` and follow `.cursor/rules/snippets.mdc` and `.cursor/rules/liquid.mdc`.
+- Sections must have a valid `{% schema %}` and semantic HTML; snippets must have LiquidDoc `{%- doc -%}` and follow `.config/ai/rules/snippets.mdc` and `.config/ai/rules/liquid.mdc`.
 
 ### 1.3 Frameworks & Libraries
 
 - **Templating:** Liquid only (Shopify theme).
 - **Styling:** Tailwind CSS v4. Entry: `_styles/main.css` (imports Tailwind, tokens, component CSS). Compiled output: `assets/style.css`.
-- **Script:** Native JS only (no React/Vue). Web components with `#` private fields, AbortController for listeners, JSDoc; see `.cursor/rules/javascript-standards.mdc`.
+- **Script:** Native JS only (no React/Vue). Web components with `#` private fields, AbortController for listeners, JSDoc; see `.config/ai/rules/javascript-standards.mdc`.
 - **Build:** Tailwind processes `_styles/main.css`; content sources (for class scanning) are listed in `_styles/main.css` (`@source` for layout, blocks, sections, snippets, templates, assets).
 
 ### 1.4 Asset Management
@@ -127,8 +127,8 @@ config/                  # Theme settings
 - **Reuse existing snippets/sections** from `snippets/` and `sections/` instead of duplicating (e.g. buttons → `a--button`, icons → `a--icon`, cards → `m--*` cards, modals → `m--modal` / electric-modal).
 - Use the project’s **color system** (semantic tokens from `02.02_colors.css`), **typography** (`02.03_typography.css`, utilities), and **spacing/sizes** (`02.01_sizes.css`, Tailwind utilities that use them).
 - **Tailwind:** Only static class names; map Figma colors to semantic tokens (e.g. `bg-surface`, `text-primary`); use project breakpoints and spacing scale.
-- Respect **accessibility** (WCAG 2.1 AA): semantic HTML, ARIA where needed, keyboard and screen reader support; see `.cursor/rules/accessibility-rules.mdc`.
-- Respect **JS standards**: no new dependencies; if adding behavior, use native JS/web components per `.cursor/rules/javascript-standards.mdc`.
+- Respect **accessibility** (WCAG 2.1 AA): semantic HTML, ARIA where needed, keyboard and screen reader support; see `.config/ai/rules/accessibility-rules.mdc`.
+- Respect **JS standards**: no new dependencies; if adding behavior, use native JS/web components per `.config/ai/rules/javascript-standards.mdc`.
 - Aim for **1:1 visual parity** with the Figma design and validate with the screenshot.
 
 ### 2.3 Asset Handling
@@ -144,16 +144,16 @@ config/                  # Theme settings
 
 ### 3.1 Liquid
 
-- Follow `.cursor/rules/liquid.mdc`: e.g. assign computed values before passing to `render`; no inline `append` in `render` parameters; valid tags/filters only.
-- Use `{%- doc -%}` and LiquidDoc for all new snippets; document params and examples per `.cursor/rules/liquid-doc-rules.mdc` and `.cursor/rules/snippets.mdc`.
+- Follow `.config/ai/rules/liquid.mdc`: e.g. assign computed values before passing to `render`; no inline `append` in `render` parameters; valid tags/filters only.
+- Use `{%- doc -%}` and LiquidDoc for all new snippets; document params and examples per `.config/ai/rules/liquid-doc-rules.mdc` and `.config/ai/rules/snippets.mdc`.
 
 ### 3.2 Sections
 
-- Every section: valid `{% schema %}`, semantic HTML, section-scoped classes. Follow `.cursor/rules/sections.mdc` and `.cursor/rules/schemas.mdc` for schema definitions.
+- Every section: valid `{% schema %}`, semantic HTML, section-scoped classes. Follow `.config/ai/rules/sections.mdc` and `.config/ai/rules/schemas.mdc` for schema definitions.
 
 ### 3.3 Accessibility
 
-- Semantic structure, ARIA where needed, keyboard and focus behavior, WCAG 2.1 AA. See `.cursor/rules/accessibility-rules.mdc`. Use the accessibility-pass skill when asked for an a11y audit.
+- Semantic structure, ARIA where needed, keyboard and focus behavior, WCAG 2.1 AA. See `.config/ai/rules/accessibility-rules.mdc`. Use the accessibility-pass skill when asked for an a11y audit.
 
 ### 3.4 Performance
 

package/src/cursor/rules/global-rules-reference.mdc

@@ -6,7 +6,7 @@ alwaysApply: false
 ---
 # Global Rules Reference
 
-This project uses global rules from ~/.claude/rules/ (when using Claude). **In Cursor, project rules live in `.cursor/rules/` and are applied per the rule index (`00-rule-index.mdc`).**
+This project uses global rules from ~/.claude/rules/ (when using Claude). **In Cursor, project rules live in `.config/ai/rules/` and are applied per the rule index (`00-rule-index.mdc`).**
 
 ## Global Rules Location
 All reusable rules are stored in:

package/src/cursor/rules/snippets.mdc

@@ -131,4 +131,4 @@ Include testing scenarios in comments:
 {% endcomment %}
 ```
 
-[snippet-example.liquid](mdc:.cursor/rules/examples/snippet-example.liquid)
+[snippet-example.liquid](mdc:.config/ai/rules/examples/snippet-example.liquid)

package/src/cursor/skills/accessibility-pass/SKILL.md

@@ -11,8 +11,8 @@ Runs a structured a11y audit on specified file(s) and reports findings with fix
 
 Before auditing, read and apply:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/accessibility-rules.mdc` — WCAG 2.1 AA, semantic HTML, ARIA, keyboard, focus, screen readers
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/accessibility-rules.mdc` — WCAG 2.1 AA, semantic HTML, ARIA, keyboard, focus, screen readers
 
 ## Workflow
 

package/src/cursor/skills/changelog-release/SKILL.md

@@ -11,8 +11,8 @@ Builds a changelog or release notes from commits since a ref (e.g. last tag), gr
 
 When grouping and labeling commits, read and apply:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/commit-rules.mdc` — commit types (fix, feat, refactor, style, etc.) and format
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/commit-rules.mdc` — commit types (fix, feat, refactor, style, etc.) and format
 
 Use the same type labels for changelog sections so the output matches how the team writes commits.
 

package/src/cursor/skills/commit-in-groups/SKILL.md

@@ -13,8 +13,8 @@ Analyzes uncommitted changes, groups them into logical commits, and suggests one
 
 Before suggesting any commit messages, read and apply:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/commit-rules.mdc` — commit format (type + description), types (fix, feat, refactor, style, etc.), imperative mood, optional scope
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/commit-rules.mdc` — commit format (type + description), types (fix, feat, refactor, style, etc.), imperative mood, optional scope
 
 Use the exact format and types from commit-rules; no period at end; lowercase description.
 

package/src/cursor/skills/linear-create-task/SKILL.md

@@ -9,7 +9,7 @@ Creates a Linear issue in the **Voldt Redesign** project with a PRD-style descri
 
 ## Rules to Apply
 
-Before creating a task, read `.cursor/rules/00-rule-index.mdc`. No other rule file is required; mention commit-rules only if the user wants a branch name convention.
+Before creating a task, read `.config/ai/rules/00-rule-index.mdc`. No other rule file is required; mention commit-rules only if the user wants a branch name convention.
 
 ## Linear Context
 

package/src/cursor/skills/liquid-doc-comments/SKILL.md

@@ -11,8 +11,8 @@ Adds or updates the `{%- doc -%}` block at the top of a snippet or block so it m
 
 Before writing or editing doc blocks, read and apply:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/liquid-doc-rules.mdc` — required structure, @param format, @example, types, placement
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/liquid-doc-rules.mdc` — required structure, @param format, @example, types, placement
 
 ## Workflow
 

package/src/cursor/skills/locale-translation-prep/SKILL.md

@@ -11,9 +11,9 @@ Compares the default locale with others and reports which keys are new or change
 
 For context on how the project uses locales (e.g. in sections/snippets), the rule index is useful:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index (schemas.mdc prefers translation keys over schema text; locales live in `locales/`)
+1. `.config/ai/rules/00-rule-index.mdc` — rule index (schemas.mdc prefers translation keys over schema text; locales live in `locales/`)
 
-No single "locale rules" file is required; this skill focuses on file comparison and reporting. To **generate** translations across locales after English changes, use the **theme-translator** subagent (`/theme-translator`), installed with the Cursor bundle under `.cursor/agents/`.
+No single "locale rules" file is required; this skill focuses on file comparison and reporting. To **generate** translations across locales after English changes, use the **theme-translator** subagent (`/theme-translator`), installed with the Cursor bundle under `.config/ai/agents/`.
 
 ## Workflow
 

package/src/cursor/skills/schema-section-change/SKILL.md

@@ -11,9 +11,9 @@ Safely adds or changes a section setting: updates both the section Liquid and th
 
 Before making changes, read and apply:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/schemas.mdc` — minimal settings, no redundancy, translation keys, max 5 settings, "question every setting"
-3. `.cursor/rules/sections.mdc` — section structure and schema requirement
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/schemas.mdc` — minimal settings, no redundancy, translation keys, max 5 settings, "question every setting"
+3. `.config/ai/rules/sections.mdc` — section structure and schema requirement
 
 ## Workflow
 

package/src/cursor/skills/section-from-spec/SKILL.md

@@ -11,12 +11,12 @@ Creates a new section (and optional snippet) from a user spec, following project
 
 Before creating any section or snippet, read and apply (in order):
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/sections.mdc` — section structure, schema requirement, performance
-3. `.cursor/rules/snippets.mdc` — snippet patterns, LiquidDoc, parameter handling
-4. `.cursor/rules/schemas.mdc` — minimal settings, no redundancy, translation keys, max 5 settings
-5. `.cursor/rules/liquid.mdc` — Liquid syntax
-6. `.cursor/rules/liquid-doc-rules.mdc` — required `{% doc %}` block format for snippets
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/sections.mdc` — section structure, schema requirement, performance
+3. `.config/ai/rules/snippets.mdc` — snippet patterns, LiquidDoc, parameter handling
+4. `.config/ai/rules/schemas.mdc` — minimal settings, no redundancy, translation keys, max 5 settings
+5. `.config/ai/rules/liquid.mdc` — Liquid syntax
+6. `.config/ai/rules/liquid-doc-rules.mdc` — required `{% doc %}` block format for snippets
 
 ## Workflow
 

package/src/cursor/skills/theme-check-fix/SKILL.md

@@ -11,10 +11,10 @@ Runs theme linting (e.g. Shopify Theme Check) and maps each finding to project r
 
 When interpreting results and suggesting fixes, read and apply:
 
-1. `.cursor/rules/00-rule-index.mdc` — rule index
-2. `.cursor/rules/liquid.mdc` — Liquid syntax and usage
-3. `.cursor/rules/sections.mdc` — section structure and schema
-4. `.cursor/rules/snippets.mdc` — snippet patterns
+1. `.config/ai/rules/00-rule-index.mdc` — rule index
+2. `.config/ai/rules/liquid.mdc` — Liquid syntax and usage
+3. `.config/ai/rules/sections.mdc` — section structure and schema
+4. `.config/ai/rules/snippets.mdc` — snippet patterns
 
 ## Workflow
 

package/src/index.js

@@ -120,7 +120,7 @@ export function createProgram(version = '0.0.0', packageDir = '') {
   program
     .name('climaybe')
     .description(
-      'Shopify CLI — theme CI/CD (workflows, branches, stores) and app repo helpers (commitlint, Cursor bundle)'
+      'Shopify CLI — theme CI/CD (workflows, branches, stores) and app repo helpers (commitlint, AI ruleset)'
     )
     .version(versionDisplay);
 
@@ -134,7 +134,7 @@ export function createProgram(version = '0.0.0', packageDir = '') {
   const app = program.command('app').description('Shopify app repo helpers (no theme workflows)');
   app
     .command('init')
-    .description('Set up commitlint, Cursor bundle (rules/skills/agents), and project_type: app in climaybe.config.json')
+    .description('Set up commitlint, AI ruleset (rules/skills/agents), and project_type: app in climaybe.config.json')
     .action(appInitCommand);
 
   program
@@ -146,7 +146,7 @@ export function createProgram(version = '0.0.0', packageDir = '') {
     .command('add-cursor')
     .alias('add-cursor-skill')
     .description(
-      'Install Electric Maybe Cursor bundle (.cursor/rules, .cursor/skills, .cursor/agents)',
+      'Install Electric Maybe AI ruleset into .config/ai/ and bridge it to your editors',
     )
     .action(addCursorSkillCommand);